pefile é um módulo Python para ler e trabalhar com arquivos PE (Portable Executable).
pefile é um módulo Python multiplataforma para analisar e trabalhar com arquivos Portable Executable (PE). A maior parte das informações contidas nos cabeçalhos de arquivos PE é acessível, assim como todos os detalhes e dados das seções.
As estruturas definidas nos arquivos de cabeçalho do Windows estarão acessíveis como atributos na instância PE. A nomenclatura de campos/atributos procurará seguir o esquema de nomes desses cabeçalhos. Apenas atalhos adicionados por conveniência se afastarão dessa convenção.
pefile exige um entendimento básico do layout de um arquivo PE — com ele, é possível explorar quase todos os recursos do formato de arquivo PE.
Para instalar o pefile via pip:
pip3 install pefile
este repositório contém um grande corpus de testes comprimido, e seu histórico git mantém versões mais antigas desse corpus. Um clone completo pode, portanto, ser muito maior do que a própria biblioteca. use a instalação via pip acima se você precisar apenas da biblioteca.
para trabalhar no código-fonte sem baixar o corpus de testes ou seu histórico:
git clone --depth 1 --filter=blob:none --sparse https://github.com/erocarrera/pefile.git
cd pefile
git sparse-checkout set ordlookup
isso verifica a biblioteca e suas tabelas de consulta ordinal. para incluir os testes, execute git sparse-checkout set ordlookup tests; isso também baixa o grande corpus de testes. --depth 1 omite o histórico mais antigo, e clones filtrados buscam conteúdos adicionais de arquivos quando necessário.
Algumas das tarefas que o pefile torna possíveis são:
Consulte os Exemplos de Uso para alguns trechos de código que demonstram como usar o pefile.
Aqui estão alguns exemplos de como é um dump produzido com o pefile para diferentes tipos de arquivos:
Para trabalhar com binários autenticados, incluindo assinaturas Authenticode, consulte o projeto verify-sigs.
O pefile roda em vários pipelines que escaneiam centenas de milhares de novos arquivos PE todos os dias e, embora não seja perfeito, tornou-se bastante robusto ao longo do tempo. Dito isso, pequenas falhas são encontradas de vez em quando. Se você encontrar um PE que não parece ser processado corretamente, por favor, reporte! Isso ajudará a tornar o pefile um pouquinho mais poderoso.
O pefile é autocontido. O módulo não tem dependências; é independente de endianness; e funciona no Windows, macOS e Linux.
O executor de testes fica em tests/pefile_test.py. Suas amostras de PE e dumps
esperados vêm do repositório separado pefile-tests.
Clone esse repositório em pefile-tests/ na raiz deste
checkout e então execute:
python -m pip install -e ".[dev]"
python -m pytest tests
O CI faz checkout do corpus no mesmo local e executa este módulo de teste através do tox. O corpus permanece em seu próprio repositório para que amostras binárias e dumps esperados possam ser atualizados de forma independente.
PDFs de pôsteres que descrevem o formato de arquivo PE:
Os links a seguir fornecem informações detalhadas sobre o formato PE e suas estruturas.