Skip to content

Commit edc59bb

Browse files
committed
Rewriting as Laminas Project package
1 parent 49bbd98 commit edc59bb

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
@@ -28,13 +28,13 @@ All notable changes to this project will be documented in this file, in reverse
2828

2929
### Added
3030

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

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

3535
### Changed
3636

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

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

4545
### Removed
4646

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

4949
### Fixed
5050

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

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

5757
## 1.2.3 - 2016-10-11
@@ -74,12 +74,12 @@ All notable changes to this project will be documented in this file, in reverse
7474

7575
### Fixed
7676

77-
- [#49](https://github.com/zfcampus/zf-apigility-documentation/pull/49) fixes
77+
- [zfcampus/zf-apigility-documentation#49](https://github.com/zfcampus/zf-apigility-documentation/pull/49) fixes
7878
representation of nested collections.
79-
- [#50](https://github.com/zfcampus/zf-apigility-documentation/pull/50) fixes
79+
- [zfcampus/zf-apigility-documentation#50](https://github.com/zfcampus/zf-apigility-documentation/pull/50) fixes
8080
escaping of field decriptions; previously, the template was improperly using
8181
`escapeTransformDescription()` instead of `agTransformDescription()`.
82-
- [#52](https://github.com/zfcampus/zf-apigility-documentation/pull/52) fixes
82+
- [zfcampus/zf-apigility-documentation#52](https://github.com/zfcampus/zf-apigility-documentation/pull/52) fixes
8383
output of fields when the `allows_only_fields_in_filter` parameter is present
8484
for an input filter.
8585

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

100100
### Fixed
101101

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

104104
## 1.2.2 - 2016-08-10
105105

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

118118
### Fixed
119119

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

123123
## 1.2.1 - 2016-08-04
@@ -136,29 +136,29 @@ All notable changes to this project will be documented in this file, in reverse
136136

137137
### Fixed
138138

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

143143
## 1.2.0 - 2016-07-14
144144

145145
### Added
146146

147-
- [#43](https://github.com/zfcampus/zf-apigility-documentation/pull/43) adds
148-
support for v3 releases of Zend Framework components, while retaining support
147+
- [zfcampus/zf-apigility-documentation#43](https://github.com/zfcampus/zf-apigility-documentation/pull/43) adds
148+
support for v3 releases of Laminas components, while retaining support
149149
for v2 releases.
150-
- [#43](https://github.com/zfcampus/zf-apigility-documentation/pull/43) extracts
150+
- [zfcampus/zf-apigility-documentation#43](https://github.com/zfcampus/zf-apigility-documentation/pull/43) extracts
151151
the `ApiFactory` factory inlined in the `Module` class to a first-class
152-
factory, `ZF\Apigility\Documentation\Factory\ApiFactoryFactory`.
153-
- [#19](https://github.com/zfcampus/zf-apigility-documentation/pull/19) adds
152+
factory, `Laminas\ApiTools\Documentation\Factory\ApiFactoryFactory`.
153+
- [zfcampus/zf-apigility-documentation#19](https://github.com/zfcampus/zf-apigility-documentation/pull/19) adds
154154
support for displaying documentation of APIs with nested namespaces (e.g.,
155155
`Company\ApiName` vs just `ApiName`). Such services are now denoted with
156156
dot-notation: `Company.ApiName`.
157-
- [#35](https://github.com/zfcampus/zf-apigility-documentation/pull/35) adds
157+
- [zfcampus/zf-apigility-documentation#35](https://github.com/zfcampus/zf-apigility-documentation/pull/35) adds
158158
a new view helper, `agTransformDescription()`, which will transform markdown
159159
descriptions to HTML. This is now used by default in the supplied view
160160
scripts. **This means you can now use markdown in your API descriptions!**
161-
- [#38](https://github.com/zfcampus/zf-apigility-documentation/pull/38) updates
161+
- [zfcampus/zf-apigility-documentation#38](https://github.com/zfcampus/zf-apigility-documentation/pull/38) updates
162162
the `Field` class to allow setting the field type, and updates the operation
163163
view script to now display field types for given operations.
164164

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

169169
### Removed
170170

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

174174
### Fixed
@@ -191,16 +191,16 @@ All notable changes to this project will be documented in this file, in reverse
191191

192192
### Fixed
193193

194-
- [#39](https://github.com/zfcampus/zf-apigility-documentation/pull/39) updates
195-
the component to properly display information about zend-inputfilter
194+
- [zfcampus/zf-apigility-documentation#39](https://github.com/zfcampus/zf-apigility-documentation/pull/39) updates
195+
the component to properly display information about laminas-inputfilter
196196
Collections when displaying operation validation information.
197-
- [#40](https://github.com/zfcampus/zf-apigility-documentation/pull/40) updates
197+
- [zfcampus/zf-apigility-documentation#40](https://github.com/zfcampus/zf-apigility-documentation/pull/40) updates
198198
the Operations view script to:
199199
- display HTTP method-specific fields first, if present.
200200
- display general fields only if they exist (the fix prevents an empty row
201201
displaying).
202202
- insert a closing `</span>` tag within the table data cell containing the
203203
required flag.
204-
- [#41](https://github.com/zfcampus/zf-apigility-documentation/pull/41) updates
204+
- [zfcampus/zf-apigility-documentation#41](https://github.com/zfcampus/zf-apigility-documentation/pull/41) updates
205205
the `ApiFactory` to ensure that if an entity has no collection associated with
206206
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)