Code conforms now with Python PEP 484 -- Type Hints

This is a minor release.

Author: schmouk

PyRandLib/baselcg.py

@@ -79,7 +79,7 @@ class BaseLCG( BaseRandom ):
     """
 
     #=========================================================================
-    def __init__(self, _seedState=None):
+    def __init__(self, _seedState: int = None) -> None:
         """
         Constructor.  Should inSeed be None or not an integer  then
         the local time is used (with its shuffled value) as a seed.
@@ -88,7 +88,7 @@ def __init__(self, _seedState=None):
 
 
     #=========================================================================
-    def random(self):
+    def random(self) -> float:
         """
         This is the core of the pseudo-random generator.
         Returned values are within [0.0, 1.0).
@@ -99,7 +99,7 @@ def random(self):
 
 
     #=========================================================================
-    def getstate(self):
+    def getstate(self) -> int:
         """
         Returns an object capturing the current internal state of the generator.
         This object can be passed to setstate() to restore the state.
@@ -111,7 +111,7 @@ def getstate(self):
 
 
     #=========================================================================
-    def setstate(self, _state):
+    def setstate(self, _state: int) -> None:
         """
         _state should have been obtained from a previous call to getstate(),
         and  setstate() restores the internal state of the generator to what

PyRandLib/baselfib64.py

@@ -93,7 +93,7 @@ class BaseLFib64( BaseRandom ):
     """
 
     #=========================================================================
-    def __init__(self, _seedState=None):
+    def __init__(self, _seedState: tuple = None) -> None:
         """
         Constructor.
         _seedState is either a valid state, an integer,  a float or None.
@@ -113,7 +113,7 @@ def __init__(self, _seedState=None):
 
 
     #=========================================================================
-    def random(self):
+    def random(self) -> float:
         """
         This is the core of the pseudo-random generator.
         Returned values are within [0.0, 1.0).
@@ -124,7 +124,7 @@ def random(self):
 
 
     #=========================================================================
-    def getstate(self):
+    def getstate(self) -> tuple:
         """
         Return an object capturing the current internal state of the  generator.
         This  object  can be passed to setstate() to restore the state.  It is a
@@ -135,7 +135,7 @@ def getstate(self):
 
 
     #=========================================================================
-    def setstate(self, _seedState):
+    def setstate(self, _seedState: tuple) -> None:
         """
         _seedState should have been obtained from a previous call  to 
         getstate(), and setstate() restores the internal state of the 
@@ -163,7 +163,7 @@ def setstate(self, _seedState):
 
 
     #=========================================================================
-    def _initIndex(self, _index):
+    def _initIndex(self, _index: int) -> None:
         """
         Inits the internal index pointing to the internal list.
         """
@@ -174,7 +174,7 @@ def _initIndex(self, _index):
 
 
     #=========================================================================
-    def _initList(self, _initialSeed=None):
+    def _initList(self, _initialSeed: list = None) -> None:
         """
         Inits the internal list of values according to some initial
         seed  that  has  to be an integer or a float ranging within

PyRandLib/basemrg.py

@@ -90,7 +90,7 @@ class BaseMRG( BaseRandom ):
     """
 
     #=========================================================================
-    def __init__(self, _seedState=None):
+    def __init__(self, _seedState: (int,float,list) = None) -> None:
         """
         Constructor.
         _seedState is either a valid state, an integer, a float or None.
@@ -110,7 +110,7 @@ def __init__(self, _seedState=None):
 
 
     #=========================================================================
-    def random(self):
+    def random(self) -> float:
         """
         This is the core of the pseudo-random generator.
         Returned values are within [0.0, 1.0).
@@ -121,7 +121,7 @@ def random(self):
 
 
     #=========================================================================
-    def getstate(self):
+    def getstate(self) -> tuple:
         """
         Return an object capturing the current internal state of the  generator.
         This  object  can be passed to setstate() to restore the state.  It is a
@@ -132,7 +132,7 @@ def getstate(self):
 
 
     #=========================================================================
-    def setstate(self, _seedState):
+    def setstate(self, _seedState: tuple) -> None:
         """
         _seedState should have been obtained from a previous call  to 
         getstate(), and setstate() restores the internal state of the 
@@ -160,7 +160,7 @@ def setstate(self, _seedState):
 
 
     #=========================================================================
-    def _initIndex(self, _index):
+    def _initIndex(self, _index: int) -> None:
         """
         Inits the internal index pointing to the internal list.
         """
@@ -171,7 +171,7 @@ def _initIndex(self, _index):
 
 
     #=========================================================================
-    def _initList(self, _initialSeed=None):
+    def _initList(self, _initialSeed: list = None) -> None:
         """
         Inits the internal list of values according to some initial
         seed  that  has  to be an integer or a float ranging within

PyRandLib/baserandom.py

@@ -213,7 +213,7 @@ class BaseRandom( Random ):
     """
 
     #=========================================================================
-    def __init__(self, _seed=None):
+    def __init__(self, _seed: (int,float,list) = None) -> None:
         """
         Constructor. Should _seed be None or not an integer then the 
         local time is used (with its shuffled value) as a seed.
@@ -222,7 +222,7 @@ def __init__(self, _seed=None):
 
 
     #=========================================================================
-    def seed(self, _seed=None):
+    def seed(self, _seed: (int,float,list) = None) -> None:
         """
         Initiates the internal state of this pseudo-random generator.
         """
@@ -233,7 +233,7 @@ def seed(self, _seed=None):
 
 
     #=========================================================================
-    def __call__(self, _max=1.0):
+    def __call__(self, _max: (int,float) = 1.0) -> float:
         """
         This class's instances are callable. The returned value is uniformly
         contained within the interval [0.0 : _max].

PyRandLib/fastrand32.py

@@ -92,16 +92,16 @@ class FastRand32( BaseLCG ):
     """
 
     #=========================================================================
-    def __init__(self, _seed=None):
+    def __init__(self, _seed: (int,float) = None) -> None:
         """
-        Constructor.  Should _seed be None or not an integer  then
+        Constructor.  Should _seed be None or not  a  numeric  then
         the local time is used (with its shuffled value) as a seed.
         """
         super().__init__( _seed ) # this call creates attribute self._value and sets it
 
 
     #=========================================================================
-    def random(self):
+    def random(self) -> float:
         """
         This is the core of the pseudo-random generator.
         Returned values are within [0.0, 1.0).
@@ -111,7 +111,7 @@ def random(self):
 
 
     #=========================================================================
-    def setstate(self, _state):
+    def setstate(self, _state: (int,float)) -> None:
         """
         _state should have been obtained from a previous call to getstate(),
         and  setstate() restores the internal state of the generator to what

PyRandLib/fastrand63.py

@@ -92,7 +92,7 @@ class FastRand63( BaseLCG ):
     """
 
     #=========================================================================
-    def random(self):
+    def random(self) -> float:
         """
         This is the core of the pseudo-random generator.
         Returned values are within [0.0, 1.0).
@@ -102,7 +102,7 @@ def random(self):
 
 
     #=========================================================================
-    def setstate(self, _state):
+    def setstate(self, _state:(int,float)) -> None:
         """
         _state should have been obtained from a previous call to getstate(),
         and  setstate() restores the internal state of the generator to what

PyRandLib/lfib116.py

@@ -116,7 +116,7 @@ class LFib116( BaseLFib64 ):
 
 
     #=========================================================================
-    def random(self):
+    def random(self) -> float:
         """
         This is the core of the pseudo-random generator.
         Returned values are within [0.0, 1.0).

PyRandLib/lfib1340.py

@@ -117,7 +117,7 @@ class LFib1340( BaseLFib64 ):
 
 
     #=========================================================================
-    def random(self):
+    def random(self) -> float:
         """
         This is the core of the pseudo-random generator.
         Returned values are within [0.0, 1.0).

PyRandLib/lfib668.py

@@ -116,7 +116,7 @@ class LFib668( BaseLFib64 ):
 
 
     #=========================================================================
-    def random(self):
+    def random(self) -> float:
         """
         This is the core of the pseudo-random generator.
         Returned values are within [0.0, 1.0).

PyRandLib/lfib78.py

@@ -115,7 +115,7 @@ class LFib78( BaseLFib64 ):
 
 
     #=========================================================================
-    def random(self):
+    def random(self) -> float:
         """
         This is the core of the pseudo-random generator.
         Returned values are within [0.0, 1.0).