Activity

1. viccie30

   added

   docsDocumentation in the Doc dirDocumentation in the Doc dir

   on Jan 11, 2026
2. github-project-automation

   added this to docs issueson Jan 11, 2026
3. github-project-automation

   moved this to Todo in docs issueson Jan 11, 2026
4. picnixz commented on Jan 11, 2026

   

   picnixz

   on Jan 11, 2026

   Member

   More actions

   There is another way to actually obtain the default entropy: call token_bytes() and take the length of the result. Now, there is a reason why I could decide not to document it. For instance, one could say that we choose the reasonable number of bytes. We don't really want users to do secrets.DEFAULT_ENTROPY = 1 and then be surprised that it's no more reasonable (we don't want it to be a writable constant but unfortunately we can't ensure that at runtime).

   If we were to document this, we would also need to change its value every time we change it (though I think we can safely assume that 32 bytes if ok for now). So, we should also say that only the constant name is public but not the value and that users should not change it.

   Reacted by Victor Westerhuis
5. picnixz

   changed the title [-]Document secrets.DEFAULT_ENTROPY[/-] [+]Document secrets.DEFAULT_ENTROPY as an opaque value[/+] on Jan 11, 2026
6. picnixz

   self-assigned this

   on Jan 11, 2026
7. Alisa211 commented on Jan 14, 2026

   

   Alisa211

   on Jan 14, 2026

   More actions

   Thanks for the detailed explanation! That makes sense.
   Given the design considerations, I’ll look for another documentation issue to start with.
8. picnixz

   added 2 commits that reference this issue on Feb 7, 2026

   pythongh-143700: document `secrets.DEFAULT_ENTROPY` as an opaque value

   d802840

   gh-143700: document `secrets.DEFAULT_ENTROPY` as an opaque value (#14…

   9349972
9. miss-islington

   added 2 commits that reference this issue on Feb 7, 2026

   pythongh-143700: document `secrets.DEFAULT_ENTROPY` as an opaque value (

   2f6daa3

   pythongh-143700: document `secrets.DEFAULT_ENTROPY` as an opaque value (

   cfead24
10. picnixz

    added 2 commits that reference this issue on Feb 7, 2026

    [3.14] gh-143700: document `secrets.DEFAULT_ENTROPY` as an opaque val…

    626a6bc

    [3.13] gh-143700: document `secrets.DEFAULT_ENTROPY` as an opaque val…

    e6e0171
11. picnixz

    closed this as completedon Feb 7, 2026
12. thunder-coding

    added a commit that references this issue on Feb 15, 2026

    pythongh-143700: document `secrets.DEFAULT_ENTROPY` as an opaque value (

    86d51eb
13. ljfp

    added a commit that references this issue on Apr 25, 2026

    pythongh-143700: document `secrets.DEFAULT_ENTROPY` as an opaque value (

    499a080