Исходный код Python 3 «Violent Python»

Исходный код книги «Violent Python» Ти Джей О'Коннора. Код полностью преобразован в Python 3, переформатирован в соответствии со стандартами PEP8 и реорганизован для устранения проблем с зависимостями, связанных с использованием устаревших библиотек.

Аналогичное преобразование было выполнено мною для исходного кода книги «Black Hat Python» Джастина Зейтца. Ознакомьтесь с ним здесь, если вы ещё этого не сделали.

Использование

Просто создайте новый каталог (DIR) для проекта, создайте новую виртуальную среду или venv (рекомендуется), клонируйте этот репозиторий с помощью git clone и установите зависимости с помощью 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

Примечания

• Каталоги и файлы названы так, чтобы их можно было легко соотнести с содержанием, представленным в каждой главе.
• Частое использование автором конкатенации строк заменено на интерполяцию строк для обеспечения большей читаемости и соответствия более современному стандарту.
• Имена файлов, переменных, функций, классов и методов теперь соответствуют стандартам именования PEP 8.
• Устаревшая библиотека optparse заменена на argparse во всём исходном коде. Весь разбор аргументов теперь находится в области выполнения __main__ для каждого файла. Все аргументы командной строки, которые были обязательны для выполнения скриптов, но в исходном коде рассматривались как необязательные, теперь реализованы как позиционные. Для всех скриптов, использующих argparse, теперь доступна подсказка usage при передаче аргумента -h в CLI. Передача обязанностей как boundary, так и controller объекта парсеру CLI, безусловно, не является лучшим выбором с точки зрения архитектуры программного обеспечения, но оставлено как есть из-за необходимости соответствия замыслу исходного автора.
• Все нарушения PEP 8: E722 do not use bare except были переработаны с использованием более конкретных предложений исключений.
• У автора есть привычка открывать файлы/базы данных и оставлять их в таком состоянии вместо вызова метода close() для открытых объектов файлов/баз данных. По этой причине все случаи манипуляций с файлами и базами данных были переработаны с использованием менеджеров контекста.
• Использование комментариев со ссылкой на кодировку, используемую интерпретатором (а именно # -*- coding: utf-8 -*-), было исключено из-за стандартизации UTF-8 в качестве кодировки по умолчанию для Python 3 (заменяет ASCII из Python 2).

Рефакторинг

Файлы, не указанные ниже, можно считать переработанными в той или иной степени, как установлено в разделе «Примечания».

• chapter01/vuln_scanner.py был структурирован таким образом, что несуществующий файл приводил к исключению OSError во время выполнения. По этой причине управление итерацией, вызывающее check_vulns(), было перемещено в условный оператор, определённый в основной функции.
• chapter02/nmap_scan.py реализовывал основную функцию исключительно для вызова устаревшей библиотеки optparse, которая была заменена на argparse. Из-за этого основная функция была удалена. Структура управления итерацией, которая была частью вызова optparse в исходном коде, была реализована таким образом, что новый вызов nmap выполнялся для каждого сканируемого порта. Итерация была перемещена в функцию nmap_scan, чтобы избежать лишних циклов.
• chapter02/ssh_command.py: код инициализации был перемещён в область выполнения __main__. Имена переменных, используемых во внешней области видимости, которые ранее конфликтовали с именами параметров функций, были изменены. Возвращаемая информация приглашения была изначально закодирована, а теперь декодирована для улучшения читаемости.
• chapter02/ssh_brute.py импортировал как отдельную библиотеку, но на самом деле это библиотека внутри библиотеки . Ошибка приводила к и была исправлена. Сам код, представленный в книге, был переполнен ошибками отступов, что делало его непригодным для использования, и приведён в рабочее состояние.

Переводы

Вклад на других языках можно посмотреть здесь:

• Перевод на турецкий от Bedirhan Budak

Содействие

Руководствуясь здравым смыслом, сначала попробуйте обсудить изменение, которое вы хотите внести в этот репозиторий, через issue.

1. Убедитесь, что вносимые вами модификации действительно приводят к pull request. Изменение одной или двух строк следует запрашивать через issue вместо этого.
2. При необходимости обновите файл README.md, указав сведения об изменениях структуры проекта.
3. Убедитесь, что сообщения коммитов, содержащие модификации, соответствуют стандарту. Если вы не знаете, как это сделать, здесь отличный справочник.
4. Ваш запрос будет рассмотрен как можно скорее (обычно в течение 48 часов).