dingo / blueprint by jasonlewis

API Blueprint documentation generator.
7,206,221
271
18
Package Data
Maintainer Username: jasonlewis
Maintainer Contact: jason.lewis1991@gmail.com (Jason Lewis)
Package Create Date: 2015-06-20
Package Last Update: 2024-05-09
Language: PHP
License: BSD-3-Clause
Last Refreshed: 2024-12-11 15:09:09
Package Statistics
Total Downloads: 7,206,221
Monthly Downloads: 54,410
Daily Downloads: 2,215
Total Stars: 271
Total Watchers: 18
Total Forks: 108
Total Open Issues: 20

API Blueprint Generator

Build Status License Development Version Monthly Installs StyleCI

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.