Skip to main content
Help the Python Software Foundation raise $60,000 USD by December 31st!  Building the PSF Q4 Fundraiser

A Python toolkit for applications driven by the Clean Architecture

Project description


GitHub tag development status Build Status codecov Join the chat at

python-clean-architecture is a Python library aiming to equip you with a set of patterns to come closer to The Clean Architecture and a toolbox of adapters for integration with popular frameworks. Using them can make your code more focused on the knowledge you are trying to embody with your application and separation from technical details. A nice side-effects of this approach is an ease of plugging your application to a different variants of your infrastructure and lightweight testing the key fragments of your codebase.

Development Status

The library is still in a planning phase, so expect much refactorization and many changes to its API (Stage 2 - Pre-Alpha Status).


Tiers of the architecture

  • Data-level logic: data description objects, schemas, serialization, predicates, formulae.
  • Domain-specific logic: bounded contexts (aka domains), entities, value objects, aggregates, repositories, policies, factories, domain services.
  • Application-specific logic: use-cases, application services, gateways, CQRS stacks, sagas. Task-, event- and data-driven applications, commands.


One of the main goal of this library is to provide integration with adequate integrations:

  • TinyDb as DAO
  • more to come soon...

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for python-clean-architecture, version 0.0.3
Filename, size File type Python version Upload date Hashes
Filename, size python_clean_architecture-0.0.3-py3-none-any.whl (68.7 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size python-clean-architecture-0.0.3.tar.gz (49.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page