2017 © Pedro Peláez
 

library cli-helpers

Utility classes to write PHP command-line scripts

image

amercier/cli-helpers

Utility classes to write PHP command-line scripts

  • Wednesday, November 15, 2017
  • by amercier
  • Repository
  • 4 Watchers
  • 21 Stars
  • 3,520 Installations
  • PHP
  • 3 Dependents
  • 0 Suggesters
  • 3 Forks
  • 0 Open issues
  • 12 Versions
  • 16 % Grown

The README.md

php-cli-helpers

Utility classes to write PHP command-line scripts, (*1)

Build Status Code Climate Test Coverage Dependency Status, (*2)

Latest Stable Version PHP version License, (*3)

Installation

php-cli-helpers is available through Composer., (*4)

  "require": {
    "amercier/cli-helpers": "1.*"
  }

php composer.phar install




If you are not familiar with _Composer_, please read the
[full installation intructions](docs/install.md).


Usage
-----


### \Cli\Helpers\Parameter

Utility class to handle command-line parameters.

```php
$options = \Cli\Helpers\Parameter::getFromCommandLine(array(
    'host'     => new Parameter('h', 'host'    , '127.0.0.1'),
    'username' => new Parameter('u', 'username', Parameter::VALUE_REQUIRED),
    'password' => new Parameter('p', 'password', Parameter::VALUE_REQUIRED),
    'verbose'  => new Parameter('v', 'verbose' , Parameter::VALUE_NO_VALUE),
));

$options['host'];     // given -h/--host, or 127.0.0.1 otherwise
$options['username']; // given -u/--username
$options['password']; // given -p/--password
$options['verbose'];  // true if -v/--verbose is given, false otherwise





See [API Documentation for Parameter](docs/api-parameter.md)


### \Cli\Helpers\Script and \Cli\Helpers\DocumentedScript

Utility class to write scripts as objects.




#!/usr/bin/env php
<?php
require_once dirname(__FILE__) . '/path/to/vendor/autoload.php';

use Cli\Helpers\DocumentedScript;
use Cli\Helpers\Parameter;

$script = new DocumentedScript();
$script
    ->setName('test-documented-script.php')
    ->setVersion('1.0')
    ->setDescription('Test script for Cli\Helpers\DocumentedScript')
    ->setCopyright('Copyright (c) Alexandre Mercier 2014')
    ->addParameter(new Parameter('H', 'host'    , '127.0.0.1')              , 'Host.')
    ->addParameter(new Parameter('u', 'username', Parameter::VALUE_REQUIRED), 'User name.')
    ->addParameter(new Parameter('p', 'password', Parameter::VALUE_REQUIRED), 'Password.')
    ->addParameter(new Parameter('v', 'verbose' , Parameter::VALUE_NO_VALUE), 'Enable verbosity.')
    ->setProgram(function ($options, $arguments) {
        var_dump($arguments);
        var_dump($options);
    })
    ->start();





While `Script` doesn't have any pre-configured switch, `DocumentedScript` has
`--h, --help` and `-V, --version`. This provides an automatic handling of this
two switches.

Version example:

`test-documented-script.php -V`



test-documented-script.php v1.0
Copyright (c) 2014 Alexandre Mercier





Help example:

`test-documented-script.php -h`



Usage: test-documented-script.php -p PASSWORD -u USERNAME [OPTIONS]

Test script for Cli\Helpers\DocumentedScript

  -H, --host     HOST        Host (defaults to '127.0.0.1').
  -u, --username USERNAME    User name.
  -p, --password PASSWORD    Password.
  -v, --verbose              Enable verbosity.
  -h, --help                 Display this help and exit.
  -V, --version              Output version information and exit.

test-documented-script.php v1.0
Copyright (c) 2014 Alexandre Mercier






### \Cli\Helpers\Job

Utility class to run a job and catch exceptions.

On successful jobs:



\Cli\Helpers\Job::run('Doing awesome stuff', function() {
    ... // awesome stuff
});

Doing awesome stuff... OK, (*5)


On unsuccessful jobs:
```php
\Cli\Helpers\Job::run('Fighting Chuck Norris', function() {
    ... // throws a RoundHouseKickException('You've received a round-house kick', 'face')
});

``` Fighting Chuck Norris... NOK - You've received a round-house kick in the face, (*6)


You can also add parameters to the function:

```php
\Cli\Helpers\Job::run(
    'Doing awesome stuff',
    function($a, $b) {
        $a; // => 1337;
        $b; // => 'good luck, im behind 7 firewalls';
    },
    array(1337, 'im behind 7 firewalls')
});

See API Documentation for Job, (*7)

\Cli\Helpers\IO

Utility class to handle standard input/output., (*8)

IO::form

Usage

\Cli\Helpers\IO::form('an apple', array(
    'Golden Delicious',
    'Granny Smith',
    'Pink Lady',
    'Royal Gala',
));

will display:, (*9)

1. Golden Delicious
2. Granny Smith
3. Pink Lady
4. Royal Gala

Choose an apple: |

Then, user is asked to make a choice between 1 and 3 on standard input., (*10)

IO::strPadAll

echo IO::strPadAll(
    array( // items
        array('#', 'EN', 'FR', 'ES'),
        '',
        array('1', 'One', 'Un', 'Uno'),
        array('2', 'Two', 'Deux', 'Dos'),
        array('3', 'Three', 'Trois', 'Tres'),
        array('4', 'Four', 'Quatre', 'Cuatro'),
        array('5', 'Five', 'Cinq', 'Cinco'),
    ),
    array( // alignment
        2 => STR_PAD_LEFT,
        3 => STR_PAD_RIGHT,
    ),
    "\n", // line separator
    '   ' // field separator
));

will display:, (*11)

#   EN          FR   ES

1   One         Un   Uno
2   Two       Deux   Dos
3   Three    Trois   Tres
4   Four    Quatre   Cuatro
5   Five      Cinq   Cinco

See API Documentation for IO, (*12)

Contributing

Contributions (issues ♥, pull requests ♥♥♥) are more than welcome! Feel free to clone, fork, modify, extend, etc, as long as you respect the license terms., (*13)

See contributing intructions for details., (*14)

Licensing

This project is released under ISC License license. If this license does not fit your requirement for whatever reason, but you would be interested in using the work (as defined below) under another license, please contact authors., (*15)

The Versions

15/11 2017

dev-master

9999999-dev https://github.com/amercier/php-cli-helpers

Utility classes to write PHP command-line scripts

  Sources   Download

MIT ISC

The Requires

  • php >=5.3

 

The Development Requires

helpers command command-line cli utility utilities line

15/11 2017

v1.4.5

1.4.5.0 https://github.com/amercier/php-cli-helpers

Utility classes to write PHP command-line scripts

  Sources   Download

ISC

The Requires

  • php >=5.3

 

The Development Requires

helpers command command-line cli utility utilities line

04/12 2015

dev-php7

dev-php7 https://github.com/amercier/php-cli-helpers

Utility classes to write PHP command-line scripts

  Sources   Download

MIT

The Requires

  • php >=5.3.2

 

The Development Requires

helpers command command-line cli utility utilities line

18/09 2014

v1.4.4

1.4.4.0 https://github.com/amercier/php-cli-helpers

Utility classes to write PHP command-line scripts

  Sources   Download

MIT

The Requires

  • php >=5.3.2

 

The Development Requires

helpers command command-line cli utility utilities line

13/09 2014

v1.4.3

1.4.3.0 https://github.com/amercier/php-cli-helpers

Utility classes to write PHP command-line scripts

  Sources   Download

MIT

The Requires

  • php >=5.3.2

 

The Development Requires

helpers command command-line cli utility utilities line

09/04 2014

v1.4.2

1.4.2.0 https://github.com/amercier/php-cli-helpers

Utility classes to write PHP command-line scripts

  Sources   Download

MIT

The Requires

  • php >=5.3.2

 

The Development Requires

helpers command command-line cli utility utilities line

31/03 2014

v1.4.1

1.4.1.0 https://github.com/amercier/php-cli-helpers

Utility classes to write PHP command-line scripts

  Sources   Download

MIT

The Development Requires

helpers command command-line cli utility utilities line

28/03 2014

v1.4.0

1.4.0.0 https://github.com/amercier/php-cli-helpers

Utility classes to write PHP command-line scripts

  Sources   Download

MIT

The Development Requires

helpers command command-line cli utility utilities line

29/11 2013

v1.3.0

1.3.0.0 https://github.com/amercier/php-cli-helpers

Utility classes to write PHP command-line scripts

  Sources   Download

MIT

The Development Requires

helpers command command-line cli utility utilities line

27/11 2013

v1.2.0

1.2.0.0 https://github.com/amercier/php-cli-helpers

Utility classes to write PHP command-line scripts

  Sources   Download

MIT

The Development Requires

helpers command command-line cli utility utilities line

09/08 2013

v1.1.0

1.1.0.0 https://github.com/amercier/php-cli-helpers

Utility classes to write PHP command-line scripts

  Sources   Download

MIT

The Development Requires

helpers command command-line cli utility utilities line

31/07 2013

1.0.0

1.0.0.0 https://github.com/amercier/php-cli-helpers

Utility classes to write PHP command-line scripts

  Sources   Download

MIT

The Development Requires

helpers command command-line cli utility utilities line