johnylemon / explainer-lumen by johnylemon

API Explainer for Lumen Framework
8
0
1
Package Data
Maintainer Username: johnylemon
Maintainer Contact: johnylemon1989@gmail.com (Piotr Krzempek)
Package Create Date: 2019-05-16
Package Last Update: 2019-09-04
Language: PHP
License: MIT
Last Refreshed: 2024-03-27 03:25:04
Package Statistics
Total Downloads: 8
Monthly Downloads: 0
Daily Downloads: 0
Total Stars: 0
Total Watchers: 1
Total Forks: 0
Total Open Issues: 0

Explainer for Laravel

A simple Laravel api documentation generator

Features

This tool makes possible to explain every app route by using simple explain method via clean document accessible under configured route address.

Installation

  • add \Lemon\ExplainerLumen\Providers\ExplainerLumenServiceProvider to your app/bootstrap.php file
  • add $this->configure('explainer') to your app/bootstrap.php file after provider line
  • change bootstrap Application to provided by this package by changingthis lines
// $app = new Laravel\Lumen\Application(
//     dirname(__DIR__)
// );

into this

$app = new Lemon\ExplainerLumen\Application(
    dirname(__DIR__)
);
  • copy vendor/johnylemon/explainer/config/explainer.php file to your config directory

How to use

Simply call explain method on your routes:

$router->get('/', 'IndexController@index')->explain(\App\Explains\IndexRouteExplain::class);

Examples

Explain file generation

To generate route explain file with name IndexRouteExplain in app/Explains directory simply type:

php artisan explain:route IndexRouteExplain

Explain example generation

To generate route explain example file with name ValidationExample in app/Explains/Examples directory simply type:

php artisan explain:example ValidationExample

generate documentation

Simply type

php artisan explain

and... enjoy!