Merge pull request #426 from Locker537/cli_fixes

Minor improvements to 'Command Line Applications' docs
This commit is contained in:
Ian Cordasco
2014-05-12 11:36:02 -05:00
+9 -9
View File
@@ -1,35 +1,35 @@
Command Line Applications Command-line Applications
========================= =========================
.. todo:: Explain "Command Line Applications" .. todo:: Explain "Command-line Applications"
Clint Clint
----- -----
`clint <https://pypi.python.org/pypi/clint/>`_ is a python module which is `clint <https://pypi.python.org/pypi/clint/>`_ is a python module which is
filled with very useful tools for developing commandline applications. filled with very useful tools for developing command-line applications.
It supports features such as; CLI Colors and Indents, Simple and Powerful It supports features such as; CLI Colors and Indents, Simple and Powerful
Column Printer, Iterator based progress bar and Implicit argument handling. Column Printer, Iterator based progress bar and Implicit argument handling.
Click Click
----- -----
`click <http://click.pocoo.org/>`_ is an upcoming Python package for creating command `click <http://click.pocoo.org/>`_ is an upcoming Python package for creating
line interfaces in a composable way with as little amount of code as command-line interfaces in a composable way with as little amount of code as
necessary. Its the “Command Line Interface Creation Kit”. Its highly necessary. Its the “Command-line Interface Creation Kit”. Its highly
configurable but comes with good defaults out of the box. configurable but comes with good defaults out of the box.
docopt docopt
------ ------
`docopt <http://docopt.org/>`_ is a lightweight, highly Pythonic package that `docopt <http://docopt.org/>`_ is a lightweight, highly Pythonic package that
allows creating command line interfaces easily and intuitively, by parsing allows creating command-line interfaces easily and intuitively, by parsing
POSIX-style usage instructions. POSIX-style usage instructions.
Plac Plac
------ ------
`Plac <https://pypi.python.org/pypi/plac>`_ is a python module that allows developing command line applications. In fact `Plac <https://pypi.python.org/pypi/plac>`_ is a python module that allows developing command-line applications. In fact
plac is a simple wrapper over the python standard library `argparse <http://docs.python.org/2/library/argparse.html>`_, it hides most of its plac is a simple wrapper over the python standard library `argparse <http://docs.python.org/2/library/argparse.html>`_, it hides most of its
complexity by using a declarative interface: the argument parser is inferred complexity by using a declarative interface: the argument parser is inferred
rather than written down by imperatively. It is targetting especially unsophisticated rather than written down by imperatively. It is targetting especially unsophisticated
@@ -40,7 +40,7 @@ and simple.
Cliff Cliff
------ ------
`Cliff <https://cliff.readthedocs.org/en/latest>`_ is a framework for building command line programs. `Cliff <https://cliff.readthedocs.org/en/latest>`_ is a framework for building command-line programs.
It uses setuptools entry points to provide subcommands, output formatters, and other extensions. The framework It uses setuptools entry points to provide subcommands, output formatters, and other extensions. The framework
is meant to be used to create multi-level commands such as subversion and git, where the main program handles is meant to be used to create multi-level commands such as subversion and git, where the main program handles
some basic argument parsing and then invokes a sub-command to do the work. some basic argument parsing and then invokes a sub-command to do the work.