Personal fork of https://github.com/datafolklabs/cement

BJ Dierkes bab7f02fa5 Add Initial Support (disabled) for Travis OSX vor 8 Jahren
cement 8e2fb913a5 Fix PEP Issues vor 8 Jahren
doc a48b4d7d70 Bumping Version for dev/2.9.x vor 8 Jahren
examples 64ef916389 Resolves Issue #254 vor 8 Jahren
scripts bab7f02fa5 Add Initial Support (disabled) for Travis OSX vor 8 Jahren
tests a48b4d7d70 Bumping Version for dev/2.9.x vor 8 Jahren
.coveragerc a6684d259c Fix coverage issues with ext_daemon vor 10 Jahren
.gitignore 6160777ee7 Updating Git Ignore vor 9 Jahren
.pylintrc 6215478936 Pylint fixes. Part of Issue #132 vor 12 Jahren
.travis.yml bab7f02fa5 Add Initial Support (disabled) for Travis OSX vor 8 Jahren
CONTRIBUTORS 5e1f018015 Resolves Issue #259 vor 10 Jahren
ChangeLog 8e2fb913a5 Fix PEP Issues vor 8 Jahren
LICENSE e92baae668 Bump year to 2016 vor 8 Jahren
README.md a48b4d7d70 Bumping Version for dev/2.9.x vor 8 Jahren
Vagrantfile 589140a567 Adding Windows Server 2012 R2 to Vagrant vor 8 Jahren
requirements-dev-linux.txt 2019953562 Only Require PyInotify on Linux vor 9 Jahren
requirements-dev-py3-linux.txt 2019953562 Only Require PyInotify on Linux vor 9 Jahren
requirements-dev-py3.txt 8d43da80dd Resolves Issue #343 vor 8 Jahren
requirements-dev-windows.txt 4ed3be6a31 Adding Windows Bootstrap Helper vor 8 Jahren
requirements-dev.txt e6092d9f1e Resolves Issues #322 and #332 vor 9 Jahren
requirements.txt 13d15d68c5 Adding development requirements vor 12 Jahren
setup.cfg fe9e5beff9 Further Resolves Issue #297 vor 9 Jahren
setup.py bbf2e4e31e Resolves Issue #202 and #217 vor 10 Jahren

README.md

Cement Framework

NOTE: 2.9.x is the development version of Cement. Please use stable/2.8.x in production until stable/2.10.x is released.

Cement is an advanced CLI Application Framework for Python. Its goal is to introduce a standard, and feature-full platform for both simple and complex command line applications as well as support rapid development needs without sacrificing quality. Cement is flexible, and it's use cases span from the simplicity of a micro-framework to the complexity of a mega-framework. Whether it's a single file script, or a multi-tier application, Cement is the foundation you've been looking for.

The first commit to Git was on Dec 4, 2009. Since then, the framework has seen several iterations in design, and has continued to grow and improve since it's inception. Cement is the most stable, and complete framework for command line and backend application development.

Continuous Integration Status Gitter

Cement core features include (but are not limited to):

  • Core pieces of the framework are customizable via handlers/interfaces
  • Extension handler interface to easily extend framework functionality
  • Config handler supports parsing multiple config files into one config
  • Argument handler parses command line arguments and merges with config
  • Log handler supports console and file logging
  • Plugin handler provides an interface to easily extend your application
  • Hook support adds a bit of magic to apps and also ties into framework
  • Handler system connects implementation classes with Interfaces
  • Output handler interface renders return dictionaries to console
  • Cache handler interface adds caching support for improved performance
  • Controller handler supports sub-commands, and nested controllers
  • Zero external dependencies* (not including optional extensions)
  • 100% test coverage using nose
  • 100% PEP8 compliant using pep8 and autopep8 tools
  • Extensive Sphinx documentation
  • Tested on Python 2.6, 2.7, 3.2, 3.3, 3.4, and 3.5

Note that argparse is required as an external dependency for Python < 2.7 and < 3.2. Additionally, some optional extensions that are shipped with the mainline Cement sources do require external dependencies. It is the responsibility of the application developer to include these dependencies along with their application, as Cement explicitly does not include them.

More Information

License

The Cement CLI Application Framework is Open Source and is distributed under the BSD License (three clause). Please see the LICENSE file included with this software.