Módulo Hashlib do Python

O módulo hashlib fornece funções hash seguras como SHA-256 e MD5.

import hashlib

Funções hash transformam dados em um digest de tamanho fixo. Uma pequena mudança na entrada gera um digest bem diferente.

Criando um hash

Normalmente você começa escolhendo um algoritmo e passando bytes.

import hashlib

digest = hashlib.sha256(b'hello world')
print(digest.hexdigest())

b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9

Strings precisam ser codificadas para bytes primeiro.

import hashlib

message = 'hello world'
digest = hashlib.sha256(message.encode('utf-8')).hexdigest()
print(digest)

b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9

Atualização incremental

Hashes podem ser atualizados em partes.

hasher = hashlib.sha256()
hasher.update(b'hello ')
hasher.update(b'world')
print(hasher.hexdigest())

b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9

Comparando algoritmos

Algoritmos diferentes produzem tamanhos de digest diferentes.

print(hashlib.md5(b'abc').hexdigest())
print(hashlib.sha1(b'abc').hexdigest())
print(hashlib.sha256(b'abc').hexdigest())

900150983cd24fb0d6963f7d28e17f72
a9993e364706816aba3e25717850c26c9cd0d89d
ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad

Fazendo hash de um arquivo

Leia arquivos em partes para não precisar carregar arquivos grandes inteiros na memória.

import hashlib
from pathlib import Path

path = Path('example.txt')
path.write_text('hello world')

hasher = hashlib.sha256()
with path.open('rb') as file:
    for chunk in iter(lambda: file.read(8192), b''):
        hasher.update(chunk)

print(hasher.hexdigest())
path.unlink()

b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9

Links relacionados

• Module: pathlib
• Folha de Referência: Leitura e escrita de arquivos
• open()