toro

by ajdavis

ajdavis / toro

Synchronization primitives for Tornado coroutines

197 Stars 11 Forks Last release: Not found Other 202 Commits 9 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

====

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: https://toro.readthedocs.io/

.. important:: Toro is completed and deprecated; its features have been merged into Tornado. Development of locks and queues for Tornado coroutines continues in Tornado itself.

.. 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!

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.