openstack
/
cliff
Code Issues Proposed changes
Command Line Interface Formulation Framework
67 Commits 10 Branches 115 Tags 5.5 MiB
Python 99.6%
Shell 0.4%
Go to file
Doug Hellmann b8f3ad548d handle an empty data set 2012-04-27 19:23:26 -04:00
cliff handle an empty data set 2012-04-27 19:23:26 -04:00
demoapp remove example that I was using as a syntax reminder 2012-04-25 17:01:35 -04:00
docs fix version # in doc build script 2012-04-26 16:42:12 -04:00
tests save commands using the name representation to be used in help output; don't modify the input arg list when searching for the command; return the name of the command found so the app can stuff it into the help text of the command 2012-04-20 16:49:47 -07:00
.gitignore use logging for controlling console output verbosity 2012-04-21 08:01:57 -07:00
LICENSE change to apache license 2012-04-20 10:06:58 -07:00
MANIFEST.in add demoapp to release package and clean up files being distributed from the test directory 2012-04-22 16:55:39 -07:00
Makefile add Makefile with some common release operations 2012-04-25 17:14:06 -04:00
README.rst advice from the distutils list was to stick with distribute for now 2012-04-25 17:15:28 -04:00
announce.rst 0.2 release announcement post 2012-04-26 16:39:23 -04:00
distribute_setup.py add distribute_setup.py so install works 2012-04-20 09:55:11 -07:00
setup.py bump version number 2012-04-26 16:33:24 -04:00
tox.ini install nose for tox tests 2012-04-20 22:27:29 -07:00

README.rst

cliff -- Command Line Interface Formulation Framework

cliff is a framework for building command line programs. It uses setuptools entry points to provide subcommands, output formatters, and other extensions.

Documentation

Documentation for cliff is hosted on readthedocs.org at http://readthedocs.org/docs/cliff/en/latest/

To do

  • Should commands have an explicit API for checking whether the user can invoke them?
  • example show app
  • change API for list app to expect a sequence of dictionaries?
  • unicode output for python 2 (incompatible with csv?)
  • json formatter(s)
  • pprint formatter(s)
  • pretty but non-table formatter(s)
  • shell script formatter(s)? (properties as variable names)
  • create a few example commands that use a sqlite database to show how to manage transactions
  • switch setup/teardown functions in app to use some sort of context manager?