[issue29161] random.SystemRandom(seed) documentation issue

Gary E. Miller report at bugs.python.org
Wed Jan 4 20:43:53 EST 2017


Gary E. Miller added the comment:

> > why have an ignored parameter that is not plainly documented as ignored.

> Because it improves the substitutability of one RNG for another (i.e. the same reason that we even have a seed() method).

I understand why it the parameter it there.  I think the parameter should stay there.  I am all for orthogonal functions.  It just needs to be documented that the parameter is ignored by SystemRandom().

Programmers are being misled by the online documentation and adding a seed parameter when it does nothing.

I should not have to read the library code to find out that a parameter is ignored.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29161>
_______________________________________


More information about the Python-bugs-list mailing list