Tiferet – Domain-Driven Design, beautifully balanced
Tiferet is a Python framework that brings Domain-Driven Design into focus with elegance and clarity.
Inspired by the Kabbalistic principle of harmony and beauty in balance, Tiferet helps you turn complex business logic into maintainable, configuration-driven applications — where purpose, structure, and execution feel naturally aligned.
At a glance
- Blueprints-first app entry point via
build_app(exported asApp) - Domain events as the core unit of behavior
- YAML for features, workflows, dependency injection, errors, CLI commands
- Clean layering: domain objects • aggregates • transfer objects • services
- Structured, multilingual errors built-in
- Easy to extend to CLI, web, scripts, TUI, … Current status: 2.0.0b3 (pre-release – actively evolving toward stable v2)
Quick Start – Add two numbers in ~3 minutes
# 1. Set up environment
python3 -m venv tiferet-demo && source tiferet-demo/bin/activate
pip install tiferet
Create these files in your project folder:
demo.py
from tiferet import App
app = App(
'basic_calc',
app_yaml_file='config.yml',
) # App is the build_app alias
result = app.run(
feature_id='calc.add',
data={'a': 19, 'b': 23},
)
print(f"19 + 23 = {result}") # → 42
config.yml
interfaces:
basic_calc:
name: Basic Calculator
description: Basic calculator interface
services:
add_number_event:
module_path: app.events.calc
class_name: AddNumber
features:
calc:
add:
name: Add Numbers
commands:
- service_id: add_number_event
app/events/calc.py
(the domain event itself – very minimal)
from tiferet.events import DomainEvent
class AddNumber(DomainEvent):
def execute(self, a: int, b: int, **kwargs) -> int:
return a + b
Run:
python demo.py
You should see:
19 + 23 = 42
→ Want a full calculator (add, subtract, multiply, divide, sqrt, …) with CLI, validation and proper error handling?
→ See the working example → or follow the step-by-step Tutorial →
Why Tiferet?
- Configuration as code — features, DI, errors, CLI all live in YAML
- Domain logic stays pure — focused events & aggregates
- Infrastructure is injectable — file/db/utils behind clean service contracts
- Built for evolution — today CLI, tomorrow FastAPI or TUI
- Strong testability — events are easy to invoke in isolation
Documentation & Guides
Core architecture
- Code Style & Artifact Comments
- Blueprints (build_app)
- Domain Objects
- Domain Events
- Aggregates & Transfer Objects (Mappers)
- Service Interfaces
- Dependency Injection (ServiceProvider)
- Repositories
- Utilities (File/Yaml/Json/Csv/Sqlite)
Practical Guides
Domain Guides
- Application Management
- Dependency Injection
- Feature Workflows
- Error Handling
- CLI Integration
- Logging
Event Guides
- Application Events
- Dependency Injection Events
- Feature Events
- Error Events
- CLI Integration Events
- Logging Events
- SQLite Events
Utility Guides
Other Component Guides
Tutorial
→ Build a complete Calculator (events + CLI + configs)
Contributing
We welcome bug reports, documentation improvements, feature ideas, and early adopters.
See CONTRIBUTING.md for the workflow (issues → TRD → feature branch → PR).
Questions, feedback, or just want to say hi?
Open an issue or reach out via email: andrew@greatstrength.me
Let's build software that feels as good as it works.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file tiferet-2.0.0.tar.gz.
File metadata
- Download URL: tiferet-2.0.0.tar.gz
- Upload date:
- Size: 119.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0f4d6bfe16bdd09472c5474faacc9e947e973ca5680a711887ca35b64f3dab7a
|
|
| MD5 |
aa3814c30ec950e61dff4591e0556b64
|
|
| BLAKE2b-256 |
a33c9da3dcae94aecd50625fc252f3182b169a61dfe17b126427d58905a3400a
|
Provenance
The following attestation bundles were made for tiferet-2.0.0.tar.gz:
Publisher:
python-publish.yml on greatstrength/tiferet
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
tiferet-2.0.0.tar.gz -
Subject digest:
0f4d6bfe16bdd09472c5474faacc9e947e973ca5680a711887ca35b64f3dab7a - Sigstore transparency entry: 2458105570
- Sigstore integration time:
-
Permalink:
greatstrength/tiferet@9930411117048edcf4e23f80e5aded6701aaa3d6 -
Branch / Tag:
refs/tags/v2.0.0 - Owner: https://github.com/greatstrength
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
python-publish.yml@9930411117048edcf4e23f80e5aded6701aaa3d6 -
Trigger Event:
release
-
Statement type:
File details
Details for the file tiferet-2.0.0-py3-none-any.whl.
File metadata
- Download URL: tiferet-2.0.0-py3-none-any.whl
- Upload date:
- Size: 163.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8cdc3f5bf87972da7218404f37c8723851ad6de75df88ba918ee687e84c78abb
|
|
| MD5 |
c1ba02286f3e882dd77738fa0c50f0df
|
|
| BLAKE2b-256 |
d7dcfa16ef48eb33546b100c24d9c4203b9ab842cb37ae647f4793329ad8fa74
|
Provenance
The following attestation bundles were made for tiferet-2.0.0-py3-none-any.whl:
Publisher:
python-publish.yml on greatstrength/tiferet
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
tiferet-2.0.0-py3-none-any.whl -
Subject digest:
8cdc3f5bf87972da7218404f37c8723851ad6de75df88ba918ee687e84c78abb - Sigstore transparency entry: 2458105688
- Sigstore integration time:
-
Permalink:
greatstrength/tiferet@9930411117048edcf4e23f80e5aded6701aaa3d6 -
Branch / Tag:
refs/tags/v2.0.0 - Owner: https://github.com/greatstrength
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
python-publish.yml@9930411117048edcf4e23f80e5aded6701aaa3d6 -
Trigger Event:
release
-
Statement type:
