Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/zunderbolt/cakephp-shell-autohelp

Autogenerates CakePHP3 console shell help
https://github.com/zunderbolt/cakephp-shell-autohelp

cakephp cakephp3 shell

Last synced: about 1 month ago
JSON representation

Autogenerates CakePHP3 console shell help

Awesome Lists containing this project

README

        

# Shell-auto-help plugin for CakePHP

Small trait to autogenerate CakePHP3 console shells help. No need to write ```$parser->addArgument()``` and stuff,
just add phpdoc to your shell methods.

#### Installation
```
composer require zunderbolt/cakephp-shell-autohelp
```

#### Usage

```php
namespace App\Shell;

use Cake\Console\Shell;
use ZunderBolt\ShellAutoHelp\AutoHelpTrait;

class MyShell extends Shell
{
use AutoHelpTrait;

/**
* Method description will be used in help
* @param string $param1 Param1 description
* @param mixed $param2 Param2 description
*/
public function test($param1, $param2 = null)
{
}
}
```

`> bin/cake my`
```
Usage:
cake my [subcommand] [-h] [-q] [-v]

Subcommands:

test Method description will be used in help
```

`> bin/cake my test --help`
```
Usage:
cake my test [-h] [-q] [-v] []

Options:

--help, -h Display this help.
--quiet, -q Enable quiet output.
--verbose, -v Enable verbose output.

Arguments:

param1 (string) Param1 description
param2 (mixed) Param2 description (optional)
```