Skip to main content

Framework for building command-line tools

Project description

Build Status

Introduction

yaclifw is a framework for building CLI tools.

Dependencies

Direct dependencies of yaclifw are:

Installation

To install yaclifw, run:

$ python setup.py install

or using pip, run:

$ pip install yaclifw

To upgrade your pip installation, run:

$ pip install -U yaclifw

Usage

The list of available commands can be listed with:

$ yaclifw -h

For each subcommand, additional help can be queried, e.g.:

$ yaclifw example -h

Extending yaclifw

The easiest way to make use of yaclifw is by cloning the repository and modifying the main.py method to include your own commands.

Contributing

yaclifw follows PEP 8, the Style Guide for Python Code. Please check your code with pep8 or flake8, the Python style guide checkers, by running flake8 -v . or pep8 -v ..

Running tests

The tests are located under the test directory. To run all the tests, use the test target of setup.py:

python setup.py test

Unit tests

Unit tests are stored under the test/unit folder and can be run by calling:

python setup.py test -s test/unit

Unit tests are also run by the Travis build on every Pull Request opened against the main repository.

License

yaclifw is released under the GPL.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page