draft of coroutine examples

control/coroaverager1.py

@@ -0,0 +1,29 @@
+# BEGIN DECORATED_AVERAGER
+"""
+A coroutine to compute a running average
+
+    >>> coro_avg = averager()  # <1>
+    >>> from inspect import getgeneratorstate
+    >>> getgeneratorstate(coro_avg)  # <2>
+    'GEN_SUSPENDED'
+    >>> coro_avg.send(10)  # <3>
+    10.0
+    >>> coro_avg.send(30)
+    20.0
+    >>> coro_avg.send(5)
+    15.0
+
+"""
+
+from coroutil import coroutine  # <4>
+
+@coroutine  # <5>
+def averager():  # <6>
+    total = average = 0.0
+    count = 0
+    while True:
+        term = yield average
+        total += term
+        count += 1
+        average = total/count
+# END DECORATED_AVERAGER