Clean Architectures in Python

Good architecture is less about following a diagram than understanding why the parts of a system belong where they do. In Clean Architectures in Python, Leonardo Giordani makes that question concrete: he develops a Python application step by step, showing how clean architecture can organize components, limit coupling, and keep implementation choices easier to change.

See the architecture take shape

The book starts with the ideas behind clean and layered architectures, then moves from a basic example to a web application. As the example grows, Giordani explores HTTP endpoints, use cases, requests and responses, error handling, and the connections between application code and external systems.

From interfaces to real databases

Later chapters put the design into practice with PostgreSQL and MongoDB integrations. Working through both helps illustrate how interfaces can separate an application’s central logic from the details of storage. The book concludes by assembling the example in a production-ready configuration.

A thoughtful approach to design

Clean architecture brings structure and separation, but the book does not present it as a universal formula. Its discussion recognizes that additional abstraction has costs, and encourages readers to understand the reasons behind a design choice—including when a different trade-off makes more sense.

Who will find it useful?

This is a practical read for Python developers interested in software design, maintainability, and building applications whose components can be tested and replaced more independently. A working knowledge of Python is expected, along with familiarity with test-driven development, particularly unit testing and mocks. It is not aimed at readers just starting to learn the language.

For developers who learn best by following an example from its first architectural decisions through web and database integrations, Giordani’s book offers a clear path from concepts to a functioning system.