-

cool-RR · cool-RR · commit 59d7e745db4e · 2012-05-31T14:39:03.000+03:00
diff --git a/python_toolbox/cute_testing.py b/python_toolbox/cute_testing.py
@@ -3,8 +3,6 @@
 
 '''This module defines tools for testing.'''
 
-import re
-
 from python_toolbox.third_party import unittest2
 
 from python_toolbox import cute_inspect
diff --git a/python_toolbox/dict_tools.py b/python_toolbox/dict_tools.py
@@ -82,10 +82,12 @@ def reverse_with_set_values(d):
 
 
 def devour_items(d):
+    '''Iterator that pops (key, value) pairs from `d` until it's empty.'''
     while d:
         yield d.popitem()
 
         
 def devour(d):
+    '''Iterator that pops keys from `d` until it's exhaused (i.e. empty).'''
     while d:
         yield d.pop()
diff --git a/python_toolbox/function_anchoring_type.py b/python_toolbox/function_anchoring_type.py
@@ -11,8 +11,6 @@
 import types
 
 from python_toolbox import misc_tools
-from python_toolbox import import_tools
-from python_toolbox import address_tools
 
 
 class FunctionAnchoringType(type):
diff --git a/python_toolbox/gc_tools.py b/python_toolbox/gc_tools.py
@@ -1,19 +1,15 @@
 # Copyright 2009-2012 Ram Rachum.
 # This program is distributed under the LGPL2.1 license.
 
-'''
-This module defines the `` class.
-
-See its documentation for more information.
-'''
+'''Defines various tools for working with garbage-collection.'''
 
 import gc
 
 from python_toolbox import sys_tools
 
 def collect():
     if sys_tools.is_pypy:
-        for i in range(3):
+        for _ in range(3):
             gc.collect()
     else:
         gc.collect()
diff --git a/python_toolbox/import_tools.py b/python_toolbox/import_tools.py
@@ -7,7 +7,6 @@
 import os.path
 import imp
 import zipimport
-import zipfile
 
 from python_toolbox import package_finder
 from python_toolbox import caching
@@ -134,17 +133,8 @@ def exists(module_name, path=None):
             module_file.close()
         
 
-def _import_by_path_from_zip(path, name=None):
-    '''
-    Import module/package by path. blocktododoc, psudopath inside zip? no file
-    extensions?
-    
-    You may specify a name: This is helpful only if it's an hierarchical name,
-    i.e. a name with dots like "orange.claw.hammer". This will become the
-    imported module's __name__ attribute. Otherwise only the short name,
-    "hammer", will be used, which might cause problems in some cases. (Like
-    when using multiprocessing.)
-    '''
+def _import_by_path_from_zip(path):
+    '''Import a module from a path inside a zip file.'''
     assert '.zip' in path
     
     parent_path, child_name = path.rsplit(os.path.sep, 1)
diff --git a/python_toolbox/infinity.py b/python_toolbox/infinity.py
@@ -15,6 +15,7 @@
 
 
 def is_floatable(x):
+    '''Can `x` be made into a `float`?'''
     try:
         float(x)
         return True
@@ -23,6 +24,7 @@ def is_floatable(x):
 
     
 def is_nonfractional(x):
+    '''Is `x` a whole number?'''
     try:
         int(x)
         return int(x) == x
@@ -89,7 +91,7 @@ def __div__(self, other):
             raise InfinityRaceError
         elif is_floatable(other):
             s = math_tools.sign(other)
-            if s==0:
+            if s == 0:
                 raise InfinityRaceError
             else:
                 return Infinity(direction=self.direction * s)
@@ -102,7 +104,7 @@ def __mul__(self, other):
             return Infinity(self.direction * other.direction)
         elif is_floatable(other):
             s = math_tools.sign(other)
-            if s==0:
+            if s == 0:
                 raise InfinityRaceError
             else:
                 return Infinity(direction=self.direction * s)
@@ -121,19 +123,19 @@ def __pow__(self, other):
             raise object # todo
         elif is_floatable(other):
             s = math_tools.sign(other)
-            if s==0:
+            if s == 0:
                 raise InfinityRaceError
             else:
-                if self.direction==1:
-                    if s==1:
+                if self.direction == 1:
+                    if s == 1:
                         return self
-                    if s==-1:
+                    if s == -1:
                         return 0
                 else: #self.direction == -1
                     if is_nonfractional(other):
-                        if s==-1:
+                        if s == -1:
                             return 0
-                        if s==1:
+                        if s == 1:
                             if s % 2 == 0:                                
                                 return Infinity()
                             else:                    
@@ -194,10 +196,10 @@ def __neq__(self, other):
         return not self.__eq__(other)
     
     def __repr__(self):
-        if self.direction==1:
-            suffix=''
+        if self.direction == 1:
+            suffix = ''
         else: # self.direction == -1
-            suffix='-'
+            suffix = '-'
         return suffix + 'infinity'
         
 
diff --git a/python_toolbox/misc_tools/name_mangling.py b/python_toolbox/misc_tools/name_mangling.py
@@ -1,11 +1,7 @@
 # Copyright 2009-2012 Ram Rachum.
 # This program is distributed under the LGPL2.1 license.
 
-'''
-This module defines the `` class.
-
-See its documentation for more information.
-'''
+'''Defines tools for name-mangling.'''
 
 from python_toolbox import string_tools
 
diff --git a/python_toolbox/module_tasting/tasted_resources.py b/python_toolbox/module_tasting/tasted_resources.py
@@ -1,11 +1,7 @@
 # Copyright 2009-2012 Ram Rachum.
 # This program is distributed under the LGPL2.1 license.
 
-'''
-This module defines the `` class.
-
-See its documentation for more information.
-'''
+'''Defines `pkg_resources`-like tools for tasted modules.'''
 
 import types
 import sys
diff --git a/python_toolbox/wx_tools/drawing_tools/__init__.py b/python_toolbox/wx_tools/drawing_tools/__init__.py
@@ -1,10 +1,6 @@
 # Copyright 2009-2012 Ram Rachum.
 # This program is distributed under the LGPL2.1 license.
 
-'''
-This module defines the `` class.
-
-See its documentation for more information.
-'''
+'''Defines tools for drawing with wxPython.'''
 
 from . import pens
