Converti PYC in PY

È necessario un file PY quando un programma, uno sviluppatore o un archivio contiene solo un modulo Python compilato, ma il relativo codice sorgente deve essere ispezionato o modificato. Si tratta di decompilazione, non di una conversione di formato senza perdita, quindi il codice recuperato potrebbe non corrispondere all'originale.

Che cos'è il formato PYC

I file PYC contengono bytecode Python e un oggetto codice serializzato per l'esecuzione da parte di un interprete Python. Python li crea comunemente durante l'importazione o la compilazione di un file PY, inserendoli in __pycache__ con nomi come module.cpython-311.pyc. I pacchetti installati, le distribuzioni di applicazioni e i software inclusi in bundle possono contenere file PYC senza il codice sorgente corrispondente.

Un file PYC contiene un'intestazione con i metadati dell'interprete e della cache, seguita da dati bytecode marshalizzati. Normalmente non conserva commenti, spaziatura originale, virgolette, formattazione o l'organizzazione esatta del codice sorgente. Molti identificatori rimangono nell'oggetto codice, ma l'ottimizzazione, l'offuscamento, il codice generato e i dettagli della compilazione possono rimuovere o modificare alcune informazioni.

Che cos'è il formato PY

PY è un file di codice sorgente Python in testo semplice, destinato alla lettura e alla modifica. Gli interpreti Python, gli IDE, i linter, i formatter, i sistemi di controllo versione e gli strumenti di packaging lavorano direttamente con i file PY. A differenza dell'output ricostruito, un file PY originale conserva i commenti dello sviluppatore, la formattazione, l'organizzazione del codice sorgente e, generalmente, tutte le intenzioni a livello di codice sorgente.

Rinominare un file PYC in .py non lo converte: il risultato è ancora bytecode binario e non è codice sorgente Python valido.

Come decompilare un file PYC

1. Creare una copia del file PYC e lavorare su quella copia. Non eseguire un PYC non attendibile né uno script ricostruito; quando il file non è attendibile, i decompiler e le importazioni Python devono essere eseguiti in un ambiente isolato.
2. Identificare la versione di Python che ha creato il file. Un nome come module.cpython-311.pyc identifica CPython 3.11, ma un nome di file indipendente potrebbe non contenere queste informazioni. Il pacchetto che lo ha prodotto, l'intestazione PYC o il numero magico del bytecode possono fornire ulteriori indicazioni.
3. Installare un decompiler il cui supporto documentato includa quella versione del bytecode. Ad esempio:

python -m pip install decompyle3
decompyle3 -o recovered path/to/module.pyc

La directory di output dovrebbe contenere i file di codice sorgente ricostruiti. Se il comando installato non è disponibile nel percorso di sistema, eseguire l'eseguibile dalla directory degli script dell'ambiente.

Per una versione supportata diversa, provare uncompyle6:

python -m pip install uncompyle6
uncompyle6 -o recovered path/to/module.pyc

decompyle3 e uncompyle6 supportano intervalli specifici di bytecode Python anziché ogni versione attuale, quindi è necessario consultare la documentazione sulla compatibilità di ciascun progetto prima di scegliere tra i due. pycdc è un'altra opzione locale quando la sua versione supporta quella del bytecode del file:

pycdc path/to/module.pyc > recovered.py

I servizi online come PyLingual possono essere utili per file non riservati quando il supporto pubblicato include la versione Python del PYC. Il caricamento del bytecode invia codice potenzialmente proprietario a terzi e può essere soggetto a limiti di dimensione, conservazione o elaborazione; per il software riservato, utilizzare uno strumento locale e verificare l'output scaricato prima di aprirlo o eseguirlo.

Verificare e correggere il codice sorgente recuperato

Aprire il file .py generato in un editor e controllare la sintassi, le importazioni, la gestione delle eccezioni, i generatori, le comprensioni, i decorator, le closure e il codice generato dinamicamente. Compilarlo con l'interprete previsto:

python -m py_compile recovered.py

Una compilazione completata correttamente verifica solo la sintassi. Eseguire i test pertinenti e confrontare il comportamento con quello dell'applicazione originale prima di utilizzare il risultato come codice sorgente sostitutivo. Un decompiler può produrre codice dall'aspetto valido con un flusso di controllo errato o con dettagli mancanti.

Compatibilità e limiti del recupero

Il bytecode è strettamente legato alle implementazioni e alle versioni di Python. Un PYC creato da Python 3.11 o 3.12 potrebbe non funzionare con un decompiler che supporta solo bytecode meno recenti; i file PYC di Python 2 generalmente richiedono strumenti compatibili con Python 2. Un file danneggiato, troncato, ottimizzato, offuscato o modificato può produrre un output incompleto o non produrre alcun risultato.

La decompilazione non può ripristinare commenti, formattazione originale, moduli esterni non disponibili, dati del pacchetto o file sorgente a cui fa riferimento il codice. I moduli di estensione nativi non sono file PYC Python e richiedono metodi di recupero diversi. Il file PY originale, il repository del controllo versione, l'archivio di distribuzione, il backup o il codice sorgente del pacchetto sono gli unici modi affidabili per ottenere il codice sorgente esatto.