From: Nikita Sobolev Date: Sat, 26 Nov 2022 09:33:48 +0000 (+0300) Subject: gh-99502: mention bytes-like objects as input in `secrets.compare_digest` (GH-99512) X-Git-Tag: v3.12.0a3~93 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=47d673d81fc315069c14f9438ebe61fb70ef1ccc;p=thirdparty%2FPython%2Fcpython.git gh-99502: mention bytes-like objects as input in `secrets.compare_digest` (GH-99512) Now it is in sync with https://docs.python.org/3/library/hmac.html#hmac.compare_digest It is the same function, just re-exported. So, I guess they should mention the same input types. --- diff --git a/Doc/library/secrets.rst b/Doc/library/secrets.rst index dc8e5f46fb58..4405dfc05359 100644 --- a/Doc/library/secrets.rst +++ b/Doc/library/secrets.rst @@ -128,7 +128,9 @@ Other functions .. function:: compare_digest(a, b) - Return ``True`` if strings *a* and *b* are equal, otherwise ``False``, + Return ``True`` if strings or + :term:`bytes-like objects ` + *a* and *b* are equal, otherwise ``False``, using a "constant-time compare" to reduce the risk of `timing attacks `_. See :func:`hmac.compare_digest` for additional details.