Pular para o conteúdo

Converter PYC para PY

Recupere código-fonte Python legível a partir de bytecode com decompilers compatíveis com a versão.

Crie ficheiros PY online

Ainda não conseguimos ler ficheiros PYC, por isso esta conversão não está disponível. Se conseguir exportar o seu trabalho para um destes formatos, transformamo-lo em PY:

Quer converter PYC para PY?

Diga-nos. Escolhemos as próximas conversões a adicionar de acordo com o interesse.

Como converter pyc para py arquivo

É necessário um arquivo PY quando um programa, desenvolvedor ou arquivo contém apenas um módulo Python compilado, mas seu código-fonte precisa ser inspecionado ou editado. Isso é descompilação, e não uma conversão de formato sem perdas, portanto o código recuperado pode não corresponder ao original.

O que é o formato PYC

Arquivos PYC contêm bytecode Python e um objeto de código serializado para execução por um interpretador Python. O Python geralmente os cria ao importar ou compilar um arquivo PY, colocando-os em __pycache__ com nomes como module.cpython-311.pyc. Pacotes instalados, implantações de aplicativos e software empacotado podem conter arquivos PYC sem o código-fonte correspondente.

Um arquivo PYC possui um cabeçalho contendo metadados do interpretador e do cache, seguido por dados de bytecode serializados com marshal. Normalmente, ele não preserva comentários, espaços em branco originais, uso de aspas, formatação ou a disposição exata do código-fonte. Muitos identificadores permanecem no objeto de código, mas a otimização, a ofuscação, o código gerado e os detalhes da compilação podem remover ou alterar informações.

O que é o formato PY

PY é um arquivo de código-fonte Python em texto simples, destinado à leitura e edição. Interpretadores Python, IDEs, linters, formatadores, sistemas de controle de versão e ferramentas de empacotamento trabalham diretamente com arquivos PY. Diferentemente da saída reconstruída, um arquivo PY original mantém os comentários do desenvolvedor, a formatação, a organização do código-fonte e, geralmente, toda a intenção no nível do código-fonte.

Renomear um arquivo PYC para .py não o converte: o resultado ainda é bytecode binário e não é um código-fonte Python válido.

Como descompilar um arquivo PYC

  1. Faça uma cópia do arquivo PYC e trabalhe nessa cópia. Não execute um PYC ou script reconstruído não confiável; descompiladores e importações Python devem ser executados em um ambiente isolado quando o arquivo não for confiável.
  2. Identifique a versão do Python que criou o arquivo. Um nome como module.cpython-311.pyc identifica o CPython 3.11, mas um nome de arquivo independente pode não conter essa informação. O pacote que produziu o arquivo, o cabeçalho do PYC ou o número mágico do bytecode podem fornecer pistas adicionais.
  3. Instale um descompilador cujo suporte documentado inclua essa versão do bytecode. Por exemplo:
python -m pip install decompyle3
decompyle3 -o recovered path/to/module.pyc

O diretório de saída deve conter arquivos de código-fonte reconstruídos. Se o comando instalado não estiver disponível no caminho do sistema, execute o executável a partir do diretório de scripts do ambiente.

Para uma versão diferente compatível, tente uncompyle6:

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

decompyle3 e uncompyle6 oferecem suporte a intervalos específicos de bytecode Python, e não a todas as versões atuais, portanto consulte a documentação de compatibilidade de cada projeto antes de escolher entre eles. pycdc é outra opção local quando sua versão oferece suporte à versão de bytecode do arquivo:

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

Serviços online como o PyLingual podem ser úteis para arquivos não confidenciais quando o suporte publicado incluir a versão do Python do PYC. O upload do bytecode envia código potencialmente proprietário a terceiros e pode sujeitá-lo a limites de tamanho, retenção ou processamento; use uma ferramenta local para software confidencial e verifique a saída baixada antes de abri-la ou executá-la.

Verificar e reparar o código-fonte recuperado

Abra o arquivo .py gerado em um editor e inspecione a sintaxe, as importações, o tratamento de exceções, os geradores, as compreensões, os decoradores, os closures e o código gerado dinamicamente. Compile-o com o interpretador pretendido:

python -m py_compile recovered.py

Uma compilação bem-sucedida verifica apenas a sintaxe. Execute os testes relevantes e compare o comportamento com o aplicativo original antes de usar o resultado como código-fonte substituto. Um descompilador pode emitir código com aparência válida, mas com fluxo de controle incorreto ou detalhes ausentes.

Compatibilidade e limites da recuperação

O bytecode é estreitamente vinculado às implementações e versões do Python. Um PYC criado pelo Python 3.11 ou 3.12 pode não funcionar com um descompilador compatível apenas com bytecode mais antigo; arquivos PYC do Python 2 geralmente exigem ferramentas compatíveis com o Python 2. Um arquivo danificado, truncado, otimizado, ofuscado ou modificado pode produzir uma saída incompleta ou falhar completamente.

A descompilação não pode restaurar comentários, formatação original, módulos externos indisponíveis, dados de pacotes ou arquivos de código-fonte referenciados pelo código. Módulos de extensão nativos não são arquivos PYC Python e exigem métodos de recuperação diferentes. O arquivo PY original, o repositório de controle de versão, o arquivo de implantação, o backup ou o código-fonte do pacote são as únicas formas confiáveis de obter o código-fonte exato.

Comparação de formato: PYC vs PY

Como os formatos PYC e PY se comparam nas propriedades mais importantes para esta conversão.

Comparação dos formatos de arquivo PYC e PY
Propriedade .PYC Python compiled bytecode .PY Python source file
Legível em texto simples Não Sim
Formatação de texto Nenhum Básico
Imagens Não Não
Edição posterior Não editável diretamente Fácil
Abre num navegador web Não Não
Tamanho típico do arquivo Muito pequeno Pequeno
Padrão aberto Sim Sim
Mais usado para Incorporação em aplicações Edição e pós-produção
Introduzido 1991 1991
Desenvolvedor Python Software Foundation Python Software Foundation
Tipo MIME — text/x-python

As informações sobre extensões e tipos de arquivo são fornecidas por File-Extensions.org

Perguntas frequentes

É possível converter um arquivo .pyc de volta para um arquivo .py?

Às vezes, um arquivo .pyc pode ser descompilado para obter um código-fonte .py aproximado, mas normalmente não pode ser restaurado exatamente. Os comentários, a formatação original e alguns detalhes do código-fonte geralmente são perdidos durante a compilação.

O código .py recuperado será idêntico ao original?

Não, o código .py recuperado geralmente é uma reconstrução do bytecode compilado, e não o código-fonte original. Nomes e a estrutura do programa podem ser parcialmente preservados, mas comentários, espaçamento, algumas expressões e outros detalhes do código-fonte podem ser diferentes ou estar ausentes.

Por que a conversão de .pyc para .py falha em alguns arquivos Python?

Isso costuma acontecer quando a versão do bytecode não corresponde à do descompilador ou quando o arquivo foi otimizado, ofuscado, danificado ou produzido por uma implementação diferente do Python. Um arquivo .pyc também pode conter apenas o código compilado de um módulo, portanto não pode restaurar arquivos-fonte ou a estrutura do projeto que nunca foram incluídos.

Posso executar o arquivo .py resultante exatamente como o original?

Muitas vezes, mas nem sempre; o código recuperado pode precisar de correções manuais antes de ser executado. Bytecode específico da versão do Python, arquivos externos ausentes e detalhes do código-fonte perdidos podem causar erros de sintaxe ou alterar o comportamento.

Conversão inversa

Converter para .py
de outros formatos

Compartilhar nas redes sociais:

Já baixado

Este ficheiro já foi baixado. Para proteger a sua privacidade, apagámo-lo do nosso servidor logo após o download, por isso não pode ser baixado de novo. Se precisar dele outra vez, converta o ficheiro novamente.