summaryrefslogtreecommitdiff
path: root/libraries/toro/README
diff options
context:
space:
mode:
Diffstat (limited to 'libraries/toro/README')
-rw-r--r--libraries/toro/README12
1 files changed, 12 insertions, 0 deletions
diff --git a/libraries/toro/README b/libraries/toro/README
new file mode 100644
index 0000000000..30171098ec
--- /dev/null
+++ b/libraries/toro/README
@@ -0,0 +1,12 @@
+With Tornado’s gen module, you can turn Python generators into full-featured
+coroutines, but coordination among these coroutines is difficult without
+mutexes, semaphores, and queues.
+
+Toro provides to Tornado coroutines a set of locking primitives and queues
+analogous to those that Gevent provides to Greenlets, or that the standard
+library provides to threads.
+
+(Note that these primitives and queues are not actually thread-safe and
+cannot be used in place of those from the standard library–they are meant to
+coordinate Tornado coroutines in single-threaded apps, not to protect shared
+objects in multithreaded apps.)