[Python-Dev] [Python-checkins] cpython (merge 3.3 -> default): Merge issue #15936: Add link from os.urandom to random.SystemRandom (original) (raw)

Antoine Pitrou solipsis at pitrou.net
Tue Oct 16 13:14:27 CEST 2012

On Tue, 16 Oct 2012 12:52:25 +0200 Christian Heimes <christian at python.org> wrote:

Am 16.10.2012 12:43, schrieb Larry Hastings: > On 10/16/2012 11:23 AM, Hynek Schlawack wrote: >> Am 16.10.2012 um 12:15 schrieb andrew.svetlov <python-checkins at python.org>: >> >>> + For easy to use interface to system randomness please see >>> + :class:random.SystemRandom. >> Is it just my non-native speaker ears, or should there be an “an” before “easy”? > > There should. And "for system randomness" is hard to follow. I would > have written it as > > For an easy-to-use interface to the random number generator provided > by your platform, please see :class:random.SystemRandom.

I don't like the phrase "easy-to-use" at all. IMO it can't get any easier than "give my X random bytes". random.SystemRandom is simply a high level interface that is mostly compatible with the random module.

I guess it's easy to use if you need something other than raw bytes. But, yes, I would call it "higher level" rather than "easy to use" (I don't think there's a need for hyphens, by the way).

Regards

Antoine.

-- Software development and contracting: http://pro.pitrou.net

More information about the Python-Dev mailing list