Architectures propres en Python

Introduction

Le livre de Leonardo Giordani « Clean Architectures in Python » (2021, 258 p.) n'est pas un énième guide sur la syntaxe ou les bibliothèques Python. C'est une plongée profonde dans le monde de la conception logicielle, destinée aux développeurs qui souhaitent construire des systèmes véritablement maintenables, testables et évolutifs. L'auteur, connu pour ses articles sur l'architecture propre et Python, propose une approche pratique pour appliquer les principes de Robert Martin (Uncle Bob) dans le contexte de l'écosystème Python.

Le livre est paru en 2021, mais ses idées restent pertinentes aujourd'hui, alors que Python est de plus en plus utilisé non seulement pour des scripts et des prototypes, mais aussi pour construire des applications d'entreprise complexes, des microservices et des systèmes à forte charge.

De quoi parle ce livre ?

Le thème principal du livre est l'application de l'architecture propre (Clean Architecture) et des concepts associés : la conception pilotée par le domaine (DDD), l'architecture hexagonale (Ports and Adapters) et les principes SOLID. Giordani ne se contente pas de reformuler les idées de Martin, il les adapte aux spécificités de Python, montrant comment éviter les erreurs typiques et comment construire une architecture en couches où la logique métier ne dépend pas des frameworks, des bases de données ou des API externes.

Le livre comprend plusieurs parties : de l'introduction aux concepts de base (dépendances, inversion de contrôle, injection de dépendances) à la construction d'un exemple d'application complet utilisant des repositories, une couche de service et des tests unitaires. Une attention particulière est accordée aux tests — l'auteur montre comment une architecture propre rend les tests simples et rapides.

À qui s'adresse ce livre ?

• Développeurs Python de niveau intermédiaire, qui savent déjà écrire du code mais souhaitent comprendre comment concevoir l'architecture d'applications qui ne se transforment pas en « grosse boule de boue » après six mois de développement.
• Chefs d'équipe et architectes, qui recherchent des exemples pratiques de mise en œuvre du DDD et de l'architecture hexagonale dans des projets Python.
• Développeurs passant d'autres langages (Java, C#) à Python et souhaitant appliquer les meilleures pratiques de conception sans tomber dans une abstraction excessive.
• Tous ceux qui veulent écrire du code testable et comprendre comment organiser un projet pour que les tests ne soient pas une contrainte, mais un outil de confiance.

Que va apprendre le lecteur ?

• Les principes SOLID dans le contexte de Python : comment définir correctement des interfaces (via des classes de base abstraites ou des protocoles), comment éviter les dépendances cycliques.
• L'inversion de contrôle et l'injection de dépendances : DI manuelle vs frameworks (comme dependency_injector), quand utiliser quoi.
• L'architecture hexagonale : comment séparer la logique métier des adaptateurs (bases de données, frameworks web, API externes).
• La conception pilotée par le domaine (DDD) : agrégats, entités, objets-valeurs, repositories et services du domaine.
• Les tests : comment écrire des tests unitaires rapides pour la logique métier, sans lancer de base de données ni de serveur HTTP.
• Un exemple pratique : construction d'une application simple de gestion de tâches (todo list) à partir de zéro, en parcourant toutes les étapes — de la modélisation du domaine à l'implémentation des adaptateurs.

Points forts du livre

1. Orientation pratique. Contrairement à de nombreux livres sur l'architecture qui restent au niveau des abstractions, Giordani fournit du code Python concret. Vous ne lisez pas seulement des principes, vous voyez comment ils sont implémentés dans un projet réel. Chaque chapitre contient des exemples que vous pouvez exécuter et modifier.

2. Adaptation à Python. L'auteur n'essaie pas de transposer aveuglément les patrons Java en Python. Il montre comment utiliser le typage dynamique, les protocoles (PEP 544) et d'autres fonctionnalités du langage pour simplifier l'architecture. Par exemple,