dingo/blueprint

API Blueprint documentation generator.

Package info

github.com/dingo/blueprint

pkg:composer/dingo/blueprint

Statistics

Installs: 7 827 012

Dependents: 23

Suggesters: 2

Stars: 270

Open Issues: 19

v0.5.0 2024-05-09 18:17 UTC

Requires

Requires (Dev)

Suggests

None

Provides

None

Conflicts

None

Replaces

None

BSD-3-Clause 9d67ce64a5b77c002b49884326b23967285bf328

  • Jason Lewis <jason.lewis1991.woop@gmail.com>

apidocsblueprintlaraveldingo


README

👁 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.