Add link from os.urandom to random.SystemRandom

[JacekBzdak]

BPO	15936
Nosy	@tiran, @asvetlov

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2012-10-16.10:23:57.100>
created_at = <Date 2012-09-12.22:09:02.049>
labels = ['easy', 'type-feature', 'docs']
title = 'Add link from os.urandom to random.SystemRandom'
updated_at = <Date 2012-10-16.10:53:04.804>
user = 'https://bugs.python.org/JacekBzdak'

bugs.python.org fields:

activity = <Date 2012-10-16.10:53:04.804>
actor = 'python-dev'
assignee = 'docs@python'
closed = True
closed_date = <Date 2012-10-16.10:23:57.100>
closer = 'asvetlov'
components = ['Documentation']
creation = <Date 2012-09-12.22:09:02.049>
creator = 'Jacek.Bzdak'
dependencies = []
files = []
hgrepos = []
issue_num = 15936
keywords = ['easy']
message_count = 8.0
messages = ['170423', '172847', '172946', '172971', '173024', '173025', '173026', '173027']
nosy_count = 8.0
nosy_names = ['christian.heimes', 'asvetlov', 'docs@python', 'louiscipher', 'python-dev', 'Ramchandra Apte', 'mikehoy', 'Jacek.Bzdak']
pr_nums = []
priority = 'normal'
resolution = 'fixed'
stage = 'resolved'
status = 'closed'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue15936'
versions = ['Python 2.7', 'Python 3.3', 'Python 3.4']

[JacekBzdak]

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.

[RamchandraApte]

It should also mention that os.urandom is a low-level interface.

[louiscipher]

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

[RamchandraApte]

@bryce
Retract that message.

[python-dev]

New changeset 0a0b890508d3 by Andrew Svetlov in branch '3.3':
Issue bpo-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 bpo-15936: Add link from os.urandom to random.SystemRandom
http://hg.python.org/cpython/rev/34c2bb737364

[python-dev]

New changeset 2bff4969b65b by Andrew Svetlov in branch '2.7':
Issue bpo-15936: Add link from os.urandom to random.SystemRandom
http://hg.python.org/cpython/rev/2bff4969b65b

[asvetlov]

Fixed. Thanks.

[python-dev]

New changeset c1f27cf0cc9d by Andrew Svetlov in branch '2.7':
Issue bpo-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 bpo-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 bpo-15936: Reformat text for os.random to follow Larry Hastings suggestion
http://hg.python.org/cpython/rev/bd3647e9ac62