✨ Python tools for the Polylith Architecture ✨

A repo containing tooling support for the Polylith Architecture in Python.

What's Polylith? 🤔

Polylith is an architecture (with tooling support) originally built for Clojure. The code in this repo brings Polylith to Python.

From the official Polylith Architecture docs:

... Polylith is a software architecture that applies functional thinking at the system scale. It helps us build simple, maintainable, testable, and scalable backend systems. ...

Polylith is using a components-first architecture. Similar to LEGO, components are building blocks. A component can be shared across apps, serverless functions and microservices.

Documentation 📚

Have a look at the Python-specific documentation. You will find installation, setup, usage guides and more.

Polylith for Python? 🐍

This repo contains a Poetry plugin, that you can install from PyPI. The plugin will add Polylith specific tooling support to Poetry. Have a look in the Poetry Polylith Plugin project folder with details about the Poetry plugin.

Use cases

Microservices and apps 👍

The main use case is to support having one or more microservices (or apps) in a Monorepo, and share code between the services.

Libraries

Polylith for Python has support for building libraries to be published at PyPI, even if it isn't the main use case. More details about how to package libraries in the docs about Packaging & deploying.

✨ Examples ✨

Have a look at the Python Polylith Examples repository. It is a repository with an example Python setup of the Polylith Architecture. You will find examples of sharing code between different kind of projects, and developer tooling setup such as mypy and the venv.

Videos

• Python with the Polylith Architecture - an overview (about 15 minutes)
• Python Poetry Polylith Plugin - the tooling support & commands (about 13 minutes)
• The Developer Experience - developing a Dad Joke Service with Polylith (about 27 minutes)

Talks

• Python Web Conference 2023 - Microservices, Monolith, Monorepos: the differences & how nicely Polylith solves the trade offs - A Fresh Take on Monorepos in Python (about 36 minutes)

Podcasts

• Talk Python To Me: Monorepos in Python

Articles

• The last Python Architecture you will ever need?
• A Fresh Take on Monorepos in Python
• A simple & scalable Python project structure
• Aws CDK App with polylith code architecture by Yoel Benítez Fonseca
• GCP Cloud Functions with Python and Polylith
• Python FastAPI Microservices with Polylith
• Kafka messaging with Python & Polylith