gh-99108: Mention HACL\* in the hashlib docs. (#105634)

This commit is contained in:
Gregory P. Smith 2023-06-10 12:09:20 -07:00 committed by GitHub
parent 0d1d6ab966
commit 3a314f7c3d
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -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: