No entanto, tudo isso é complicado, não robusto, reduziu muito a velocidade da descompilação e não é realmente sustentável.

Neste projeto, começamos a reescrever e refatorar a gramática.

No entanto, mesmo isso não é suficiente. O fluxo de controle precisa ser abordado usando dominadores e dominadores reversos, que o projeto python-control-flow_ pode fornecer.

Isso eu estou finalmente fazendo lentamente em outro projeto não público. É muito trabalho. O financiamento na forma de patrocínio, embora muito apreciado, não é proporcional ao esforço, e atualmente tenho um emprego em tempo integral. Portanto, pode levar tempo até que esteja disponível publicamente, se é que estará.

Requisitos

O código aqui pode ser executado nas versões Python 3.7 ou 3.8. Os arquivos de bytecode que pode ler foram testados em bytecodes Python das versões 3.7 e 3.8.

Instalação

Pode instalar a partir do PyPI usando o nome decompyle3::

Para instalar a partir do código fonte, este projeto usa setup.py, então segue a rotina padrão Python::

ou::

Um Makefile GNU também é fornecido, então :code:make install (possivelmente como root ou sudo) fará os passos acima.

Executando Testes

::

make check

Um makefile GNU foi adicionado para suavizar a configuração e execução do comando certo, e executar testes do mais rápido ao mais lento.

Se tiver remake_ instalado, pode ver a lista de todas as tarefas incluindo testes via :code:remake --tasks

Uso

Execute

::

$ decompyle3 arquivo-python-compilado-pyc-ou-pyo

Para ajuda de uso:

::

$ decompyle3 -h

Verificação

Se quiser verificação de sintaxe Python da correção do processo de descompilação, adicione a opção :code:--syntax-verify. No entanto, como a sintaxe do Python muda. Deve usar esta opção se o bytecode for o bytecode correto para o interpretador Python que irá verificar a sintaxe.

Também pode comparar os resultados com outro descompilador Python como unpyc37_. Como eles funcionam de forma diferente, bugs aqui muitas vezes não estão lá, e vice-versa.

Há uma classe interessante desses programas que está prontamente disponível para dar verificação mais forte: aqueles programas que, quando executados, testam a si mesmos. Nosso conjunto de testes inclui estes.

E o Python vem com outro conjunto de programas assim: seu conjunto de testes para a biblioteca padrão. Temos algum código em :code:test/stdlib para facilitar este tipo de verificação também.

Bugs/Restrições Conhecidos

Suportamos apenas versões lançadas, não versões candidatas. Note no entanto que a magic de uma versão lançada é geralmente a mesma que a última versão candidata antes do lançamento.

Também não lidamos com PJOrion_ ou código obfusado de outra forma. Para PJOrion, tente: PJOrion Deobfuscator_ para desembaralhar o bytecode e obter bytecode válido antes de usar esta ferramenta; pydecipher_ pode ajudar com isso.

Este programa não pode descompilar arquivos EXE do Microsoft Windows criados por Py2EXE_, embora possamos provavelmente descompilar o código depois de extrair o bytecode corretamente. Pydeinstaller <https://github.com/charles-dyfis-net/pydeinstaller>_ pode ajudar a desempacotar empacotadores Pyinstaller.

O tratamento de listas patologicamente longas de expressões ou instruções é lento. Não lidamos com Cython_ ou MicroPython, que não usam bytecode.

Existem inúmeros bugs na descompilação. E isso é verdade para todos os outros descompiladores CPython que encontrei, mesmo aqueles que afirmavam ser "perfeitos" em alguma versão específica como 2.4.

À medida que o Python progride, a descompilação também se torna mais difícil porque a compilação é mais sofisticada e a linguagem em si é mais sofisticada. Suspeito que haverá menos tentativas ad-hoc como unpyc37_ (que é baseado num descompilador 3.3) simplesmente porque é mais difícil fazê-lo. A boa notícia, pelo menos do meu ponto de vista, é que acho que entendo o que é preciso para abordar os problemas de uma forma mais robusta. Mas agora, até que o projeto seja melhor financiado, não pretendo fazer nenhum esforço sério para suportar as versões Python 3.8 ou 3.9, incluindo bugs que possam surgir. Imagino que em algum momento possa me interessar por isso.

Pode encontrar bugs facilmente executando os testes contra o conjunto de testes padrão que o Python usa para se verificar. A qualquer momento, existem dezenas de problemas conhecidos que estão bastante isolados e que poderiam ser resolvidos se alguém dedicasse tempo para isso. O problema é que não há muitas pessoas que têm trabalhado na correção de bugs.

Pode encontrar um bug que queira reportar. Por favor, faça-o. Mas esteja ciente de que pode não receber a minha atenção por um tempo. Se patrocinar ou apoiar o projeto de alguma forma, priorizarei os seus problemas acima da fila de outras coisas que possa estar a fazer. Em situações raras, posso fazer uma descompilação manual de bytecode por uma taxa. No entanto, isso é caro, geralmente além do que a maioria das pessoas está disposta a gastar.

Veja Também

• https://github.com/andrew-tavera/unpyc37/ : fork indireto de https://code.google.com/archive/p/unpyc3/ Os projetos acima usam uma técnica de descompilação diferente da usada aqui. As instruções são percorridas. Algumas instruções usam a pilha para gerar strings, outras não. Como o fluxo de controle não é tratado diretamente, também sofre dos mesmos problemas que os vários programas uncompyle e decompyle.
• https://github.com/rocky/python-xdis : Desmontador multi-versão Python
• https://github.com/rocky/python-xasm : Montador multi-versão Python
• https://github.com/rocky/python-decompile3/wiki : Documentos Wiki que descrevem o código e aspetos dele em mais detalhe

.. |buildstatus| image:: https://dl.circleci.com/status-badge/img/gh/rocky/python-decompile3/tree/master.svg?style=svg :target: https://dl.circleci.com/status-badge/redirect/gh/rocky/python-decompile3/tree/master .. |packagestatus| image:: https://repology.org/badge/vertical-allrepos/python:uncompyle6.svg :target: https://repology.org/project/python:decompyle3/versions .. _Cython: https://en.wikipedia.org/wiki/Cython .. _MicroPython: https://micropython.org .. _uncompyle6: https://pypi.python.org/pypi/uncompyle6 .. _python-control-flow: https://github.com/rocky/python-control-flow .. _trepan: https://pypi.python.org/pypi/trepan3k .. _compiler: https://pypi.python.org/pypi/spark_parser .. _HISTORY: https://github.com/rocky/python-decompile3/blob/master/HISTORY.md .. _debuggers: https://pypi.python.org/pypi/trepan3k .. _remake: https://bashdb.sf.net/remake .. _unpyc37: https://github.com/andrew-tavera/unpyc37/ .. _this: https://github.com/rocky/python-decompile3/wiki/Deparsing-technology-and-its-use-in-exact-location-reporting .. |TravisCI| image:: https://travis-ci.org/rocky/python-decompile3.svg :target: https://travis-ci.org/rocky/python-decompile3 .. |CircleCI| image:: https://circleci.com/gh/rocky/python-decompile3.svg?style=svg :target: https://circleci.com/gh/rocky/python-decompile3

.. _PJOrion: http://www.koreanrandom.com/forum/topic/15280-pjorion-%D1%80%D0%B5%D0%B4%D0%B0%D0%BA%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5-%D0%BA%D0%BE%D0%BC%D0%BF%D0%B8%D0%BB%D1%8F%D1%86%D0%B8%D1%8F-%D0%B4%D0%B5%D0%BA%D0%BE%D0%BC%D0%BF%D0%B8%D0%BB%D1%8F%D1%86%D0%B8%D1%8F-%D0%BE%D0%B1%D1%84 .. _Deobfuscator: https://github.com/extremecoders-re/PjOrion-Deobfuscator .. _Py2EXE: https://en.wikipedia.org/wiki/Py2exe .. |Supported Python Versions| image:: https://img.shields.io/pypi/pyversions/decompyle3.svg .. |Latest Version| image:: https://badge.fury.io/py/decompyle3.svg :target: https://badge.fury.io/py/decompyle3 .. |PyPI Installs| image:: https://pepy.tech/badge/decompyle3/month .. _pydecipher: https://github.com/mitre/pydecipher