more documentage

bonobo/examples/datasets/coffeeshops.py

@@ -1,3 +1,18 @@
+"""
+Extracts a list of parisian bars where you can buy a coffee for a reasonable price, and store them in a flat text file.
+
+.. graphviz::
+
+    digraph {
+        rankdir = LR;
+        stylesheet = "../_static/graphs.css";
+
+        BEGIN [shape="point"];
+        BEGIN -> "ODS()" -> "transform" -> "FileWriter()";
+    }
+
+"""
+
 import bonobo
 from bonobo.commands.run import get_default_services
 from bonobo.ext.opendatasoft import OpenDataSoftAPI

bonobo/examples/datasets/fablabs.py

@@ -1,3 +1,19 @@
+"""
+Extracts a list of fablabs in the world, restrict to the ones in france, then format it both for a nice console output
+and a flat txt file.
+
+.. graphviz::
+
+    digraph {
+        rankdir = LR;
+        stylesheet = "../_static/graphs.css";
+
+        BEGIN [shape="point"];
+        BEGIN -> "ODS()" -> "normalize" -> "filter_france" -> "Tee()" -> "JsonWriter()";
+    }
+
+"""
+
 import json
 
 from colorama import Fore, Style

bonobo/examples/utils/count.py

@@ -1,7 +1,21 @@
-import bonobo
-import bonobo.basics
+"""
+Simple example of :func:`bonobo.count` usage.
 
-graph = bonobo.Graph(range(42), bonobo.basics.count, print)
+.. graphviz::
+
+    digraph {
+        rankdir = LR;
+        stylesheet = "../_static/graphs.css";
+
+        BEGIN [shape="point"];
+        BEGIN -> "range()" -> "count" -> "print";
+    }
+
+"""
+
+import bonobo
+
+graph = bonobo.Graph(range(42), bonobo.count, print)
 
 if __name__ == '__main__':
     bonobo.run(graph)