LookupError: 'hex' is not a text encoding; use codecs.encode() to handle arbitrary codecs
Ai scris .encode("hex") sau .decode("hex"), forma din Python 2. În Python 3, pentru bytes → hex folosești b.hex(), iar pentru hex → bytes bytes.fromhex(text). Pentru textul unui hash, hexdigest() îți dă direct hex-ul.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În Python 2 se putea scrie "abc".encode("hex") sau h.decode("hex"). În Python 3, str.encode acceptă doar encoding-uri de text (utf-8, ascii, latin-1...), iar hex este o transformare bytes → bytes, nu un encoding de text. Mesajul spune exact asta și sugerează codecs.encode(), modulul care știe și transformările „arbitrare”.
Apare des când copiezi cod vechi de blockchain (scripturi Bitcoin, tutoriale din 2014–2017) sau răspunsuri vechi de pe forumuri. Metodele moderne sunt mai simple: b.hex() dă textul hex al unor bytes, bytes.fromhex("ab01") face invers, iar hashlib.sha256(b).hexdigest() dă direct hex-ul hash-ului. Dacă vezi .decode("hex") pe un text, înlocuiește-l cu bytes.fromhex(text).
De ce apare: cauzele frecvente
1Cod Python 2 pentru hex
date = "Ana->Bogdan:5"
print(date.encode("hex"))date = "Ana->Bogdan:5"
print(date.encode().hex())Întâi transformi textul în bytes cu encode(), apoi hex() dă textul hex.
2Hex înapoi în bytes cu decode("hex")
h = "9f86d081884c7d65"
b = h.decode("hex")h = "9f86d081884c7d65"
b = bytes.fromhex(h)Pe un str nu există decode în Python 3; bytes.fromhex citește direct textul hex.
Repară eroarea, direct în pagină
Codul de mai jos, copiat dintr-un tutorial vechi, afișează în hex o tranzacție și hash-ul ei dublu, ca în Bitcoin, dar dă LookupError: 'hex' is not a text encoding. Adu-l la Python 3 ca să afișeze textul hex al tranzacției și primele 16 caractere ale hash-ului dublu.
import hashlib
tx = "Ana->Bogdan:5"
print("Hex:", tx.encode("hex"))
dublu = hashlib.sha256(hashlib.sha256(tx.encode()).digest()).digest()
print("Hash dublu:", dublu.hex()[:16])Hex: 416e612d3e426f6764616e3a35 Hash dublu: 305679ea2abc8310
Indiciu
Bytes-urile au o metodă care dă direct textul hex.
Reparația
import hashlib
tx = "Ana->Bogdan:5"
print("Hex:", tx.encode().hex())
dublu = hashlib.sha256(hashlib.sha256(tx.encode()).digest()).digest()
print("Hash dublu:", dublu.hex()[:16])De ce merge
tx.encode() transformă textul în bytes UTF-8, iar .hex() scrie fiecare byte ca două cifre hex: A devine 41, n devine 6e. Hash-ul dublu se calculează pe digest() (bytes), nu pe hexdigest(), exact ca în Bitcoin, iar la final .hex() îl face lizibil.
Alte forme ale mesajului
LookupError: 'base64' is not a text encoding; use codecs.encode() to handle arbitrary codecsLookupError: unknown encoding: hexaLookupError: 'hex' is not a text encoding; use codecs.decode() to handle arbitrary codecs
Cum o eviți pe viitor
Ține minte trei unelte: bytes.hex(), bytes.fromhex() și hexdigest(). Când copiezi cod vechi, caută encode("hex"), decode("hex"), print x fără paranteze sau xrange: sunt semne că e Python 2 și trebuie adaptat. Pentru base64 folosește modulul base64 (base64.b64encode(b)).
Întrebări frecvente
Merge varianta cu codecs.encode?
Da: codecs.encode(b"abc", "hex") dă b'616263', adică tot bytes. b"abc".hex() e mai scurt și îți dă direct un text.
Care e diferența dintre hexdigest() și digest().hex()?
Niciuna în rezultat: ambele dau aceleași 64 de caractere pentru SHA-256. digest() e util când ai nevoie de bytes, de exemplu la hash-ul dublu din Bitcoin.
Erori înrudite
AttributeError: 'str' object has no attribute 'decode' Ai apelat .decode() pe un text (str), de obicei pe rezultatul lui hexdigest() sau json.dumps(), care sunt deja text. Șterge .decode(): valoarea e gata de folosit. ValueError: non-hexadecimal number found in fromhex() arg at position 1 Textul dat lui bytes.fromhex conține un caracter care nu e cifră hex, de obicei prefixul 0x (x este la poziția 1). Taie prefixul înainte: bytes.fromhex(valoare.removeprefix("0x")). UnicodeEncodeError: 'ascii' codec can't encode character '\u0103' in position 4: ordinal not in range(128) Ai encodat cu "ascii" un text cu diacritice (ă, ș, ț) sau alte caractere în afara ASCII. ASCII are doar 128 de caractere. Folosește .encode("utf-8") (sau .encode() simplu), care poate reprezenta orice caracter. Învață Blockchain de la zero, cu exerciții la fiecare lecție
Curs Blockchain și criptomonede: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
