Código-fonte do livro "Violent Python" de TJ O'Connor. O código foi totalmente convertido para Python 3, reformatado para estar em conformidade com os padrões PEP8 e refatorado para eliminar problemas de dependência envolvendo a implementação de bibliotecas obsoletas.
O código-fonte de Violent Python: A Cookbook for Hackers, Forensic Analysts, Penetration Testers and Security Engineers de TJ O'Connor (Syngress, 2012), convertido de Python 2 para Python 3 e refatorado para ser executado em interpretadores e bibliotecas atuais.
Os scripts permanecem próximos às listagens impressas para que possam ser lidos lado a lado com o livro. Todas as alterações feitas durante a conversão estão documentadas em docs/CONVERSION_NOTES.md.
[!NOTE] Uma conversão complementar de Black Hat Python de Justin Seitz está disponível em EONRaider/blackhat-python3.
Python 3.11 ou mais recente. Escolha uma das seguintes configurações.
uv instala a versão correta
do Python caso você não a tenha e reproduz as versões exatas das dependências
testadas na CI a partir de uv.lock.
git clone https://github.com/EONRaider/violent-python3.git
cd violent-python3
uv sync # every chapter
uv run python chapter04/geo_ip.py -h
Cada capítulo é um grupo de dependências separado, para que você possa instalar apenas o que está lendo:
uv sync --only-group ch04 # just chapter 4
uv sync --group ch05-bluetooth # add the opt-in Bluetooth extras (Linux)
git clone https://github.com/EONRaider/violent-python3.git
cd violent-python3
python3 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -r requirements.txt # every chapter
pip install -r requirements/ch04.txt # or just one chapter
requirements*.txt contêm intervalos de versões. Para as versões exatas testadas na CI, use
requirements-lock.txt (e requirements-lock-bluetooth.txt para o grupo opcional)
da última release.
Com o pip 25.1 ou mais recente, também pode instalar o grupo de um capítulo diretamente
a partir do pyproject.toml com pip install --group ch04.
Cada release publica uma
imagem para linux/amd64 e linux/arm64 com as dependências de todos os capítulos, nmap,
tcpdump e o runtime do BlueZ pré-instalados:
docker run --rm -it ghcr.io/eonraider/violent-python3
# Chapters that sniff or forge packets need raw-socket capabilities:
docker run --rm -it --cap-add=NET_RAW --cap-add=NET_ADMIN ghcr.io/eonraider/violent-python3
# Or build it yourself:
docker build -t violent-python3 . && docker run --rm -it violent-python3
A imagem é executada como root porque a maioria dos capítulos de raw-socket precisa disso. Com apenas as
capacidades acima, o contêiner ainda isola esses scripts do host, então
adicione apenas o que um capítulo precisa. Bluetooth (capítulo 5) é diferente: ele precisa do
namespace de rede do host para alcançar o adaptador, por exemplo com
--net=host --cap-add=NET_RAW --cap-add=NET_ADMIN. Isso remove o isolamento
de rede, então o contêiner pode ver e agir sobre todo o tráfego do host. Evite
--privileged, que também dá ao contêiner acesso a todos os dispositivos do host.
Use o selo Open in GitHub Codespaces acima, ou abra a pasta no VS Code ou
JetBrains com a extensão Dev Containers. O contêiner
(.devcontainer/devcontainer.json) tem as mesmas ferramentas
da imagem Docker, além de uv, git e compiladores, e já vem com as capacidades de raw-socket
concedidas.
Alguns capítulos chamam programas externos ou precisam de bibliotecas nativas. A imagem Docker e o dev container já os incluem; em um host, instale-os você mesmo:
| Necessário para | Debian / Ubuntu / Kali | macOS (Homebrew) |
|---|---|---|
chapter02/nmap_scan.py, conficker.py | apt install nmap | brew install nmap |
| Captura de pacotes (capítulos 4-5) | apt install libpcap0.8 tcpdump | embutido |
Grupo ch05-bluetooth | apt install libbluetooth-dev | não suportado |
| Capítulo | Tópico | Grupo uv | Pacotes PyPI | Notas |
|---|---|---|---|---|
| 01 | Introdução | ch01 | standard-crypt (não Windows, Python 3.13+) | crypt foi removido da stdlib na 3.13 (PEP 594); o backport mantém o passwd_crack.py funcionando. Como o módulo original, ele envolve a crypt(3) da libc, então o passwd_crack.py não roda no Windows. |
| 02 | Testes de penetração | ch02 | pexpect, python-nmap | Binário nmap necessário. Usa SSH e FTP contra hosts que você controla. |
| 03 | Investigações forenses | ch03 | beautifulsoup4, pillow, pypdf4, requests | discover_networks.py e dump_recyclebin.py leem o registro do Windows e precisam do Windows com direitos de Administrador. Bancos de dados de exemplo do Firefox/Skype e um PDF estão incluídos. |
| 04 | Análise de tráfego de rede | ch04 | dpkt, geoip2, ipy, scapy | Arquivos .pcap de exemplo e um banco de dados GeoLite2 City de 2020 estão incluídos; substitua o banco de dados por um download atual antes de usar (veja NOTICE). A captura ao vivo precisa de root / NET_RAW. |
| 05 | Caos sem fio | ch05, ch05-bluetooth | scapy, pybluez (Linux, opt-in) | Os scripts de Wi-Fi precisam de uma placa em modo monitor. ninja_print.py precisa das bindings ObexFTP para Python 2, que não têm porta para Python 3. |
| 06 | Reconhecimento web | ch06 | beautifulsoup4, mechanicalsoup | Os scripts do Google e do Twitter miram APIs que não existem mais; veja as notas de conversão. |
| 07 | Evasão de antivírus | - | - | Apenas biblioteca padrão. |
A coluna PyPI é gerada por python tools/deps_scan.py report, que lê os
imports em cada capítulo. As notas de SO e privilégios vêm das notas de conversão
e podem estar incompletas; correções são bem-vindas.