Skip to content

Commit 19329dd

Browse files
committed
Rewriting as Laminas Project package
1 parent c45a738 commit 19329dd

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

43 files changed

+351
-3479
lines changed

.gitattributes

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,6 @@
22
/.gitattributes export-ignore
33
/.gitignore export-ignore
44
/.travis.yml export-ignore
5-
/composer.lock export-ignore
65
/docs/ export-ignore
76
/phpcs.xml export-ignore
87
/phpunit.xml.dist export-ignore

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
/clover.xml
2+
/composer.lock
23
/coveralls-upload.json
34
/phpunit.xml
45
/vendor/

.travis.yml

Lines changed: 2 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,3 @@
1-
sudo: false
2-
31
language: php
42

53
cache:
@@ -12,24 +10,17 @@ env:
1210
- COVERAGE_DEPS="php-coveralls/php-coveralls"
1311

1412
matrix:
13+
fast_finish: true
1514
include:
1615
- php: 5.6
1716
env:
1817
- DEPS=lowest
19-
- php: 5.6
20-
env:
21-
- DEPS=locked
22-
- LEGACY_DEPS="phpunit/phpunit"
2318
- php: 5.6
2419
env:
2520
- DEPS=latest
2621
- php: 7
2722
env:
2823
- DEPS=lowest
29-
- php: 7
30-
env:
31-
- DEPS=locked
32-
- LEGACY_DEPS="phpunit/phpunit"
3324
- php: 7
3425
env:
3526
- DEPS=latest
@@ -38,18 +29,12 @@ matrix:
3829
- DEPS=lowest
3930
- php: 7.1
4031
env:
41-
- DEPS=locked
32+
- DEPS=latest
4233
- CS_CHECK=true
4334
- TEST_COVERAGE=true
44-
- php: 7.1
45-
env:
46-
- DEPS=latest
4735
- php: 7.2
4836
env:
4937
- DEPS=lowest
50-
- php: 7.2
51-
env:
52-
- DEPS=locked
5338
- php: 7.2
5439
env:
5540
- DEPS=latest

CHANGELOG.md

Lines changed: 26 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -50,13 +50,13 @@ All notable changes to this project will be documented in this file, in reverse
5050

5151
### Added
5252

53-
- [#69](https://github.com/zfcampus/zf-apigility-documentation/pull/69) adds support for PHP 7.1 and 7.2.
53+
- [zfcampus/zf-apigility-documentation#69](https://github.com/zfcampus/zf-apigility-documentation/pull/69) adds support for PHP 7.1 and 7.2.
5454

55-
- [#59](https://github.com/zfcampus/zf-apigility-documentation/pull/59) adds the ability to specify examples for fields.
55+
- [zfcampus/zf-apigility-documentation#59](https://github.com/zfcampus/zf-apigility-documentation/pull/59) adds the ability to specify examples for fields.
5656

5757
### Changed
5858

59-
- [#62](https://github.com/zfcampus/zf-apigility-documentation/pull/62) updates the `ZF\Apigility\Documentation\Controller` to accept a `BasePath`
59+
- [zfcampus/zf-apigility-documentation#62](https://github.com/zfcampus/zf-apigility-documentation/pull/62) updates the `Laminas\ApiTools\Documentation\Controller` to accept a `BasePath`
6060
view helper as a construction aregument; this is then used to prefix any generated links with
6161
the currently detected/configured base path to the application.
6262

@@ -66,14 +66,14 @@ All notable changes to this project will be documented in this file, in reverse
6666

6767
### Removed
6868

69-
- [#69](https://github.com/zfcampus/zf-apigility-documentation/pull/69) removes support for HHVM.
69+
- [zfcampus/zf-apigility-documentation#69](https://github.com/zfcampus/zf-apigility-documentation/pull/69) removes support for HHVM.
7070

7171
### Fixed
7272

73-
- [#59](https://github.com/zfcampus/zf-apigility-documentation/pull/59) provides a fix to configuration detection that removes an emitted
74-
notice when no zf-rpc and/or no zf-rest configuration is present.
73+
- [zfcampus/zf-apigility-documentation#59](https://github.com/zfcampus/zf-apigility-documentation/pull/59) provides a fix to configuration detection that removes an emitted
74+
notice when no api-tools-rpc and/or no api-tools-rest configuration is present.
7575

76-
- [#59](https://github.com/zfcampus/zf-apigility-documentation/pull/59) fixes the "api" route parameter constraint to accept `%` characters, which
76+
- [zfcampus/zf-apigility-documentation#59](https://github.com/zfcampus/zf-apigility-documentation/pull/59) fixes the "api" route parameter constraint to accept `%` characters, which
7777
are often present when multi-segment namespaces are used for a given API name.
7878

7979
## 1.2.3 - 2016-10-11
@@ -96,12 +96,12 @@ All notable changes to this project will be documented in this file, in reverse
9696

9797
### Fixed
9898

99-
- [#49](https://github.com/zfcampus/zf-apigility-documentation/pull/49) fixes
99+
- [zfcampus/zf-apigility-documentation#49](https://github.com/zfcampus/zf-apigility-documentation/pull/49) fixes
100100
representation of nested collections.
101-
- [#50](https://github.com/zfcampus/zf-apigility-documentation/pull/50) fixes
101+
- [zfcampus/zf-apigility-documentation#50](https://github.com/zfcampus/zf-apigility-documentation/pull/50) fixes
102102
escaping of field decriptions; previously, the template was improperly using
103103
`escapeTransformDescription()` instead of `agTransformDescription()`.
104-
- [#52](https://github.com/zfcampus/zf-apigility-documentation/pull/52) fixes
104+
- [zfcampus/zf-apigility-documentation#52](https://github.com/zfcampus/zf-apigility-documentation/pull/52) fixes
105105
output of fields when the `allows_only_fields_in_filter` parameter is present
106106
for an input filter.
107107

@@ -121,7 +121,7 @@ All notable changes to this project will be documented in this file, in reverse
121121

122122
### Fixed
123123

124-
- [#53](https://github.com/zfcampus/zf-apigility-documentation/pull/53) fixes an
124+
- [zfcampus/zf-apigility-documentation#53](https://github.com/zfcampus/zf-apigility-documentation/pull/53) fixes an
125125

126126
## 1.2.2 - 2016-08-10
127127

@@ -139,7 +139,7 @@ All notable changes to this project will be documented in this file, in reverse
139139

140140
### Fixed
141141

142-
- [#53](https://github.com/zfcampus/zf-apigility-documentation/pull/53) fixes an
142+
- [zfcampus/zf-apigility-documentation#53](https://github.com/zfcampus/zf-apigility-documentation/pull/53) fixes an
143143
import statement in the configuration file.
144144

145145
## 1.2.1 - 2016-08-04
@@ -158,29 +158,29 @@ All notable changes to this project will be documented in this file, in reverse
158158

159159
### Fixed
160160

161-
- [#48](https://github.com/zfcampus/zf-apigility-documentation/pull/48) updates
161+
- [zfcampus/zf-apigility-documentation#48](https://github.com/zfcampus/zf-apigility-documentation/pull/48) updates
162162
the `ControllerFactory` implementation to be forwards compatible with
163-
zend-servicemanager v3.
163+
laminas-servicemanager v3.
164164

165165
## 1.2.0 - 2016-07-14
166166

167167
### Added
168168

169-
- [#43](https://github.com/zfcampus/zf-apigility-documentation/pull/43) adds
170-
support for v3 releases of Zend Framework components, while retaining support
169+
- [zfcampus/zf-apigility-documentation#43](https://github.com/zfcampus/zf-apigility-documentation/pull/43) adds
170+
support for v3 releases of Laminas components, while retaining support
171171
for v2 releases.
172-
- [#43](https://github.com/zfcampus/zf-apigility-documentation/pull/43) extracts
172+
- [zfcampus/zf-apigility-documentation#43](https://github.com/zfcampus/zf-apigility-documentation/pull/43) extracts
173173
the `ApiFactory` factory inlined in the `Module` class to a first-class
174-
factory, `ZF\Apigility\Documentation\Factory\ApiFactoryFactory`.
175-
- [#19](https://github.com/zfcampus/zf-apigility-documentation/pull/19) adds
174+
factory, `Laminas\ApiTools\Documentation\Factory\ApiFactoryFactory`.
175+
- [zfcampus/zf-apigility-documentation#19](https://github.com/zfcampus/zf-apigility-documentation/pull/19) adds
176176
support for displaying documentation of APIs with nested namespaces (e.g.,
177177
`Company\ApiName` vs just `ApiName`). Such services are now denoted with
178178
dot-notation: `Company.ApiName`.
179-
- [#35](https://github.com/zfcampus/zf-apigility-documentation/pull/35) adds
179+
- [zfcampus/zf-apigility-documentation#35](https://github.com/zfcampus/zf-apigility-documentation/pull/35) adds
180180
a new view helper, `agTransformDescription()`, which will transform markdown
181181
descriptions to HTML. This is now used by default in the supplied view
182182
scripts. **This means you can now use markdown in your API descriptions!**
183-
- [#38](https://github.com/zfcampus/zf-apigility-documentation/pull/38) updates
183+
- [zfcampus/zf-apigility-documentation#38](https://github.com/zfcampus/zf-apigility-documentation/pull/38) updates
184184
the `Field` class to allow setting the field type, and updates the operation
185185
view script to now display field types for given operations.
186186

@@ -190,7 +190,7 @@ All notable changes to this project will be documented in this file, in reverse
190190

191191
### Removed
192192

193-
- [#43](https://github.com/zfcampus/zf-apigility-documentation/pull/43) removes
193+
- [zfcampus/zf-apigility-documentation#43](https://github.com/zfcampus/zf-apigility-documentation/pull/43) removes
194194
support for PHP 5.5.
195195

196196
### Fixed
@@ -213,16 +213,16 @@ All notable changes to this project will be documented in this file, in reverse
213213

214214
### Fixed
215215

216-
- [#39](https://github.com/zfcampus/zf-apigility-documentation/pull/39) updates
217-
the component to properly display information about zend-inputfilter
216+
- [zfcampus/zf-apigility-documentation#39](https://github.com/zfcampus/zf-apigility-documentation/pull/39) updates
217+
the component to properly display information about laminas-inputfilter
218218
Collections when displaying operation validation information.
219-
- [#40](https://github.com/zfcampus/zf-apigility-documentation/pull/40) updates
219+
- [zfcampus/zf-apigility-documentation#40](https://github.com/zfcampus/zf-apigility-documentation/pull/40) updates
220220
the Operations view script to:
221221
- display HTTP method-specific fields first, if present.
222222
- display general fields only if they exist (the fix prevents an empty row
223223
displaying).
224224
- insert a closing `</span>` tag within the table data cell containing the
225225
required flag.
226-
- [#41](https://github.com/zfcampus/zf-apigility-documentation/pull/41) updates
226+
- [zfcampus/zf-apigility-documentation#41](https://github.com/zfcampus/zf-apigility-documentation/pull/41) updates
227227
the `ApiFactory` to ensure that if an entity has no collection associated with
228228
it, documentation will not attempt to retrieve the fields.

COPYRIGHT.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
Copyright (c) 2019, Laminas Foundation.
2+
All rights reserved. (https://getlaminas.org/)

LICENSE.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,19 @@
1-
Copyright (c) 2014-2018, Zend Technologies USA, Inc.
1+
Copyright (c) 2019, Laminas Foundation
22
All rights reserved.
33

4-
Redistribution and use in source and binary forms, with or without modification,
5-
are permitted provided that the following conditions are met:
4+
Redistribution and use in source and binary forms, with or without
5+
modification, are permitted provided that the following conditions are met:
66

77
- Redistributions of source code must retain the above copyright notice, this
88
list of conditions and the following disclaimer.
99

10-
- Redistributions in binary form must reproduce the above copyright notice, this
11-
list of conditions and the following disclaimer in the documentation and/or
12-
other materials provided with the distribution.
10+
- Redistributions in binary form must reproduce the above copyright notice,
11+
this list of conditions and the following disclaimer in the documentation
12+
and/or other materials provided with the distribution.
1313

14-
- Neither the name of Zend Technologies USA, Inc. nor the names of its
15-
contributors may be used to endorse or promote products derived from this
16-
software without specific prior written permission.
14+
- Neither the name of Laminas Foundation nor the names of its contributors may
15+
be used to endorse or promote products derived from this software without
16+
specific prior written permission.
1717

1818
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
1919
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED

README.md

Lines changed: 29 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
1-
# ZF Apigility Documentation
1+
# Laminas API Tools Documentation
22

3-
[![Build Status](https://secure.travis-ci.org/zfcampus/zf-apigility-documentation.svg?branch=master)](https://secure.travis-ci.org/zfcampus/zf-apigility-documentation)
4-
[![Coverage Status](https://coveralls.io/repos/github/zfcampus/zf-apigility-documentation/badge.svg?branch=master)](https://coveralls.io/github/zfcampus/zf-apigility-documentation?branch=master)
3+
[![Build Status](https://travis-ci.org/laminas-api-tools/api-tools-documentation.svg?branch=master)](https://travis-ci.org/laminas-api-tools/api-tools-documentation)
4+
[![Coverage Status](https://coveralls.io/repos/github/laminas-api-tools/api-tools-documentation/badge.svg?branch=master)](https://coveralls.io/github/laminas-api-tools/api-tools-documentation?branch=master)
55

66
## Introduction
77

8-
This Zend Framework module can be used with conjunction with Apigility in order to:
8+
This Laminas module can be used with conjunction with Laminas API Tools in order to:
99

1010
- provide an object model of all captured documentation information, including:
1111
- All APIs available.
@@ -19,7 +19,7 @@ This Zend Framework module can be used with conjunction with Apigility in order
1919
- end-users may configure alternate/additional formats via content-negotiation.
2020

2121
This module accomplishes all the above use cases by providing an endpoint to connect to
22-
(`/apigility/documentation[/:api[-v:version][/:service]]`), using content-negotiation to provide
22+
(`/api-tools/documentation[/:api[-v:version][/:service]]`), using content-negotiation to provide
2323
both HTML and JSON representations.
2424

2525
## Requirements
@@ -31,14 +31,14 @@ Please see the [composer.json](composer.json) file.
3131
Run the following `composer` command:
3232

3333
```console
34-
$ composer require zfcampus/zf-apigility-documentation
34+
$ composer require laminas-api-tools/api-tools-documentation
3535
```
3636

3737
Alternately, manually add the following to your `composer.json`, in the `require` section:
3838

3939
```javascript
4040
"require": {
41-
"zfcampus/zf-apigility-documentation": "^1.2-dev"
41+
"laminas-api-tools/api-tools-documentation": "^1.2-dev"
4242
}
4343
```
4444

@@ -52,16 +52,16 @@ return [
5252
/* ... */
5353
'modules' => [
5454
/* ... */
55-
'ZF\Apigility\Documentation',
55+
'Laminas\ApiTools\Documentation',
5656
],
5757
/* ... */
5858
];
5959
```
6060

61-
> ### zf-component-installer
61+
> ### laminas-component-installer
6262
>
63-
> If you use [zf-component-installer](https://github.com/zendframework/zf-component-installer),
64-
> that plugin will install zf-apigility-documentation as a module for you.
63+
> If you use [laminas-component-installer](https://github.com/laminas/laminas-component-installer),
64+
> that plugin will install api-tools-documentation as a module for you.
6565
6666
## Configuration
6767

@@ -71,19 +71,19 @@ This module does not utilize any user configuration.
7171

7272
### System Configuration
7373

74-
The following configuration is defined by the module to ensure operation within a Zend Framework 2
74+
The following configuration is defined by the module to ensure operation within a Laminas
7575
MVC application.
7676

7777
```php
78-
namespace ZF\Apigility\Documentation;
78+
namespace Laminas\ApiTools\Documentation;
7979

80-
use Zend\ServiceManager\Factory\InvokableFactory;
81-
use Zend\View\Model\ViewModel;
80+
use Laminas\ServiceManager\Factory\InvokableFactory;
81+
use Laminas\View\Model\ViewModel;
8282

8383
return [
8484
'router' => [
8585
'routes' => [
86-
'zf-apigility' => [
86+
'api-tools' => [
8787
'child_routes' => [
8888
'documentation' => [
8989
'type' => 'segment',
@@ -112,7 +112,7 @@ return [
112112
Controller::class => ControllerFactory::class,
113113
],
114114
],
115-
'zf-content-negotiation' => [
115+
'api-tools-content-negotiation' => [
116116
'controllers' => [
117117
Controller::class => 'Documentation',
118118
],
@@ -163,37 +163,37 @@ return [
163163
];
164164
```
165165

166-
## ZF Events
166+
## Laminas Events
167167

168168
This module has no events or listeners.
169169

170-
## ZF Services
170+
## Laminas Services
171171

172172
### View Helpers
173173

174174
The following list of view helpers assist in making API documentation models presentable in view
175175
scripts.
176176

177-
- `ZF\Apigility\Documentation\View\AgAcceptHeaders` (a.k.a `agAcceptHeaders`) for making a
177+
- `Laminas\ApiTools\Documentation\View\AgAcceptHeaders` (a.k.a `agAcceptHeaders`) for making a
178178
list of `Accept` headers, escaped for HTML.
179-
- `ZF\Apigility\Documentation\View\AgContentTypeHeaders` (a.k.a `agContentTypeHeaders`) for
179+
- `Laminas\ApiTools\Documentation\View\AgContentTypeHeaders` (a.k.a `agContentTypeHeaders`) for
180180
making a list of `Content-Type` headers, escaped for HTML.
181-
- `ZF\Apigility\Documentation\View\AgServicePath` (a.k.a `agServicePath`) for making an HTML
181+
- `Laminas\ApiTools\Documentation\View\AgServicePath` (a.k.a `agServicePath`) for making an HTML
182182
view representation of the route configuration of a service path.
183-
- `ZF\Apigility\Documentation\View\AgStatusCodes` (a.k.a `agStatusCodes`) for making an
183+
- `Laminas\ApiTools\Documentation\View\AgStatusCodes` (a.k.a `agStatusCodes`) for making an
184184
escaped list of status codes and their messages.
185-
- `ZF\Apigility\Documentation\View\AgTransformDescription` (a.k.a `agTransformDescription`) for transforming the written
185+
- `Laminas\ApiTools\Documentation\View\AgTransformDescription` (a.k.a `agTransformDescription`) for transforming the written
186186
descriptions into Markdown.
187187

188188
### Factories
189189

190-
#### ZF\Apigility\Documentation\ApiFactory
190+
#### Laminas\ApiTools\Documentation\ApiFactory
191191

192192
The `ApiFactory` service is capable of producing an object-graph representation of the desired
193193
API documentation that is requested. This object-graph will be composed of the following types:
194194

195-
- `ZF\Apigility\Documentation\Api`: the root node of an API.
196-
- `ZF\Apigility\Documentation\Services`: an array of services in the API (a service can be one
195+
- `Laminas\ApiTools\Documentation\Api`: the root node of an API.
196+
- `Laminas\ApiTools\Documentation\Services`: an array of services in the API (a service can be one
197197
of a REST or RPC style service).
198-
- `ZF\Apigility\Documentation\Operations`: an array of operations in the service.
199-
- `ZF\Apigility\Documentation\Fields`: an array of fields for a service.
198+
- `Laminas\ApiTools\Documentation\Operations`: an array of operations in the service.
199+
- `Laminas\ApiTools\Documentation\Fields`: an array of fields for a service.

0 commit comments

Comments
 (0)