circuits is a Lightweight Event driven and Asynchronous Application Framework for the Python Programming Language with a strong Component Architecture.
circuits also includes a lightweight, high performance and scalable HTTP/WSGI web server as well as various I/O and Networking components.
To take full advantage of circuits and its architecture, circuits requires that your application be designed in terms of components and their interactions (events) with each other. An application written using the circuits application framework is maintainable, scalable and easy to develop.
The circuits framework has a certain elegance making it a rather attracting feature. New features are built into the framework with this in mind and circuits “eats its own dog food” by having a feature-rich library of components built atop the core components.
Documentation: http://packages.python.org/circuits
Project website: https://bitbucket.org/prologic/circuits/
PyPI page: http://pypi.python.org/pypi/circuits
circuits has no dependencies beyond the Python Standard Library.
Some dependencies should be optionally installed if deployed on a Python-2.5 environment such as processing for multiprocessing concurrency support and for JSON support the simplejson package.
The simplest and recommended way to install circuits is with pip. You may install the latest stable release from PyPI with pip:
> pip install circuits
If you do not have pip, you may use easy_install:
> easy_install circuits
Alternatively, you may download the source package from the circuits Page on PyPI or the circuits Downloads page on the circuits Website; extract it and install using:
> python setup.py install
circuits is licensed under the MIT License.
I welcome any questions or feedback about bugs and suggestions on how to improve circuits. Let me know what you think about circuits. I am on twitter @therealprologic.
Do you have suggestions for improvement? Then please Create an Issue with details of what you would like to see. I’ll take a look at it and work with you to either incorporate the idea or find a better solution.
There is also a small community of circuits enthusiasts that you may find on the circuits IRC Channel and the circuits Mailing List.
This is the third attempt at getting Python 3 support for circuits working while still maintaining Python 2 compatibility. This release finally adds full support for Python 3 as well as maintaining compatibility with Python 2.6 and 2.7 with the same code-base.
Note
Python 2.5 support has been dropped as of this release and will no longer be supported in future. There may be a maintenance branch specifically for Python 2.5 if required.
circuits now includes two new primitives which work by integrating greenlet.
Note
These new primitives add (as long as greenlet is installed) the ability to write semi-synchronous code in your event handlers while still taking full advantage of the asynchronous and component framework that circuits has to offer.
circuits now has 80% test coverage on all supported versions of Python including Python 2.6, Python 2.7 and Python 3.2