[issue33953] The DEFAULT_ENTROPY variable used to store the current default random bytes value should be documented for `secrets` module
New submission from Serge Matveenko <serge@matveenko.ru>: There is the corresponding section on the topic here https://github.com/python/cpython/blob/3.6/Doc/library/secrets.rst#how-many-... The current value of 32 bytes is mentioned there correctly. Unfortunately, there is no way to know which constant in the `secrets` stores this value. It is easy to imagine a use case to use say `DEFAULT_ENTROPY * 4` in the code and stay updated with the default entropy being increased over time. Thus, it looks reasonable to document the `secrets.DEFAULT_ENTROPY` constant in the module docs. ---------- assignee: docs@python components: Documentation messages: 320402 nosy: docs@python, lig priority: normal severity: normal status: open title: The DEFAULT_ENTROPY variable used to store the current default random bytes value should be documented for `secrets` module type: enhancement versions: Python 3.6, Python 3.7, Python 3.8 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue33953> _______________________________________
Change by Cheryl Sabella <cheryl.sabella@gmail.com>: ---------- nosy: +rhettinger versions: -Python 3.6 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue33953> _______________________________________
Change by Serge Matveenko <serge@matveenko.ru>: ---------- versions: +Python 3.9 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue33953> _______________________________________
Change by Serge Matveenko <serge@matveenko.ru>: ---------- versions: +Python 3.6 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue33953> _______________________________________
Change by Raymond Hettinger <raymond.hettinger@gmail.com>: ---------- assignee: docs@python -> steven.daprano nosy: +steven.daprano _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue33953> _______________________________________
Change by Serge Matveenko <serge@matveenko.ru>: ---------- stage: -> resolved status: open -> closed _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue33953> _______________________________________
participants (3)
-
Cheryl Sabella
-
Raymond Hettinger
-
Serge Matveenko