flyingcircus 0.0.0.0

Everything you always wanted to have in Python.*

============
FlyingCircus
============

**FlyingCircus** - Everything you always wanted to have in Python.*

(*But were afraid to write)

.. code::
_____ _ _ ____ _
| ___| |_ _(_)_ __ __ _ / ___(_)_ __ ___ _ _ ___
| |_ | | | | | | '_ \ / _` | | | | '__/ __| | | / __|
| _| | | |_| | | | | | (_| | |___| | | | (__| |_| \__ \
|_| |_|\__, |_|_| |_|\__, |\____|_|_| \___|\__,_|___/
|___/ |___/

Overview
--------
This software provides a library of miscellaneous utilities for Python.
It is relatively easy to extend and users are encouraged to tweak with it.

Most of the code is used is used in a number of projects

As a result of the code maturity, some of the library components may undergo
(eventually heavy) refactoring, although this is currently unexpected.


Releases information are available through ``NEWS.rst``.

For a more comprehensive list of changes see ``CHANGELOG.rst``.


Installation
------------
The recommended way of installing the software is through
`PyPI <https://pypi.python.org/pypi/flyingcircus>`_:

.. code:: shell

$ pip install flyingcircus

Alternatively, you can clone the source repository from
`Bitbucket <https://bitbucket.org/norok2/flyingcircus>`_:

.. code:: shell

$ git clone [e-mail]:norok2/flyingcircus.git
$ cd flyingcircus
$ pip install -e .

For more details see also ``INSTALL.rst``.

License
-------
This work is licensed through the terms and conditions of the
`GPLv3+ <http://www.gnu.org/licenses/gpl-3.0.html>`_
See the accompanying ``LICENSE.rst`` for more details.


Acknowledgements
----------------
For a complete list of authors please see ``AUTHORS.rst``.

People who have influenced this work are acknowledged in ``THANKS.rst``.