Source

features/pep-420 / Doc / library / md5.rst

Full commit

:mod:`md5` --- MD5 message digest algorithm

This module implements the interface to RSA's MD5 message digest algorithm (see also Internet RFC 1321). Its use is quite straightforward: use :func:`new` to create an md5 object. You can now feed this object with arbitrary strings using the :meth:`update` method, and at any point you can ask it for the :dfn:`digest` (a strong kind of 128-bit checksum, a.k.a. "fingerprint") of the concatenation of the strings fed to it so far using the :meth:`digest` method.

For example, to obtain the digest of the string 'Nobody inspects the spammish repetition':

>>> import md5
>>> m = md5.new()
>>> m.update("Nobody inspects")
>>> m.update(" the spammish repetition")
>>> m.digest()
'\xbbd\x9c\x83\xdd\x1e\xa5\xc9\xd9\xde\xc9\xa1\x8d\xf0\xff\xe9'

More condensed:

>>> md5.new("Nobody inspects the spammish repetition").digest()
'\xbbd\x9c\x83\xdd\x1e\xa5\xc9\xd9\xde\xc9\xa1\x8d\xf0\xff\xe9'

The following values are provided as constants in the module and as attributes of the md5 objects returned by :func:`new`:

The md5 module provides the following functions:

An md5 object has the following methods: