-

cool-RR · cool-RR · commit 4456199ccd01 · 2014-10-19T21:41:17.000+03:00
diff --git a/source_py3/python_toolbox/combi/chain_space.py b/source_py3/python_toolbox/combi/chain_space.py
@@ -22,12 +22,12 @@ class ChainSpace(sequence_tools.CuteSequenceMixin, collections.Sequence):
     index number rather than just iteration.
     '''
     def __init__(self, sequences):
-        
         self.sequences = nifty_collections.LazyTuple(
             (sequence_tools.ensure_iterable_is_immutable_sequence(
                 sequence, default_type=nifty_collections.LazyTuple)
                                                      for sequence in sequences)
         )
+        
     @caching.CachedProperty
     @nifty_collections.LazyTuple.factory()
     def accumulated_lengths(self):
@@ -46,7 +46,6 @@ def accumulated_lengths(self):
         
     length = caching.CachedProperty(lambda self: self.accumulated_lengths[-1])
         
-        
     def __repr__(self):
         return '<%s: %s>' % (
             type(self).__name__,
@@ -87,6 +86,7 @@ def __contains__(self, item):
                    if (not isinstance(sequence, str) or isinstance(item, str)))
         
     def index(self, item):
+        '''Get the index number of `item` in this space.'''
         for sequence, accumulated_length in zip(self.sequences,
                                                 self.accumulated_lengths):
             try:
@@ -105,6 +105,4 @@ def __bool__(self):
         try: next(iter(self))
         except StopIteration: return False
         else: return True
-        
-
 
diff --git a/source_py3/python_toolbox/combi/map_space.py b/source_py3/python_toolbox/combi/map_space.py
@@ -12,6 +12,13 @@
 
         
 class MapSpace(sequence_tools.CuteSequenceMixin, collections.Sequence):
+    '''
+    A space of a function applied to a sequence.
+    
+    This is similar to Python's builtin `map`, except that it behaves like a
+    sequence rather than an iterable. (Though it's also iterable.) You can
+    access any item by its index number.
+    '''    
     def __init__(self, function, sequence):
         
         self.function = function
