[issue15936] Add link from os.urandom to random.SystemRandom
New submission from Jacek Bzdak: It would be great if one sentence was added to os.urandom description: "For easy to use interface to system randomness please see random.SystemRandom class". The reason for this change is that many references quote only os.urandom as a cryptographically strong randomeness source in python, and for some people it might be not obvious that there already exists such easy to use api to use cryptographically strong randomness (that is random.SystemRandom class). It would be good to point such people to right class. Myself for example spent last hour trying to create makeshift Random subclass that uses os.urandom as it's randomness source. ---------- assignee: docs@python components: Documentation messages: 170423 nosy: Jacek.Bzdak, docs@python priority: normal severity: normal status: open title: Add link from os.urandom to random.SystemRandom type: enhancement versions: Python 2.7 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue15936> _______________________________________
Changes by Petri Lehtinen <petri@digip.org>: ---------- keywords: +easy stage: -> needs patch versions: +Python 3.3, Python 3.4 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue15936> _______________________________________
Changes by Mike Hoy <mhoy09@gmail.com>: ---------- nosy: +mikehoy _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue15936> _______________________________________
Changes by Chris Jerdonek <chris.jerdonek@gmail.com>: ---------- nosy: +christian.heimes _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue15936> _______________________________________
Ramchandra Apte added the comment: It should also mention that os.urandom is a low-level interface. ---------- nosy: +ramchandra.apte _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue15936> _______________________________________
Bryce Verdier added the comment: Ramchandra, doesn't the description of os.urandom already imply that it's a low-level interface? Or are you saying that you want this to be explicitly stated? I would also like to work on this bug ---------- nosy: +louiscipher _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue15936> _______________________________________
Ramchandra Apte added the comment: @Bryce Retract that message. ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue15936> _______________________________________
Roundup Robot added the comment: New changeset 0a0b890508d3 by Andrew Svetlov in branch '3.3': Issue #15936: Add link from os.urandom to random.SystemRandom http://hg.python.org/cpython/rev/0a0b890508d3 New changeset 34c2bb737364 by Andrew Svetlov in branch 'default': Merge issue #15936: Add link from os.urandom to random.SystemRandom http://hg.python.org/cpython/rev/34c2bb737364 ---------- nosy: +python-dev _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue15936> _______________________________________
Roundup Robot added the comment: New changeset 2bff4969b65b by Andrew Svetlov in branch '2.7': Issue #15936: Add link from os.urandom to random.SystemRandom http://hg.python.org/cpython/rev/2bff4969b65b ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue15936> _______________________________________
Andrew Svetlov added the comment: Fixed. Thanks. ---------- nosy: +asvetlov resolution: -> fixed stage: needs patch -> committed/rejected status: open -> closed _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue15936> _______________________________________
Roundup Robot added the comment: New changeset c1f27cf0cc9d by Andrew Svetlov in branch '2.7': Issue #15936: Reformat text for os.random to follow Larry Hastings suggestion http://hg.python.org/cpython/rev/c1f27cf0cc9d New changeset da8155ccf70b by Andrew Svetlov in branch '3.3': Issue #15936: Reformat text for os.random to follow Larry Hastings suggestion http://hg.python.org/cpython/rev/da8155ccf70b New changeset bd3647e9ac62 by Andrew Svetlov in branch 'default': Merge issue #15936: Reformat text for os.random to follow Larry Hastings suggestion http://hg.python.org/cpython/rev/bd3647e9ac62 ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue15936> _______________________________________
participants (8)
-
Andrew Svetlov
-
Bryce Verdier
-
Chris Jerdonek
-
Jacek Bzdak
-
Mike Hoy
-
Petri Lehtinen
-
Ramchandra Apte
-
Roundup Robot