wp-cli/php-cli-tools

Console utilities for PHP

PHP Command Line Tools

A collection of functions and classes to assist with command line development., _(*1)

Requirements, _(*2)

• PHP >= 5.6

Suggested PHP extensions, _(*3)

• mbstring - Used for calculating string widths.

Function List

• cli\out($msg, ...)
• cli\out_padded($msg, ...)
• cli\err($msg, ...)
• cli\line($msg = '', ...)
• cli\input()
• cli\prompt($question, $default = false, $marker = ':')
• cli\choose($question, $choices = 'yn', $default = 'n')
• cli\menu($items, $default = false, $title = 'Choose an Item')

Progress Indicators

• cli\notify\Dots($msg, $dots = 3, $interval = 100)
• cli\notify\Spinner($msg, $interval = 100)
• cli\progress\Bar($msg, $total, $interval = 100)

Tabular Display

• cli\Table::__construct(array $headers = null, array $rows = null)
• cli\Table::setHeaders(array $headers)
• cli\Table::setRows(array $rows)
• cli\Table::setRenderer(cli\table\Renderer $renderer)
• cli\Table::addRow(array $row)
• cli\Table::sort($column)
• cli\Table::display()

The display function will detect if output is piped and, if it is, render a tab delimited table instead of the ASCII table rendered for visual display., _(*4)

You can also explicitly set the renderer used by calling cli\Table::setRenderer() and giving it an instance of one of the concrete cli\table\Renderer classes., _(*5)

Tree Display

• cli\Tree::__construct()
• cli\Tree::setData(array $data)
• cli\Tree::setRenderer(cli\tree\Renderer $renderer)
• cli\Tree::render()
• cli\Tree::display()

Argument Parser

Argument parsing uses a simple framework for taking a list of command line arguments, usually straight from $_SERVER['argv'], and parses the input against a set of defined rules., _(*6)

Check examples/arguments.php for an example., _(*7)

Usage

See examples/ directory for examples., _(*8)

Todo

• Expand this README
• Add doc blocks to rest of code