tiferet 2.0.0b8

A multi-purpose application framework embodying beauty in form.

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 as App)
• 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.0 (stable release)

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_config='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

• File Loader
• YAML Loader
• JSON Loader
• CSV Loader
• Sqlite Connector

Other Component Guides

• Interfaces
• Mappers (Aggregates & Transfer Objects)
• Repositories

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: [e-mail]

Let's build software that feels as good as it works.