circuitpython/docs/library/hashlib.rst

60 lines
1.8 KiB
ReStructuredText
Raw Normal View History

2018-05-06 13:23:21 -04:00
:mod:`hashlib` -- hashing algorithms
=====================================
2014-12-01 17:52:41 -05:00
.. include:: ../templates/unsupported_in_circuitpython.inc
2018-05-06 13:23:21 -04:00
.. module:: hashlib
:synopsis: hashing algorithms
2014-12-01 17:52:41 -05:00
|see_cpython_module| :mod:`cpython:hashlib`.
This module implements binary data hashing algorithms. The exact inventory
of available algorithms depends on a board. Among the algorithms which may
be implemented:
* SHA256 - The current generation, modern hashing algorithm (of SHA2 series).
It is suitable for cryptographically-secure purposes. Included in the
MicroPython core and any board is recommended to provide this, unless
it has particular code size constraints.
* SHA1 - A previous generation algorithm. Not recommended for new usages,
but SHA1 is a part of number of Internet standards and existing
2017-05-29 03:08:14 -04:00
applications, so boards targeting network connectivity and
2020-12-09 10:52:18 -05:00
interoperability will try to provide this.
* MD5 - A legacy algorithm, not considered cryptographically secure. Only
2020-12-09 10:52:18 -05:00
selected boards, targeting interoperability with legacy applications,
will offer this.
2014-12-01 17:52:41 -05:00
Constructors
------------
2018-05-06 13:23:21 -04:00
.. class:: hashlib.sha256([data])
2014-12-01 17:52:41 -05:00
Create an SHA256 hasher object and optionally feed ``data`` into it.
2018-05-06 13:23:21 -04:00
.. class:: hashlib.sha1([data])
Create an SHA1 hasher object and optionally feed ``data`` into it.
2018-05-06 13:23:21 -04:00
.. class:: hashlib.md5([data])
Create an MD5 hasher object and optionally feed ``data`` into it.
2014-12-01 17:52:41 -05:00
Methods
-------
.. method:: hash.update(data)
2014-12-01 17:52:41 -05:00
Feed more binary data into hash.
.. method:: hash.digest()
2014-12-01 17:52:41 -05:00
2016-07-31 19:52:00 -04:00
Return hash for all data passed through hash, as a bytes object. After this
method is called, more data cannot be fed into the hash any longer.
.. method:: hash.hexdigest()
2014-12-01 17:52:41 -05:00
2018-05-03 10:34:43 -04:00
This method is NOT implemented. Use ``binascii.hexlify(hash.digest())``
to achieve a similar effect.