Skip to content

Commit

Permalink
pythongh-99108: Mention HACL\* in the hashlib docs. (python#105634)
Browse files Browse the repository at this point in the history
  • Loading branch information
gpshead committed Jun 10, 2023
1 parent 0d1d6ab commit 3a314f7
Showing 1 changed file with 6 additions and 5 deletions.
11 changes: 6 additions & 5 deletions Doc/library/hashlib.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
-----

Expand Down Expand Up @@ -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()

Expand Down Expand Up @@ -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:
Expand Down

0 comments on commit 3a314f7

Please sign in to comment.