Python Splitter

Python Splitter est un outil orienté développeur destiné à convertir de gros scripts Python en unités modulaires adaptées au packaging et à la collaboration. Il s’adresse aux ingénieurs, data scientists et ingénieurs d’automatisation qui maintiennent des bases de code dépassant le cadre d’un seul fichier. En produisant des frontières de module cohérentes, il réduit la charge cognitive lors des revues de code et simplifie la gestion des dépendances, les tests et les workflows de déploiement.
Il analyse le code source Python via l’AST, identifie les définitions au niveau supérieur, les imports et la logique __main__. Il prend en charge la séparation par fonction ou par classe, par des régions marquées ou par des règles de regroupement personnalisées. Le processus préserve les imports et les références relatives, crée des fichiers module séparés et, facultativement, génère __init__.py pour former un package.
Par rapport à une séparation manuelle, l’outil offre des résultats déterministes, gère les collisions de noms avec un renommage configurable et exporte éventuellement un bundle de package prêt à la distribution. Il est particulièrement utile pour le refactoring de bibliothèques héritées, la création de micro-packs ou l’isolation du code expérimental dans les projets de données. Il prend aussi en charge des flux éducatifs en montrant comment décomposer de gros scripts en composants réutilisables.
Les fonctions clés incluent la séparation basée sur l’AST, des frontières configurables, la préservation des imports et des dépendances, l’extraction optionnelle de docstrings et une structure de sortie conforme aux conventions habituelles de packaging Python. Les cas limites comme les imports dynamiques, l’utilisation de eval/exec et les dépendances circulaires sont signalés, avec des retours sûrs vers une séparation ligne par ligne. L’outil n’exécute pas le code et n’exécute pas de tests, et suppose que l’entrée respecte la syntaxe Python après prétraitement.