soitpl/dingo-api-blueprint

API Blueprint documentation generator.

v0.4.2 2020-09-13 12:32 UTC

Requires

• php: ^7.2.5
• doctrine/annotations: ~1.2
• illuminate/filesystem: ^7.0|^8.0
• illuminate/support: ^7.0|^8.0
• phpdocumentor/reflection-docblock: ^3.1 || ^4.1 || ^5

Requires (Dev)

• phpunit/phpunit: ^6.5|^8.3|^9.0
• squizlabs/php_codesniffer: ~2.0

BSD-3-Clause

• Jason Lewis

• api
• docs
• blueprint
• laravel
• dingo

README

This package generates a valid API Blueprint 1A document from a collection of classes.

Usage

Some index method phpdoc example:

<?php

/**
 * Products
 *
 * @Resource("Products", uri="/products")
*/
class ProductsController extends ApiController
{
    /**
     * Products list
     *
     * Get current products list
     * 
     * @Get("/")
     * @Versions({"v1"})
     * @Transaction({
     *      @Request(identifier="/?state=synced"),
     *      @Response(200, body={"data":{{"id":"rkoVJ7qa4Z6lzXdVnldgx9LmpBP0DQ3e","name":"Product name","status":"active"}},"meta":{"pagination":{"total":1,"count":1,"per_page":1,"current_page":1,"total_pages":1,"links":{}}}})
     * })
     * @Parameters({
     *      @Parameter("api_token", type="string", required=true, description="API Token", default=null),
     *      @Parameter("page", type="integer", required=false, description="Pagination page", default=1),
     *      @Parameter("state", type="string", required=false, description="Product status filter", default="synced", members={
     *          @Member(value="synced", description="Products synced"),
     *          @Member(value="pending", description="Products pending")
     *      })
     * })
     */
    public function index(Request $request)
    {}
}

License

This package is licensed under the BSD 3-Clause license.