[Python-checkins] gh-99108: Mention HACL\* in the hashlib docs. (#105634)
gpshead
webhook-mailer at python.org
Sat Jun 10 15:09:26 EDT 2023
https://github.com/python/cpython/commit/3a314f7c3df0dd7c37da7d12b827f169ee60e1ea
commit: 3a314f7c3df0dd7c37da7d12b827f169ee60e1ea
branch: main
author: Gregory P. Smith <greg at krypto.org>
committer: gpshead <greg at krypto.org>
date: 2023-06-10T12:09:20-07:00
summary:
gh-99108: Mention HACL\* in the hashlib docs. (#105634)
files:
M Doc/library/hashlib.rst
diff --git a/Doc/library/hashlib.rst b/Doc/library/hashlib.rst
index 7f06151675c7..8102767a43d6 100644
--- a/Doc/library/hashlib.rst
+++ b/Doc/library/hashlib.rst
@@ -93,6 +93,11 @@ accessible by name via :func:`new`. See :data:`algorithms_available`.
.. versionchanged:: 3.9
Hashlib now uses SHA3 and SHAKE from OpenSSL if it provides it.
+.. versionchanged:: 3.12
+ For any of the MD5, SHA1, SHA2, or SHA3 algorithms that the linked
+ OpenSSL does not provide we fall back to a verified implementation from
+ the `HACL\* project`_.
+
Usage
-----
@@ -205,11 +210,6 @@ A hash object has the following methods:
concatenation of all the arguments: ``m.update(a); m.update(b)`` is
equivalent to ``m.update(a+b)``.
- .. versionchanged:: 3.1
- The Python GIL is released to allow other threads to run while hash
- updates on data larger than 2047 bytes is taking place when using hash
- algorithms supplied by OpenSSL.
-
.. method:: hash.digest()
@@ -811,6 +811,7 @@ Domain Dedication 1.0 Universal:
.. _Attacks on cryptographic hash algorithms: https://en.wikipedia.org/wiki/Cryptographic_hash_function#Attacks_on_cryptographic_hash_algorithms
.. _the FIPS 180-4 standard: https://csrc.nist.gov/publications/detail/fips/180/4/final
.. _the FIPS 202 standard: https://csrc.nist.gov/publications/detail/fips/202/final
+.. _HACL\* project: https://github.com/hacl-star/hacl-star
.. _hashlib-seealso:
More information about the Python-checkins
mailing list