-

cool-RR · cool-RR · commit afd1b6bfb827 · 2014-10-04T17:54:31.000+03:00
diff --git a/source_py3/python_toolbox/combi/perming/_variation_removing_mixin.py b/source_py3/python_toolbox/combi/perming/_variation_removing_mixin.py
@@ -156,7 +156,6 @@ def _get_just_fixed(self):
       
     _nominal_perm_space_of_perms = caching.CachedProperty(
         lambda self: self.unsliced.undegreed.unfixed, 
-        doc='''blocktododoc'''
     )
         
     
diff --git a/source_py3/python_toolbox/math_tools/sequences.py b/source_py3/python_toolbox/math_tools/sequences.py
@@ -12,7 +12,16 @@
 _n_highest_cache_completed = -1
 def stirling(n, k, skip_calculation=False):
     '''
-    blocktododoc specify first kind
+    Calculate Stirling number of the second kind of `n` and `k`.
+    
+    More information about these numbers:
+    https://en.wikipedia.org/wiki/Stirling_numbers_of_the_second_kind
+    
+    Example:
+    
+        >>> stirling(3, 2)
+        -3
+    
     '''
     global _n_highest_cache_completed
     if k not in range(n + 1):
@@ -54,5 +63,17 @@ def stirling(n, k, skip_calculation=False):
 
 
 def abs_stirling(n, k):
+    '''
+    Calculate Stirling number of the first kind of `n` and `k`.
+    
+    More information about these numbers:
+    https://en.wikipedia.org/wiki/Stirling_numbers_of_the_first_kind
+    
+    Example:
+    
+        >>> abs_stirling(3, 2)
+        3
+    
+    '''
     return abs(stirling(n, k))
     
diff --git a/source_py3/python_toolbox/nifty_collections/frozen_tally_and_frozen_ordered_tally.py b/source_py3/python_toolbox/nifty_collections/frozen_tally_and_frozen_ordered_tally.py
@@ -198,9 +198,16 @@ def __and__(self, other):
 
     __bool__ = lambda self: any(True for element in self.elements())
     
-    n_elements = property( # blocktodo: want to make this cached but import loop
-        lambda self: sum(self.values())
-    )
+    
+    _n_elements = None
+    @property
+    def n_elements(self):
+        # Implemented as a poor man's `CachedProperty` because we can't use the
+        # real `CachedProperty` due to circular import.
+        if self._n_elements is None:
+            self._n_elements = sum(self.values())
+        return self._n_elements
+        
     
     # We define all the comparison methods manually instead of using
     # `total_ordering` because `total_ordering` assumes that >= means (> and

Original file line number	Diff line number	Diff line change
`@@ -156,7 +156,6 @@ def _get_just_fixed(self):`
`156`	`156`
`157`	`157`	`_nominal_perm_space_of_perms = caching.CachedProperty(`
`158`	`158`	`lambda self: self.unsliced.undegreed.unfixed,`
`159`		`- doc='''blocktododoc'''`
`160`	`159`	`)`
`161`	`160`
`162`	`161`