renamed uid to randomname

git-svn-id: svn://svn.cy55.de/Zope3/src/cybertools/trunk@1888 fd906abe-77d9-0310-91a1-e0d9ade77398

util/randomname.py

@@ -28,8 +28,8 @@ import random
 bits = 128
 
 
-def generateUid(check=None, lowerCaseOnly=False, bits=bits, seed=None, base=62):
+def generateName(check=None, lowerCaseOnly=False, bits=bits, seed=None, base=62):
-    """ Generates a unique ID.
+    """ Generates an unguessable random name.
     """
     if base > 64:
         raise ValueError('The base argument may not exceed 64, but is %i.' % base)

util/randomname.txt

@@ -0,0 +1,34 @@
+=========================================================
+Generate Random Names Suitable as Unguessable Identifiers
+=========================================================
+
+$Id$
+
+  >>> from cybertools.util.randomname import generateName
+
+  >>> generateName(seed=42)
+  '5MdsLTYmogAeWfbrLDBY8l'
+
+  >>> generateName(seed=42)
+  '5MdsLTYmogAeWfbrLDBY8l'
+
+  >>> def checkIt(id):
+  ...     return id != '5MdsLTYmogAeWfbrLDBY8l'
+
+  >>> generateName(check=checkIt, seed=42)
+  '15pahuNd5rxoekvZSMGAl1'
+
+  >>> generateName(lowerCaseOnly=True, seed=42)
+  'b8lhps8li07acdu7i0w01b0rh'
+
+  >>> generateName()
+  '...'
+
+  >>> generateName(base=64, seed=42)
+  '2ZRA3X1CsqQhO0cn-zInCt'
+
+  >>> generateName(base=99, seed=42)
+  Traceback (most recent call last):
+  ...
+  ValueError: The base argument may not exceed 64, but is 99.
+

util/tests.py

@@ -22,7 +22,7 @@ def test_suite():
         doctest.DocFileSuite('defer.txt', optionflags=flags),
         doctest.DocFileSuite('property.txt', optionflags=flags),
         doctest.DocFileSuite('jeep.txt', optionflags=flags),
-        doctest.DocFileSuite('uid.txt', optionflags=flags),
+        doctest.DocFileSuite('randomname.txt', optionflags=flags),
         ))
 
 if __name__ == '__main__':

util/uid.txt

@@ -1,34 +0,0 @@
-===========================
-Generate Unique Identifiers
-===========================
-
-$Id$
-
-  >>> from cybertools.util.uid import generateUid
-
-  >>> generateUid(seed=42)
-  '5MdsLTYmogAeWfbrLDBY8l'
-
-  >>> generateUid(seed=42)
-  '5MdsLTYmogAeWfbrLDBY8l'
-
-  >>> def checkIt(id):
-  ...     return id != '5MdsLTYmogAeWfbrLDBY8l'
-
-  >>> generateUid(check=checkIt, seed=42)
-  '15pahuNd5rxoekvZSMGAl1'
-
-  >>> generateUid(lowerCaseOnly=True, seed=42)
-  'b8lhps8li07acdu7i0w01b0rh'
-
-  >>> generateUid()
-  '...'
-
-  >>> generateUid(base=64, seed=42)
-  '2ZRA3X1CsqQhO0cn-zInCt'
-
-  >>> generateUid(base=99, seed=42)
-  Traceback (most recent call last):
-  ...
-  ValueError: The base argument may not exceed 64, but is 99.
-