Code source de « Violent Python » en Python 3

Code source du livre « Violent Python » de TJ O'Connor. Le code a été entièrement converti en Python 3, reformaté pour être conforme aux normes PEP8 et refactorisé afin d'éliminer les problèmes de dépendances liés à l'implémentation de bibliothèques obsolètes.

Une conversion similaire à celle-ci a été rendue disponible par moi-même sur le code source du livre « Black Hat Python », de Justin Seitz. Allez y jeter un œil ici si vous ne l'avez pas encore fait.

Utilisation

Créez simplement un nouveau répertoire (DIR) pour le projet, créez un nouvel environnement virtuel ou venv pour celui-ci (recommandé), clonez ce dépôt à l'aide de git clone et installez les dépendances avec 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

Remarques

• Les répertoires et fichiers ont été nommés de manière à être facilement liés au contenu présenté dans chaque chapitre.
• L'utilisation fréquente de la concaténation de chaînes par l'auteur a été remplacée par l'interpolation de chaînes afin d'améliorer la lisibilité et de se conformer à une norme plus moderne.
• Les noms de fichiers, variables, fonctions, classes et méthodes respectent désormais les normes de nommage PEP 8.
• La bibliothèque optparse, désormais obsolète, a été remplacée par argparse dans l'ensemble du code source. Tout l'analyse des arguments est désormais contenue dans le cadre d'exécution __main__ de chaque fichier. Tous les arguments CLI qui étaient obligatoires pour l'exécution des scripts mais traités comme facultatifs dans le code d'origine sont désormais implémentés comme positionnels. Une invite usage est désormais disponible pour tous les scripts qui utilisent argparse en fournissant un argument -h à la CLI. Laisser les responsabilités d'objet frontière et de contrôleur à l'analyseur CLI n'est certainement pas le meilleur choix en termes d'architecture logicielle, mais a été laissé tel quel par nécessité de conformité à l'intention du codeur original.
• Toutes les violations de la règle PEP 8: E722 do not use bare except ont été refactorisées avec des clauses d'exception plus spécifiques.
• L'auteur a l'habitude d'ouvrir des fichiers/bases de données et de les laisser dans cet état au lieu d'appeler la méthode close() sur les objets fichier/base de données ouverts. Pour cette raison, toutes les manipulations de fichiers et de bases de données ont été refactorisées à l'aide de gestionnaires de contexte.
• L'utilisation de commentaires faisant référence à l'encodage à utiliser par l'interpréteur (à savoir # -*- coding: utf-8 -*-) a été supprimée en raison de la normalisation de UTF-8 comme encodage par défaut de Python 3 (remplaçant ASCII de Python 2).
• Bien que totalement inadapté du point de vue des meilleures pratiques, l'utilisation de variables globales a été laissée intacte afin d'éviter de lourdes divergences par rapport à la logique du code d'origine.
• Le code inclus dans le chapitre 5 du livre a été refactorisé même si, en pratique, il est au mieux historique. Une grande partie de ses fonctionnalités dépend non seulement de cas très spécifiques présentés comme exemples par l'auteur, mais aussi de l'exploitation de vulnérabilités qui ont cessé d'être réalistes ces dernières années (comme l'écoute du trafic des réseaux sans fil 802.11 qui reposent encore sur l'algorithme de sécurité WEP pour le chiffrement du trafic ou, pire, qui ne maintiennent aucune sécurité du tout) ou de l'attente absurde que le lecteur fasse l'acquisition d'un modèle spécifique de drone s'il souhaite voir le code en action. Pour éviter d'affirmer d'emblée que l'effort investi dans la lecture de ce chapitre est presque inutile, je peux ajouter qu'une certaine utilité peut toutefois être tirée du code lié à l'écoute des requêtes de sondage et de balise.
• Le code du chapitre 6 qui fait référence à Google et Twitter s'est avéré trop obsolète dans la manière de gérer les API actuelles pour valoir la peine d'être refactorisé. Si vous êtes intéressé par leur prise en charge, effectuez la refactorisation et soumettez une pull request à ce dépôt.

Refactorisation

Les fichiers non listés ci-dessous peuvent être considérés comme ayant été refactorisés d'une manière ou d'une autre, comme établi dans la section « Remarques ».