Clean Architecture IoC Project Base

Table of Contents

• Overview
• Usage
  • Prerequisites
  • Initialize project
    • Initialization inputs
• Contact
• Acknowledgements
• License

---

Overview

This project implements a clean architecture scaffolding with prototype classes for the following tech stack:

• FastAPI for RESTful API
• PostgreSQL database with SQLAlchemy ORM for data persistence
• Alembic for database migrations
• Python Dependency Injector for Inversion of Control
• Pytest for unit testing
• Testcontainers for integration testing
• Redis for caching
• Docker compose with setup for integrated development environment
• Pre-commit for code quality

Clean Architecture is a software design pattern that emphasizes the separation of concerns by organizing code into layers with distinct responsibilities. It aims to create systems that are easy to maintain, test, and evolve by keeping the business logic and application rules independent of external frameworks, databases, and user interfaces. The architecture typically includes layers such as Entities, Use Cases, Interface Adapters, and Frameworks and Drivers, each serving a specific purpose. By adhering to these principles, Clean Architecture helps in creating robust, scalable, and adaptable systems.

Dependency injection (DI) is a design pattern used to implement Inversion of Control (IoC) in software development, which helps to decouple the creation of object dependencies from their usage. By injecting dependencies into a class rather than having the class create them itself, DI promotes loose coupling and enhances code modularity. This separation of concerns makes the codebase more maintainable and testable, as it allows for easier swapping of implementations and facilitates unit testing by enabling the use of mock objects.

This project is based on the example from python-dependency-injector and contains a simple user entity with endpoints to manipulate user entity.

---

Usage

Prerequisites

• Cookiecutter

Initialize project

Initialize project using cookiecutter CLI:

cookiecutter gh:bsantanna/cleanarch-ioc-pypackage

Follow the prompts to fill in the project details.

Initialization inputs

• authors: Your Name or Your Team
• distribution_list_email: Your email address
• python_version: The version of Python to use (default: 3.11)
• base_image: The base Docker image for Python (default: python:3.11-slim)
• cache_image: The Docker image for the cache service (default: redis:alpine)
• cache_hostname: The hostname for the cache service (default: localhost)
• cache_port: The port number for the cache service (default: 6379)
• database_image: The Docker image for the database service (default: postgres:16)
• database_hostname: The hostname for the database service (default: localhost)
• database_name: The name of the database (default: your_database_name)
• database_password: The password for the database (default: postgres)
• database_port: The port number for the database service (default: 5432)
• database_username: The username for the database (default: postgres)
• network_container_port: The port number exposed by the container (default: 8000)
• network_mapped_port: The port number mapped to the host (default: 18000)
• network_name: The name of the Docker network (default: your_network_name)
• project_name: The name of your project (default: Your Project Name)
• project_slug: A URL-friendly version of the project name (default: automatically generated from project_name)
• project_description: A brief description of your project (default: A brief description of your project)
• sonar_token: The token for SonarQube (default: your_sonar_token)
• sonar_url: The URL for SonarQube (default: http://your_sonar_url)
• version: The version of your project (default: 0.1.0)

---

Contact

For questions or feedback, please contact the author via LinkedIn: Bruno Sant'Anna

---

Acknowledgements

• Clean Architecture
• Cookiecutter
• Python Dependency Injector
• FastAPI
• PostgreSQL
• Alembic
• Redis
• Pytest
• Testcontainers
• Docker
• Pre-commit

---

License

This project is licensed under the MIT License. See the LICENSE file for details.