Commit Graph

79 Commits

Author SHA1 Message Date
Miss Islington (bot) a6fce19968 bpo-33783: Use proper class markup for random.Random docs (GH-7817) (GH-12859)
Signed-off-by: Matthias Bussonnier <bussonniermatthias@gmail.com>
(cherry picked from commit 31e8d69bfe)

Co-authored-by: Matthias Bussonnier <bussonniermatthias@gmail.com>
2019-04-16 23:32:32 +02:00
Miss Islington (bot) 7a3cbcdc55 Improve readability of random module examples (GH-11884) (GH-11885)
Based on reviewer feedback from Allen Downey, convert ``lambda`` to ``def``.
(cherry picked from commit 9abb725cea)

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
2019-02-15 12:47:04 -08:00
Miss Islington (bot) e31f8604e6 Document differences between random.choices() and random.choice(). (GH-11703) (GH-11706) 2019-01-30 13:49:23 -08:00
Raymond Hettinger 71c62e14aa Neaten-up and extend the examples in the random module docs. 2016-12-04 11:00:34 -08:00
Serhiy Storchaka 0264e46caa Issue #28763: Use double hyphens (rendered as en-dashes) in numerical ranges
in the documentation.
2016-11-26 13:49:59 +02:00
Serhiy Storchaka c7b1a0bbe2 Issue #28763: Use double hyphens (rendered as en-dashes) in numerical ranges
in the documentation.
2016-11-26 13:43:28 +02:00
Raymond Hettinger 7f94619555 Fix grammar 2016-11-21 15:13:18 -08:00
Raymond Hettinger 1149d9326e Add analysis section to motivate the single server queue example 2016-11-21 14:13:07 -08:00
Raymond Hettinger e1329105b3 Misc readability and organization improvements for the random docs 2016-11-21 12:33:50 -08:00
Raymond Hettinger 0537405ec1 Add a seealso section for further reference and skill building 2016-11-21 10:52:04 -08:00
Raymond Hettinger 8ab1258b58 Simplify code in an example 2016-11-21 10:16:01 -08:00
Raymond Hettinger 6befb64172 Extend and improve the examples for the random module 2016-11-21 01:59:39 -08:00
Raymond Hettinger a3950e42b0 Small edits to the docs for sample() and shuffle(). 2016-11-17 01:49:54 -08:00
Raymond Hettinger 0a1a909fe2 Further refinements to the examples and recipes for the random module 2016-11-17 00:45:35 -08:00
Raymond Hettinger 00305ade58 Add another example to the recipes section of the random docs 2016-11-16 22:56:11 -08:00
Raymond Hettinger 2589ee3e2b Minor touch-ups to the random module examples 2016-11-16 21:34:17 -08:00
Raymond Hettinger 16ef5d4ae1 Add cum_weights example (simulation of a cumulative binomial distribution). 2016-10-31 22:53:52 -07:00
Raymond Hettinger 1c3a121bb0 Issue #18844: Fix-up examples for random.choices(). Remove over-specified test. 2016-10-12 01:42:10 -04:00
Raymond Hettinger 9016f2864a Issue #18844: Make the number of selections a keyword-only argument for random.choices(). 2016-09-26 21:45:57 -07:00
Raymond Hettinger f5b7c7bfc1 Improve recipe by showing results of intermediate steps 2016-09-05 13:15:02 -07:00
Raymond Hettinger 16eb827b33 Improve docs for random.seed() 2016-09-04 11:17:28 -07:00
Raymond Hettinger 28aa4a0684 Rename weighted_choices() to just choices() 2016-09-07 00:08:44 -07:00
Raymond Hettinger e8f1e002c6 Issue #18844: Add random.weighted_choices() 2016-09-06 17:15:29 -07:00
Raymond Hettinger c7fac12f19 Merge 2016-09-05 13:15:20 -07:00
Raymond Hettinger 6579502c7e Merge 2016-09-04 11:17:48 -07:00
Steven D'Aprano b2871faa87 Documentation for secrets.py 2016-04-17 01:42:33 +10:00
Georg Brandl 5d94134040 Closes #25910: fix dead and permanently redirected links in the docs. Thanks to SilentGhost for the patch. 2016-02-26 19:37:12 +01:00
Georg Brandl 92849d1721 Closes #20169: fix inner links random doc. 2016-02-19 08:57:38 +01:00
Raymond Hettinger c89a451ae1 By popular demand, add back a security warning. 2014-05-11 02:26:23 -07:00
Raymond Hettinger a7894f7f4c Remove the redundant and poorly worded warning message.
The paragraph above already says, clearly and correctly, that
"However, being completely deterministic, it is not suitable for
all purposes, and is completely unsuitable for cryptographic purposes."

Also we should make any promises about SystemRandom or os.urandom()
being cryptographically secure (they may be, but be can't validate
that promise).  Further, those are actual random number generators
not psuedo-random number generators.
2014-05-10 14:05:28 -07:00
Antoine Pitrou ba69008bd0 Issue #16190: fix random module recommendation to use ssl.RAND_bytes(). 2013-08-16 19:19:40 +02:00
Ezio Melotti 8429b6784b #15831: merge with 3.2 2012-09-14 06:35:09 +03:00
Ezio Melotti e0add76468 #15831: document multiple signatures on different lines. Patch by Chris Jerdonek. 2012-09-14 06:32:35 +03:00
Sandro Tosi 5bb665f00c merge with 3.2 2012-08-12 15:12:32 +02:00
Sandro Tosi 985104a20c it's getstatus() not setstatus(); thanks to Shaddi Hasan from docs@ 2012-08-12 15:12:15 +02:00
Raymond Hettinger f07d949367 Fix markup 2012-07-09 12:43:57 -07:00
Raymond Hettinger 86a20f834a Issue 15265: document the exception raised for invalid sample sizes. 2012-07-08 16:01:53 -07:00
Sandro Tosi d2cbd90539 merge with 3.2 2012-04-14 16:01:49 +02:00
Sandro Tosi 1ee17198c8 fix typo; thanks to Jérôme Mainka from docs@ 2012-04-14 16:01:17 +02:00
Georg Brandl 902e895578 merge doc fixes from 3.2 2011-09-17 20:40:35 +02:00
Georg Brandl 73dd7c71f6 Add info from the docstring for random.gammavariate() to the docs. 2011-09-17 20:36:28 +02:00
Victor Stinner c58140c557 Issue #12049: cleanup the warning in the random module doc 2011-05-25 13:13:55 +02:00
Victor Stinner 19fb53c119 Issue #12049: improve RAND_bytes() and RAND_pseudo_bytes() documentation
Add also a security warning in the module random pointing to ssl.RAND_bytes().
2011-05-24 21:32:40 +02:00
Raymond Hettinger 4f707fd316 Separate source link from main text. 2011-01-10 19:54:11 +00:00
Raymond Hettinger 1048094037 Move source links to consistent location and remove wordy, big yellow boxes. 2011-01-10 03:26:08 +00:00
Antoine Pitrou e72b586b02 Fix heading level 2010-12-12 20:13:31 +00:00
Raymond Hettinger 6e35394ed5 Mention itertools.accumulate(). 2010-12-04 23:42:12 +00:00
Raymond Hettinger 3cdf871a8c Neaten-up random module docs. 2010-12-02 05:35:35 +00:00
Raymond Hettinger 2fdc7b1f75 Add an example to the random docs. 2010-12-02 02:41:33 +00:00
Éric Araujo 6e6cb8e0e4 Provide links to Python source where the code is short, readable and
informative adjunct to the docs.  Forward-port of Raymond's r86225 and
r86245 using the new source reST role added in #10334.
2010-11-16 19:13:50 +00:00