toro
| 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.
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.
Dependencies
Tornado >= version 3.0.
Examples
Here's a basic example (for more see the examples section of the docs):
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:
$ sphinx-build doc buildTesting
Run python setup.py test in the root directory.
Toro boasts 100% code coverage, including branch-coverage!