-

cool-RR · cool-RR · commit a3a238d49b21 · 2014-11-14T22:23:55.000+02:00
diff --git a/source_py3/python_toolbox/combi/chain_space.py b/source_py3/python_toolbox/combi/chain_space.py
@@ -20,6 +20,19 @@ class ChainSpace(sequence_tools.CuteSequenceMixin, collections.Sequence):
     
     This is similar to `itertools.chain`, except that items can be fetched by
     index number rather than just iteration.
+    
+    Example:
+    
+        >>> chain_space = ChainSpace(('abc', (1, 2, 3)))
+        >>> chain_space
+        <ChainSpace: 3+3>
+        >>> chain_space[4]
+        2
+        >>> tuple(chain_space)
+        ('a', 'b', 'c', 1, 2, 3)
+        >>> chain_space.index(2)
+        4
+    
     '''
     def __init__(self, sequences):
         self.sequences = nifty_collections.LazyTuple(
