How bengornadha/lamalice-clean-archi works
This is a Clean Architecture example for registering users. The main workflow builds a validator, password hasher, serializer, and repository; registration validates input, hashes the password, creates a user, and saves it. The example then fetches the user to verify persistence. The graph includes the documented BigQuery and S3 repository alternatives; only BigQuery’s storage interaction is visible in the supplied excerpt. Other links are limited to relationships shown by excerpts or the source index.
Main entry points: register_user.py Register user · user_validator.py User validator · main.py Example runner · user_serializer.py User serializer
Components 21
Entry points
- Example runner
main.py - DI runner
main_injection_dependances.py - User input
presentation/input/user_input.py
Registration domain
- Register user
application/register_user.py - User validator
domain/services/user_validator.py - Password validator
domain/services/user_password_validator.py - Registered user
domain/entities/user.py - Email value
domain/value_objects/email.py - User not found
domain/exceptions/user.py
Interfaces
- Hasher contract
interfaces/password_hasher.py - Repository contract
interfaces/user_repository.py - Serializer contract
interfaces/user_serializer.py - Validator contracts
interfaces/validator/validator.py
Infrastructure adapters
- Bcrypt hasher
infrastructures/hashers/hashers.py - In-memory repository
infrastructures/persistence/user_repository.py - BigQuery repository
infrastructures/persistence/user_repository_bigquery.py - S3 repository
infrastructures/persistence/user_repository_s3.py - User serializer
infrastructures/serializers/user_serializer.py - Serialized user
infrastructures/serializers/user_serialized.py
Other components
- Caller
- BigQuery
Connections 35
- Caller → Example runner: runs
README.md - Caller → DI runner: runs
README.md - Example runner → User input: creates
main.py - Example runner → Register user: builds and calls
main.py - Example runner → User validator: configures
main.py - Example runner → Bcrypt hasher: configures
main.py - Example runner → In-memory repository: configures and fetches
main.py - Example runner → User serializer: configures
main.py - DI runner → Register user: configures
main_injection_dependances.py - DI runner → User validator: configures
main_injection_dependances.py - Register user → User input: accepts
application/register_user.py - Register user → User validator: validates with
application/register_user.py - Register user → Hasher contract: hashes via
application/register_user.py - Register user → Repository contract: saves via
application/register_user.py - Register user → Registered user: creates
application/register_user.py - Register user → Email value: constructs
application/register_user.py - User validator → User input: validates
domain/services/user_validator.py - User validator → Repository contract: checks existence
domain/services/user_validator.py - User validator → Email value: constructs
domain/services/user_validator.py - User validator → Password validator: validates password
domain/services/user_validator.py - User validator → Validator contracts: implements
domain/services/user_validator.py - Bcrypt hasher → Hasher contract: implements
infrastructures/hashers/hashers.py - In-memory repository → Repository contract: implements
infrastructures/persistence/user_repository.py - BigQuery repository → Repository contract: implements
infrastructures/persistence/user_repository_bigquery.py - S3 repository → Repository contract: implements
infrastructures/persistence/user_repository_s3.py - In-memory repository → User serializer: serializes with
infrastructures/persistence/user_repository.py - In-memory repository → Serialized user: stores
infrastructures/persistence/user_repository.py - In-memory repository → User not found: raises
infrastructures/persistence/user_repository.py - BigQuery repository → User serializer: serializes with
infrastructures/persistence/user_repository_bigquery.py - BigQuery repository → Serialized user: constructs
infrastructures/persistence/user_repository_bigquery.py - BigQuery repository → BigQuery: queries and inserts
infrastructures/persistence/user_repository_bigquery.py - User serializer → Serializer contract: implements
infrastructures/serializers/user_serializer.py - User serializer → Serialized user: produces and reads
infrastructures/serializers/user_serializer.py - User serializer → Registered user: converts
infrastructures/serializers/user_serializer.py - Registered user → Email value: contains
domain/entities/user.py