Python 3 "Black Hat Python" ソースコード

ジャスティン・サイツ著『Black Hat Python』のソースコードです。コードは完全にPython 3に変換され、PEP8標準に準拠するよう再フォーマットされ、非推奨ライブラリの実装に伴う依存関係の問題を排除するためにリファクタリングされています。

本書全体で提示されているソースコードには多くの最適化を実装できた可能性がありますが、読者が適宜修正を加えられるよう、コードは可能な限りそのままにしています。現状のコードは、docstringから型ヒント、例外処理に至るまで深刻なリファクタリングの努力を要し、コンテキストマネージャのような改善は言うに及ばずですが、これらの問題自体が、実装を意図する読者にとって有益となるかもしれません。また、インデントに起因する多くのバグが存在しますが、ランタイム中に致命的なエラーを避けるために修正されています。

同様の変換は、TJ O'Connor著『Violent Python』のソースコードに対しても私自身が行っており、こちらでご確認いただけます（まだご覧になっていない場合）。

使用方法

プロジェクトをクローンするディレクトリ（DIR）を選択し、git cloneを使用してクローンし、新しい仮想環境（venv）を作成し（推奨）、pip installで要件をインストールするだけです。

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

注意事項

• 本書で提示されている一部のリストが、著者のコードリポジトリ（No Starch Pressウェブサイトから入手可能）に存在しなかったため、該当する章に追加しました。本書のコードと関連付けるために、必要に応じてファイルに正確な命名規則を適用しました。
• インタプリタによって警告を発生させていた軽微なバグは、コードの特性を変更せずに全体にわたって修正しました。
• コードを動作させるために必要な補助ファイルを該当する章に追加しました。
• 個人的な余談ですが、著者は倫理的ハッキングの活動に求められる実装の迅速さを損なうことなく、よりクリーンなコードを書くことは可能だったはずです。なぜそうしなかったのかは不明のままです。

リファクタリング

ソースコードを適切に実装し、致命的なエラーを回避するために必要だった重要なバグ修正：

• chapter02/bh_sshserver.py は test_rsa.key ファイルに含まれるRSA鍵を必要としていました。この鍵は対応するディレクトリに含まれています。
• chapter03/sniffer_ip_header_decode.py、sniffer_with_icmp.py、scanner.py はすべて、structの実装の問題により、IPパケットサイズの定義と32/64ビットアーキテクチャ間の移植性に深刻な問題がありました。これらの問題についての詳細は、こちらのStack Overflowのスレッドをご覧ください。
• chapter03/scanner.py はメンテナンスされておらず、Python 3との非互換性が多い netaddr ライブラリを使用していました。そのため、コードはリファクタリングされ、現在はPythonのstdlibのipaddressモジュールを使用しています。
• chapter04/arper.py と mail_sniffer.py は、Python 3と互換性のないscapyライブラリを使用していました。そのため、コードはリファクタリングされ、現在はライブラリを使用しています。

翻訳

他の言語での貢献はこちらで確認できます：

• トルコ語 に翻訳（Bedirhan Budak 氏）

貢献

常識として、このリポジトリに行いたい変更はまず issue で議論してください。

1. 導入したい変更が実際にプルリクエストにつながるものであることを確認してください。1行や2行の変更は、代わりに issue で依頼すべきです。
2. 必要に応じて、プロジェクト構造の変更に関する詳細をREADME.mdファイルに更新してください。
3. 修正を含むコミットメッセージが標準に従っていることを確認してください。進め方がわからない場合は、こちらが優れた参考資料です。
4. リクエストはできるだけ早く（通常48時間以内）レビューされます。