Código-fonte de "Violent Python" em Python 3

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 descontinuadas.

Uma conversão semelhante a esta foi disponibilizada por mim no código-fonte do livro "Black Hat Python", de Justin Seitz. Confira aqui se você ainda não o fez.

Uso

Basta criar um novo diretório (DIR) para o projeto, criar um novo ambiente virtual ou venv para ele (recomendado), clonar este repositório usando git clone e instalar os requisitos usando pip install.

user@host:~/DIR$ git clone https://github.com/EONRaider/violent-python3
user@host:~/DIR$ python3 -m venv venv
user@host:~/DIR$ source venv/bin/activate
(venv) user@host:~/DIR$ pip install -r requirements.txt

Notas

• Os diretórios e arquivos foram nomeados de forma que possam ser facilmente relacionados ao conteúdo apresentado em cada capítulo.
• O uso frequente de concatenação de strings pelo autor foi substituído por interpolação de strings para permitir maior legibilidade e estar em conformidade com um padrão mais moderno.
• Nomes de arquivos, variáveis, funções, classes e métodos agora estão em conformidade com os padrões de nomenclatura do PEP 8.
• A biblioteca optparse, agora obsoleta, foi substituída por argparse em todo o código-fonte. Todo o parsing de argumentos agora está contido no escopo de execução __main__ para cada arquivo. Todos os argumentos de CLI que eram obrigatórios para a execução dos scripts, mas eram tratados como opcionais no código original, agora são implementados como posicionais. Um prompt de uso agora está disponível para todos os scripts que usam argparse ao fornecer um argumento -h para a CLI. Deixar as responsabilidades tanto de boundary quanto de controller para o parser da CLI definitivamente não é a melhor escolha em termos de arquitetura de software, mas foi mantido como está devido à necessidade de conformidade com a intenção do codificador original.
• Todas as ocorrências de violações de PEP 8: E722 do not use bare except foram refatoradas com cláusulas de exceção mais específicas.
• O autor tem o hábito de abrir arquivos/bancos de dados e deixá-los nesse estado em vez de chamar o método close() nos objetos de arquivo/banco de dados abertos. Por esse motivo, todas as instâncias de manipulação de arquivos e bancos de dados foram refatoradas usando gerenciadores de contexto.
• O uso de comentários fazendo referência à codificação a ser usada pelo interpretador (a saber, # -*- coding: utf-8 -*-) foi eliminado devido à padronização do UTF-8 como codificação padrão para Python 3 (substituindo o ASCII do Python 2).

Refatoração

Os arquivos não listados abaixo podem ser considerados como refatorados de uma forma ou de outra, conforme estabelecido na seção "Notas".

• chapter01/vuln_scanner.py foi estruturado de tal forma que um arquivo inexistente levaria a uma exceção OSError em tempo de execução. Por esse motivo, o controle de iteração que chama check_vulns() foi movido para dentro da instrução condicional definida na função principal.
• chapter02/nmap_scan.py implementava uma função principal unicamente com o propósito de chamar a biblioteca obsoleta optparse, que foi substituída por argparse. Por causa disso, a função principal foi removida. Uma estrutura de controle de iteração que fazia parte da chamada optparse no código original foi implementada de tal forma que uma nova chamada ao nmap era executada para cada porta varrida. A iteração foi movida para dentro da função nmap_scan para evitar o desperdício de ciclos.
• chapter02/ssh_command.py teve seu código de inicialização movido para o escopo de execução __main__. Os nomes das variáveis usadas no escopo externo que costumavam conflitar com os nomes dos parâmetros das funções foram alterados. As informações do prompt de retorno eram originalmente codificadas e agora foram decodificadas para proporcionar melhor legibilidade.

Traduções

Contribuições em outros idiomas podem ser conferidas aqui:

• Traduzido para Turco por Bedirhan Budak

Contribuindo

Como questão de bom senso, primeiro tente discutir a mudança que deseja fazer neste repositório por meio de uma issue.

1. Garanta que as modificações que deseja introduzir realmente levem a um pull request. A alteração de uma ou duas linhas deve ser solicitada por meio de uma issue em vez disso.
2. Se necessário, atualize o arquivo README.md com detalhes relativos a mudanças na estrutura do projeto.
3. Certifique-se de que as mensagens de commit que incluem as modificações sigam um padrão. Se você não souber como proceder, aqui está uma ótima referência sobre como fazer isso.
4. Seu pedido será revisado o mais rápido possível (geralmente dentro de 48 horas).