md5 — Алгоритм дайджеста сообщений MD5

Этот модуль реализует интерфейс для алгоритма дайджеста сообщений MD5 RSA (см. также Интернет RFC 1321). Его использование довольно простое: используйте new() для создания объекта md5. Теперь вы можете передавать этому объекту произвольные строки с помощью метода update(), и в любой момент вы можете запросить дайджест (сильный вид 128-битного контрольной суммы, также известный как «отпечаток») конкатенации строк, переданных ему до сих пор, с помощью метода digest().

Например, чтобы получить дайджест строки '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'

Более кратко:

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

Следующие значения предоставляются в качестве констант в модуле и как атрибуты объектов md5, возвращаемых new():

md5.digest_size

Размер результирующего дайджеста в байтах. Это всегда 16.

Модуль md5 предоставляет следующие функции:

md5.new([arg])

Возвращает новый объект md5. Если arg присутствует, выполняется вызов метода update(arg).

md5.md5([arg])

Из соображений обратной совместимости это альтернативное имя функции new().

Объект md5 имеет следующие методы:

md5.update(arg)

Обновляет объект md5 строкой arg. Повторные вызовы эквивалентны одному вызову с конкатенацией всех аргументов: m.update(a); m.update(b) эквивалентно m.update(a+b).

md5.digest()

Возвращает дайджест строк, переданных методу update() до сих пор. Это строка длиной 16 байтов, которая может содержать не-ASCII символы, включая нулевые байты.

md5.hexdigest()

Аналогично digest(), за исключением того, что дайджест возвращается как строка длиной 32, содержащая только шестнадцатеричные цифры. Это может быть использовано для безопасного обмена значением по электронной почте или в других небинарных средах.

md5.copy()

Возвращает копию («клон») объекта md5. Это может быть использовано для эффективного вычисления дайджестов строк, которые имеют общую начальную подстроку.