Metadata-Version: 1.1
Name: toro
Version: 0.8
Summary: Synchronization primitives for Tornado coroutines.
Home-page: http://github.com/ajdavis/toro/
Author: A. Jesse Jiryu Davis
Author-email: jesse@emptysquare.net
License: http://www.apache.org/licenses/LICENSE-2.0
Description: ====
        toro
        ====
        
        .. image:: https://raw.github.com/ajdavis/toro/master/doc/_static/toro.png
        
        :Info: Synchronization primitives for Tornado coroutines.
        :Author: A\. Jesse Jiryu Davis
        
        Documentation: http://toro.readthedocs.org/
        
        .. image:: https://travis-ci.org/ajdavis/toro.png
                :target: https://travis-ci.org/ajdavis/toro
        
        About
        =====
        A set of locking and synchronizing primitives analogous to those in Python's
        `threading module`_ or Gevent's `coros`_, for use with Tornado's `gen.engine`_.
        
        .. _threading module: http://docs.python.org/library/threading.html
        
        .. _coros: http://www.gevent.org/gevent.coros.html
        
        .. _gen.engine: http://www.tornadoweb.org/documentation/gen.html
        
        Dependencies
        ============
        Tornado_ >= version 3.0.
        
        .. _Tornado: http://www.tornadoweb.org/
        
        Examples
        ========
        Here's a basic example (for more see the *examples* section of the docs):
        
        .. code-block:: python
        
            from tornado import ioloop, gen
            import toro
        
            q = toro.JoinableQueue(maxsize=3)
        
            @gen.coroutine
            def consumer():
                while True:
                    item = yield q.get()
                    try:
                        print 'Doing work on', item
                    finally:
                        q.task_done()
        
            @gen.coroutine
            def producer():
                for item in range(10):
                    yield q.put(item)
        
            producer()
            consumer()
            loop = ioloop.IOLoop.instance()
            # block until all tasks are done
            q.join().add_done_callback(loop.stop)
            loop.start()
        
        Documentation
        =============
        
        You will need Sphinx_ and GraphViz_ installed to generate the
        documentation. Documentation can be generated like:
        
        .. code-block:: console
        
            $ sphinx-build doc build
        
        .. _Sphinx: http://sphinx.pocoo.org/
        
        .. _GraphViz: http://www.graphviz.org/
        
        Testing
        =======
        
        Run ``python setup.py test`` in the root directory.
        
        Toro boasts 100% code coverage, including branch-coverage!
        
Keywords: tornado coroutines semaphore mutex queue asynchronous
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Development Status :: 4 - Beta
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
