Skip to content

Commit bae6ed3

Browse files
committed
Rewriting as Laminas Project package
1 parent 20ae5aa commit bae6ed3

30 files changed

+250
-208
lines changed

.gitignore

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,2 @@
1-
composer.lock
2-
vendor/
1+
/composer.lock
2+
/vendor/

.travis.yml

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,5 +17,4 @@ after_script:
1717
- php ./vendor/bin/coveralls -v
1818

1919
notifications:
20-
irc: "irc.freenode.org#apigility-dev"
2120
email: false

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/)

Module.php

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,15 @@
11
<?php
2+
23
/**
3-
* @license http://opensource.org/licenses/BSD-3-Clause BSD-3-Clause
4-
* @copyright Copyright (c) 2014 Zend Technologies USA Inc. (http://www.zend.com)
4+
* @see https://github.com/laminas-api-tools/api-tools-documentation for the canonical source repository
5+
* @copyright https://github.com/laminas-api-tools/api-tools-documentation/blob/master/COPYRIGHT.md
6+
* @license https://github.com/laminas-api-tools/api-tools-documentation/blob/master/LICENSE.md New BSD License
57
*/
68

7-
namespace ZF\Apigility\Documentation;
9+
namespace Laminas\ApiTools\Documentation;
810

9-
use Zend\ModuleManager\Feature\AutoloaderProviderInterface;
10-
use Zend\ModuleManager\Feature\ConfigProviderInterface;
11+
use Laminas\ModuleManager\Feature\AutoloaderProviderInterface;
12+
use Laminas\ModuleManager\Feature\ConfigProviderInterface;
1113

1214
class Module implements AutoloaderProviderInterface, ConfigProviderInterface
1315
{
@@ -19,7 +21,7 @@ public function getConfig()
1921
public function getAutoloaderConfig()
2022
{
2123
return array(
22-
'Zend\Loader\StandardAutoloader' => array(
24+
'Laminas\Loader\StandardAutoloader' => array(
2325
'namespaces' => array(
2426
__NAMESPACE__ => __DIR__ . '/src/',
2527
),
@@ -30,11 +32,11 @@ public function getAutoloaderConfig()
3032
public function getServiceConfig()
3133
{
3234
return array('factories' => array(
33-
'ZF\Apigility\Documentation\ApiFactory' => function ($services) {
35+
'Laminas\ApiTools\Documentation\ApiFactory' => function ($services) {
3436
return new ApiFactory(
35-
$services->get('Zend\ModuleManager\ModuleManager'),
37+
$services->get('Laminas\ModuleManager\ModuleManager'),
3638
$services->get('Config'),
37-
$services->get('ZF\Configuration\ModuleUtils')
39+
$services->get('Laminas\ApiTools\Configuration\ModuleUtils')
3840
);
3941
}
4042
));

README.md

Lines changed: 32 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
1-
ZF Apigility Documentation
1+
Laminas API Tools Documentation
22
==========================
33

4-
[![Build Status](https://travis-ci.org/zfcampus/zf-apigility-documentation.png)](https://travis-ci.org/zfcampus/zf-apigility-documentation)
4+
[![Build Status](https://travis-ci.org/laminas-api-tools/api-tools-documentation.png)](https://travis-ci.org/laminas-api-tools/api-tools-documentation)
55

66
Introduction
77
------------
88

9-
This ZF2 module can be used with conjunction with Apigility in order to:
9+
This Laminas module can be used with conjunction with Laminas API Tools in order to:
1010

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

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

2626
Installation
@@ -29,14 +29,14 @@ Installation
2929
Run the following `composer` command:
3030

3131
```console
32-
$ composer require "zfcampus/zf-apigility-documentation:~1.0-dev"
32+
$ composer require "laminas-api-tools/api-tools-documentation:~1.0-dev"
3333
```
3434

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

3737
```javascript
3838
"require": {
39-
"zfcampus/zf-apigility-documentation": "~1.0-dev"
39+
"laminas-api-tools/api-tools-documentation": "~1.0-dev"
4040
}
4141
```
4242

@@ -50,7 +50,7 @@ return array(
5050
/* ... */
5151
'modules' => array(
5252
/* ... */
53-
'ZF\Apigility\Documentation',
53+
'Laminas\ApiTools\Documentation',
5454
),
5555
/* ... */
5656
);
@@ -65,23 +65,23 @@ This module does not utilize any user configuration.
6565

6666
### System Configuration
6767

68-
The following configuration is defined by the module to ensure operation within a Zend Framework 2
68+
The following configuration is defined by the module to ensure operation within a Laminas
6969
MVC application.
7070

7171
```php
7272
'router' => array(
7373
'routes' => array(
74-
'zf-apigility' => array(
74+
'api-tools' => array(
7575
'child_routes' => array(
7676
'documentation' => array(
77-
'type' => 'Zend\Mvc\Router\Http\Segment',
77+
'type' => 'Laminas\Mvc\Router\Http\Segment',
7878
'options' => array(
7979
'route' => '/documentation[/:api[-v:version][/:service]]',
8080
'constraints' => array(
8181
'api' => '[a-zA-Z][a-zA-Z0-9_]+',
8282
),
8383
'defaults' => array(
84-
'controller' => 'ZF\Apigility\Documentation\Controller',
84+
'controller' => 'Laminas\ApiTools\Documentation\Controller',
8585
'action' => 'show',
8686
),
8787
),
@@ -92,25 +92,25 @@ MVC application.
9292
),
9393
'controllers' => array(
9494
'factories' => array(
95-
'ZF\Apigility\Documentation\Controller' => 'ZF\Apigility\Documentation\ControllerFactory',
95+
'Laminas\ApiTools\Documentation\Controller' => 'Laminas\ApiTools\Documentation\ControllerFactory',
9696
),
9797
),
98-
'zf-content-negotiation' => array(
98+
'api-tools-content-negotiation' => array(
9999
'controllers' => array(
100-
'ZF\Apigility\Documentation\Controller' => 'Documentation',
100+
'Laminas\ApiTools\Documentation\Controller' => 'Documentation',
101101
),
102102
'accept_whitelist' => array(
103-
'ZF\Apigility\Documentation\Controller' => array(
103+
'Laminas\ApiTools\Documentation\Controller' => array(
104104
0 => 'application/vnd.swagger+json',
105105
1 => 'application/json',
106106
),
107107
),
108108
'selectors' => array(
109109
'Documentation' => array(
110-
'ZF\Apigility\Documentation\JsonModel' => array(
110+
'Laminas\ApiTools\Documentation\JsonModel' => array(
111111
'application/json',
112112
),
113-
'Zend\View\Model\ViewModel' => array(
113+
'Laminas\View\Model\ViewModel' => array(
114114
'text/html',
115115
'application/xhtml+xml',
116116
),
@@ -119,10 +119,10 @@ MVC application.
119119
),
120120
'view_helpers' => array(
121121
'invokables' => array(
122-
'agacceptheaders' => 'ZF\Apigility\Documentation\View\AgAcceptHeaders',
123-
'agcontenttypeheaders' => 'ZF\Apigility\Documentation\View\AgContentTypeHeaders',
124-
'agservicepath' => 'ZF\Apigility\Documentation\View\AgServicePath',
125-
'agstatuscodes' => 'ZF\Apigility\Documentation\View\AgStatusCodes',
122+
'agacceptheaders' => 'Laminas\ApiTools\Documentation\View\AgAcceptHeaders',
123+
'agcontenttypeheaders' => 'Laminas\ApiTools\Documentation\View\AgContentTypeHeaders',
124+
'agservicepath' => 'Laminas\ApiTools\Documentation\View\AgServicePath',
125+
'agstatuscodes' => 'Laminas\ApiTools\Documentation\View\AgStatusCodes',
126126
),
127127
),
128128
'view_manager' => array(
@@ -132,37 +132,37 @@ MVC application.
132132
),
133133
```
134134

135-
ZF2 Events
135+
Laminas Events
136136
==========
137137

138138
This module has no events or listeners.
139139

140-
ZF2 Services
140+
Laminas Services
141141
============
142142

143143
### View Helpers
144144

145145
The following list of view helpers assist in making API documentation models presentable in view
146146
scripts.
147147

148-
- `ZF\Apigility\Documentation\View\AgAcceptHeaders` (a.k.a `agAcceptHeaders`) for making a
148+
- `Laminas\ApiTools\Documentation\View\AgAcceptHeaders` (a.k.a `agAcceptHeaders`) for making a
149149
list of `Accept` headers, escaped for HTML.
150-
- `ZF\Apigility\Documentation\View\AgContentTypeHeaders` (a.k.a `agContentTypeHeaders`) for
150+
- `Laminas\ApiTools\Documentation\View\AgContentTypeHeaders` (a.k.a `agContentTypeHeaders`) for
151151
making a list of `Content-Type` headers, escaped for HTML.
152-
- `ZF\Apigility\Documentation\View\AgServicePath` (a.k.a `agServicePath`) for making an HTML
152+
- `Laminas\ApiTools\Documentation\View\AgServicePath` (a.k.a `agServicePath`) for making an HTML
153153
view representation of the route configuration of a service path.
154-
- `ZF\Apigility\Documentation\View\AgStatusCodes` (a.k.a `agStatusCodes`) for making an
154+
- `Laminas\ApiTools\Documentation\View\AgStatusCodes` (a.k.a `agStatusCodes`) for making an
155155
escaped list of status codes and their messages.
156156

157157
### Factories
158158

159-
#### `ZF\Apigility\Documentation\ApiFactory`
159+
#### `Laminas\ApiTools\Documentation\ApiFactory`
160160

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

164-
- `ZF\Apigility\Documentation\Api`: the root node of an API.
165-
- `ZF\Apigility\Documentation\Services`: an array of services in the API (a service can be one
164+
- `Laminas\ApiTools\Documentation\Api`: the root node of an API.
165+
- `Laminas\ApiTools\Documentation\Services`: an array of services in the API (a service can be one
166166
of a REST or RPC style service).
167-
- `ZF\Apigility\Documentation\Operations`: an array of operations in the service.
168-
- `ZF\Apigility\Documentation\Fields`: an array of fields for a service.
167+
- `Laminas\ApiTools\Documentation\Operations`: an array of operations in the service.
168+
- `Laminas\ApiTools\Documentation\Fields`: an array of fields for a service.

composer.json

Lines changed: 22 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,24 @@
11
{
2-
"name": "zfcampus/zf-apigility-documentation",
3-
"description": "Apigility API documentation module",
4-
"type": "library",
2+
"name": "laminas-api-tools/api-tools-documentation",
3+
"description": "Laminas API Tools API documentation module",
54
"license": "BSD-3-Clause",
65
"keywords": [
7-
"zf2",
8-
"zend",
6+
"laminas",
7+
"api-tools",
98
"module",
10-
"apigiltiy",
119
"documentation"
1210
],
13-
"homepage": "http://apigility.org/",
11+
"homepage": "https://api-tools.getlaminas.org",
1412
"support": {
15-
"email": "apigility-users@zend.com",
16-
"irc": "irc://irc.freenode.net/apigility",
17-
"source": "https://github.com/zfcampus/zf-apigility-documentation",
18-
"issues": "https://github.com/zfcampus/zf-apigility-documentation/issues"
13+
"docs": "https://api-tools.getlaminas.org/documentation",
14+
"issues": "https://github.com/laminas-api-tools/api-tools-documentation/issues",
15+
"source": "https://github.com/laminas-api-tools/api-tools-documentation",
16+
"rss": "https://github.com/laminas-api-tools/api-tools-documentation/releases.atom",
17+
"chat": "https://laminas.dev/chat",
18+
"forum": "https://discourse.laminas.dev"
19+
},
20+
"config": {
21+
"sort-packages": true
1922
},
2023
"extra": {
2124
"branch-alias": {
@@ -24,20 +27,24 @@
2427
},
2528
"require": {
2629
"php": ">=5.3.23",
27-
"zendframework/zendframework": "~2.3"
30+
"laminas/laminas": "~2.3",
31+
"laminas/laminas-zendframework-bridge": "^1.0"
2832
},
2933
"require-dev": {
3034
"fabpot/php-cs-fixer": "*@dev",
31-
"phpunit/PHPUnit": "3.7.*",
35+
"phpunit/phpunit": "3.7.*",
3236
"satooshi/php-coveralls": ">=0.6.0"
3337
},
3438
"autoload": {
3539
"psr-4": {
36-
"ZF\\Apigility\\Documentation\\": "src/",
37-
"ZFTest\\Apigility\\Documentation\\": "test/"
40+
"Laminas\\ApiTools\\Documentation\\": "src/",
41+
"LaminasTest\\ApiTools\\Documentation\\": "test/"
3842
},
3943
"classmap": [
4044
"Module.php"
4145
]
46+
},
47+
"replace": {
48+
"zfcampus/zf-apigility-documentation": "self.version"
4249
}
4350
}

config/module.config.php

Lines changed: 17 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,25 @@
11
<?php
2+
23
/**
3-
* @license http://opensource.org/licenses/BSD-3-Clause BSD-3-Clause
4-
* @copyright Copyright (c) 2014 Zend Technologies USA Inc. (http://www.zend.com)
4+
* @see https://github.com/laminas-api-tools/api-tools-documentation for the canonical source repository
5+
* @copyright https://github.com/laminas-api-tools/api-tools-documentation/blob/master/COPYRIGHT.md
6+
* @license https://github.com/laminas-api-tools/api-tools-documentation/blob/master/LICENSE.md New BSD License
57
*/
68

79
return array(
810
'router' => array(
911
'routes' => array(
10-
'zf-apigility' => array(
12+
'api-tools' => array(
1113
'child_routes' => array(
1214
'documentation' => array(
13-
'type' => 'Zend\Mvc\Router\Http\Segment',
15+
'type' => 'Laminas\Mvc\Router\Http\Segment',
1416
'options' => array(
1517
'route' => '/documentation[/:api[-v:version][/:service]]',
1618
'constraints' => array(
1719
'api' => '[a-zA-Z][a-zA-Z0-9_]+',
1820
),
1921
'defaults' => array(
20-
'controller' => 'ZF\Apigility\Documentation\Controller',
22+
'controller' => 'Laminas\ApiTools\Documentation\Controller',
2123
'action' => 'show',
2224
),
2325
),
@@ -28,25 +30,25 @@
2830
),
2931
'controllers' => array(
3032
'factories' => array(
31-
'ZF\Apigility\Documentation\Controller' => 'ZF\Apigility\Documentation\ControllerFactory',
33+
'Laminas\ApiTools\Documentation\Controller' => 'Laminas\ApiTools\Documentation\ControllerFactory',
3234
),
3335
),
34-
'zf-content-negotiation' => array(
36+
'api-tools-content-negotiation' => array(
3537
'controllers' => array(
36-
'ZF\Apigility\Documentation\Controller' => 'Documentation',
38+
'Laminas\ApiTools\Documentation\Controller' => 'Documentation',
3739
),
3840
'accept_whitelist' => array(
39-
'ZF\Apigility\Documentation\Controller' => array(
41+
'Laminas\ApiTools\Documentation\Controller' => array(
4042
0 => 'application/vnd.swagger+json',
4143
1 => 'application/json',
4244
),
4345
),
4446
'selectors' => array(
4547
'Documentation' => array(
46-
'ZF\Apigility\Documentation\JsonModel' => array(
48+
'Laminas\ApiTools\Documentation\JsonModel' => array(
4749
'application/json',
4850
),
49-
'Zend\View\Model\ViewModel' => array(
51+
'Laminas\View\Model\ViewModel' => array(
5052
'text/html',
5153
'application/xhtml+xml',
5254
),
@@ -55,10 +57,10 @@
5557
),
5658
'view_helpers' => array(
5759
'invokables' => array(
58-
'agacceptheaders' => 'ZF\Apigility\Documentation\View\AgAcceptHeaders',
59-
'agcontenttypeheaders' => 'ZF\Apigility\Documentation\View\AgContentTypeHeaders',
60-
'agservicepath' => 'ZF\Apigility\Documentation\View\AgServicePath',
61-
'agstatuscodes' => 'ZF\Apigility\Documentation\View\AgStatusCodes',
60+
'agacceptheaders' => 'Laminas\ApiTools\Documentation\View\AgAcceptHeaders',
61+
'agcontenttypeheaders' => 'Laminas\ApiTools\Documentation\View\AgContentTypeHeaders',
62+
'agservicepath' => 'Laminas\ApiTools\Documentation\View\AgServicePath',
63+
'agstatuscodes' => 'Laminas\ApiTools\Documentation\View\AgStatusCodes',
6264
),
6365
),
6466
'view_manager' => array(

phpunit.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<phpunit bootstrap="./test/Bootstrap.php" colors="true">
22
<testsuites>
3-
<testsuite name="ZF Apigility Documentation Module Tests">
3+
<testsuite name="Laminas API Tools Documentation Module Tests">
44
<directory>./test</directory>
55
</testsuite>
66
</testsuites>

0 commit comments

Comments
 (0)