src/dazzle_back/runtime/service_generator.py

Generated: 2026-03-30T04:38:48.214281+00:00

Commit: 615f1354a103

Language: python

Scope: dazzle_back

Purpose

Service generator - generates domain service stubs from ServiceSpec.

This module creates service classes that implement domain operations. Services handle business logic and can be customized by users.

Key Exports

• BaseService
• CRUDService
• CustomService
• ServiceFactory
• ServiceContext
• execute
• on_created
• on_updated
• on_deleted
• add_pre_create_hook
• add_pre_update_hook
• add_pre_delete_hook
• set_repository
• execute
• create
• read
• update
• delete
• list
• execute

Dependencies

Imports

• __future__.annotations
• asyncio
• builtins
• logging
• abc.ABC
• abc.abstractmethod
• collections.abc.Callable
• datetime.UTC
• datetime.datetime
• typing.TYPE_CHECKING
• typing.Any
• typing.Generic
• typing.TypeVar
• uuid.UUID
• uuid.uuid4
• pydantic.BaseModel
• dazzle_back.specs.entity.EntitySpec
• dazzle_back.specs.entity.StateMachineSpec
• dazzle_back.specs.service.ServiceSpec
• dazzle_back.runtime.repository.Repository

Event Interactions

None detected.

Invariants and Assumptions

• Validates: Unknown operation: {operation}

• db.connection() is a context manager — must enter it

• Validates: No model found for entity: {entity_name}

Tests

• tests/integration/test_runtime_e2e.py
• tests/integration/test_runtime_pipeline.py
• tests/unit/test_runtime_test_routes.py
• tests/unit/test_runtime_services.py
• tests/unit/test_runtime_mcp_tools.py

Notes

This page was automatically generated by tools/gen_reference_docs.py.