traverseda
/
cpython
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

bpo-40286: Put methods in correct sections. Add security notice to use secrets for session tokens. (GH-19870)

This commit is contained in:
Raymond Hettinger 2020-05-04 22:52:13 -07:00 committed by GitHub
parent 1e7e4519a8
commit f01d1be97d
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 15 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
Doc/library/random.rst
View File

@ -104,21 +104,16 @@ Bookkeeping functions
the time :func:`getstate` was called.
.. function:: getrandbits(k)
Returns a Python integer with *k* random bits. This method is supplied with
the Mersenne Twister generator and some other generators may also provide it
as an optional part of the API. When available, :meth:`getrandbits` enables
:meth:`randrange` to handle arbitrarily large ranges.
.. versionchanged:: 3.9
This method now accepts zero for *k*.
Functions for bytes
-------------------
.. function:: randbytes(n)
Generate *n* random bytes.
This method should not be used for generating security tokens.
Use :func:`secrets.token_bytes` instead.
.. versionadded:: 3.9
@ -145,6 +140,16 @@ Functions for integers
Return a random integer *N* such that ``a <= N <= b``. Alias for
``randrange(a, b+1)``.
.. function:: getrandbits(k)
Returns a Python integer with *k* random bits. This method is supplied with
the MersenneTwister generator and some other generators may also provide it
as an optional part of the API. When available, :meth:`getrandbits` enables
:meth:`randrange` to handle arbitrarily large ranges.
.. versionchanged:: 3.9
This method now accepts zero for *k*.
Functions for sequences
-----------------------