[issue29161] random.SystemRandom(seed) documentation issue

Gary E. Miller added the comment: > The docs are clear that System Random uses os.urandom() for creating random > numbers, that there is not state, that sequences aren't reproducible, and > that seed method has no effect and is ignored. Agreed, but not relevant. I have anecdotal proof that

[issue29161] random.SystemRandom(seed) documentation issue

Raymond Hettinger added the comment: Thank you for the submission. I respect what you're trying to do, but disagree that there is any issue here. The docs are clear that System Random uses os.urandom() for creating random numbers, that there is not state, that sequences aren't

[issue29161] random.SystemRandom(seed) documentation issue

Gary E. Miller added the comment: Is there a better place to submit documentation problems to? After my programming team spends a lot of valuable time figuring what the Python doc failed to mention I would like this knowledge to be put to good use by others. Paying it forward if you will.

[issue29161] random.SystemRandom(seed) documentation issue

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

[issue29161] random.SystemRandom(seed) documentation issue

Raymond Hettinger 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). -- priority: normal -> low resolution: -> not a

[issue29161] random.SystemRandom(seed) documentation issue

Gary E. Miller added the comment: I would change: "Accordingly, the seed() method has no effect and is ignored." To: "Accordingly, the optional seed parameter and the seed() method have no effect and are ignored." It was not obvious to me that the seed paramrter got passed to the seed()

[issue29161] random.SystemRandom(seed) documentation issue

Raymond Hettinger added the comment: >From the docs at >https://docs.python.org/3/library/random.html#alternative-generator : """ class random.SystemRandom([seed]) Class that uses the os.urandom() function for generating random numbers from sources provided by the operating system. Not

[issue29161] random.SystemRandom(seed) documentation issue

Changes by Raymond Hettinger : -- assignee: -> rhettinger nosy: +rhettinger ___ Python tracker ___

[issue29161] random.SystemRandom(seed) documentation issue

New submission from Gary E. Miller: The man page for random.SystemRandom([seed]]) fails to mention that the parameter 'seed' is never used. This should be prominent in the documentation. I have found several cases where a seed was provided to SystemRandom().