python-ddd-framework 0.3.1__py3-none-any.whl

python_ddd_framework/__init__.py

@@ -0,0 +1,449 @@
+from .application import Application, ApplicationBuilder
+from .application_services import (
+    ApplicationInvocationCleanupError,
+    ApplicationInvocationContext,
+    ApplicationInvocationRejectedError,
+    ApplicationService,
+    ApplicationServiceCatalog,
+    ApplicationServiceContract,
+    ApplicationServiceDefinitionError,
+    ApplicationServiceMethod,
+    ApplicationServiceMethodError,
+    ApplicationServiceRegistration,
+    ApplicationServiceValidationError,
+    ApplicationServiceValidationIssue,
+    CrossTaskInvocationError,
+    DataSeedContributor,
+    DataSeeder,
+    DataSeedError,
+    IntegrationService,
+    InterceptionStage,
+    Interceptor,
+    InterceptorRegistration,
+    MethodInvocation,
+    NestedConnectionError,
+    application_service,
+    disable_validation,
+    enable_validation,
+)
+from .authorization import (
+    AccessTokenAuthenticator,
+    AuthorizationDefinitionError,
+    CurrentUser,
+    PermissionCatalog,
+    PermissionChecker,
+    PermissionCheckerUnavailableError,
+    PermissionDefinition,
+    PermissionDefinitionContext,
+    PermissionDefinitionError,
+    PermissionDefinitionProvider,
+    PermissionDeniedError,
+    PermissionName,
+    RolePermissionVersion,
+    UnauthenticatedError,
+    allow_anonymous,
+    authorize,
+)
+from .background_execution import (
+    BackgroundExecutionMode,
+    BackgroundJobOptions,
+    BackgroundTaskOptions,
+    BackgroundTaskSnapshot,
+    BackgroundTaskState,
+)
+from .background_jobs import (
+    BackgroundJobCatalog,
+    BackgroundJobContext,
+    BackgroundJobDefinition,
+    BackgroundJobDefinitionError,
+    BackgroundJobEnqueuer,
+    BackgroundJobExecutionError,
+    BackgroundJobHandler,
+    BackgroundJobPayloadError,
+    BackgroundJobRetryPolicy,
+    BackgroundJobSchedule,
+    BackgroundSystemCaller,
+)
+from .background_workers import (
+    BackgroundExecutionOptions,
+    BackgroundExecutionProfile,
+    BackgroundWorker,
+    BackgroundWorkerCatalog,
+    BackgroundWorkerContext,
+    BackgroundWorkerDefinition,
+    BackgroundWorkerDefinitionError,
+    BackgroundWorkerRuntimeError,
+)
+from .caching import (
+    CacheCatalog,
+    CacheDefinition,
+    CacheDefinitionError,
+    DistributedCache,
+    DistributedCacheError,
+)
+from .configuration import (
+    ConfigurationContribution,
+    ConfigurationProvenance,
+    ConfigurationRoot,
+    ConfigurationSource,
+    ConfigurationSourceDiagnostic,
+    ConfigurationSourceStatus,
+    ConfigurationValueDiagnostic,
+)
+from .diagnostics import (
+    DiagnosticMessage,
+    DiagnosticSnapshot,
+    EventStatus,
+    FailureRecord,
+    LifecyclePhase,
+    LifecycleStage,
+    PhaseEvent,
+    SourceLocation,
+)
+from .distributed_lock import DistributedLock, DistributedLockError, DistributedLockOptions
+from .domain import AggregateRoot, Entity, OptimisticConcurrencyError, ValueObject
+from .errors import (
+    ApplicationRuntimeError,
+    ApplicationStartError,
+    CatalogNativeGraphMismatchError,
+    CompositionResourceError,
+    ConfigurationSourceError,
+    ContainerCleanupError,
+    ContainerValidationError,
+    ConventionScanError,
+    DuplicateModuleIdentityError,
+    DuplicateOptionDefinitionError,
+    FrameworkError,
+    GraphInvariantError,
+    InvalidApplicationStateError,
+    InvalidConventionDefinitionError,
+    InvalidDiagnosticCodeError,
+    InvalidModuleReferenceError,
+    InvalidOptionDefinitionError,
+    LifecycleInvocationError,
+    LifecycleReturnValueError,
+    ModuleCycleError,
+    ModuleInstantiationError,
+    ModuleResolutionError,
+    OptionsContributionClosedError,
+    OptionsValidationError,
+    RegistrationConflictError,
+    ResourceConflictError,
+    ResourceNotFoundError,
+    ServiceContributorClosedError,
+    UnknownModuleError,
+    UnknownOptionsError,
+)
+from .events import (
+    AggregateEventCollector,
+    EventContributionError,
+    EventContributor,
+    EventCycleError,
+    LocalEventBus,
+    LocalEventCatalog,
+    LocalEventHandlerError,
+    LocalEventPhase,
+    LocalEventSubscription,
+    PostCommitEventError,
+    local_event_handler,
+)
+from .hosted_services import (
+    ApplicationReadinessSnapshot,
+    HostedService,
+    HostedServiceCatalog,
+    HostedServiceContext,
+    HostedServiceContractError,
+    HostedServiceDefinitionError,
+    HostedServiceInvocationRejectedError,
+    HostedServiceLifecycleError,
+    HostedServiceOptions,
+    HostedServiceRegistration,
+    HostedServiceSnapshot,
+    HostedServiceStatus,
+)
+from .lifecycle import (
+    ApplicationState,
+    ApplicationView,
+    ConfigureContext,
+    InitializeContext,
+    LifecycleContext,
+    PostConfigureContext,
+    PostInitializeContext,
+    PreConfigureContext,
+    PreInitializeContext,
+    ShutdownContext,
+    ShutdownReason,
+)
+from .modularity import (
+    AppModule,
+    ModuleDependency,
+    ModuleDependencyEdge,
+    ModuleDescriptor,
+    ModuleGraphSnapshot,
+    ModuleKey,
+    ModuleRef,
+    ModuleRegistry,
+)
+from .options import (
+    BaseOptions,
+    Options,
+    OptionsContribution,
+    OptionsSnapshot,
+    OptionsValidationIssue,
+    PreOptionsSnapshot,
+)
+from .realtime import (
+    RealtimeDeliveryReport,
+    RealtimeEnvelope,
+    RealtimePublisher,
+    RealtimeSnapshot,
+)
+from .services import (
+    ConventionalService,
+    ConventionCandidate,
+    ConventionCandidateDecision,
+    ConventionDiscoveryKind,
+    ProviderContribution,
+    ProviderContributionView,
+    RegistrationDecision,
+    RegistrationKind,
+    RepositoryContract,
+    ScopedDependency,
+    ServiceCatalog,
+    ServiceContributor,
+    ServiceRegistration,
+    SingletonDependency,
+    TransientDependency,
+    service,
+)
+from .settings import (
+    RuntimeSettingError,
+    RuntimeSettingStore,
+    SettingCatalog,
+    SettingDefinition,
+    SettingDefinitionContext,
+    SettingDefinitionError,
+    SettingDefinitionProvider,
+    SettingManager,
+    SettingProvider,
+)
+from .unit_of_work import (
+    UnitOfWork,
+    UnitOfWorkManager,
+    UnitOfWorkOptions,
+    UnitOfWorkState,
+    UnitOfWorkStateError,
+    UnitOfWorkTransactionBehavior,
+    unit_of_work,
+)
+
+__all__ = (
+    "AccessTokenAuthenticator",
+    "AggregateEventCollector",
+    "AggregateRoot",
+    "AppModule",
+    "Application",
+    "ApplicationBuilder",
+    "ApplicationInvocationCleanupError",
+    "ApplicationInvocationContext",
+    "ApplicationInvocationRejectedError",
+    "ApplicationReadinessSnapshot",
+    "ApplicationRuntimeError",
+    "ApplicationService",
+    "ApplicationServiceCatalog",
+    "ApplicationServiceContract",
+    "ApplicationServiceDefinitionError",
+    "ApplicationServiceMethod",
+    "ApplicationServiceMethodError",
+    "ApplicationServiceRegistration",
+    "ApplicationServiceValidationError",
+    "ApplicationServiceValidationIssue",
+    "ApplicationStartError",
+    "ApplicationState",
+    "ApplicationView",
+    "AuthorizationDefinitionError",
+    "BackgroundExecutionMode",
+    "BackgroundExecutionOptions",
+    "BackgroundExecutionProfile",
+    "BackgroundJobCatalog",
+    "BackgroundJobContext",
+    "BackgroundJobDefinition",
+    "BackgroundJobDefinitionError",
+    "BackgroundJobEnqueuer",
+    "BackgroundJobExecutionError",
+    "BackgroundJobHandler",
+    "BackgroundJobOptions",
+    "BackgroundJobPayloadError",
+    "BackgroundJobRetryPolicy",
+    "BackgroundJobSchedule",
+    "BackgroundSystemCaller",
+    "BackgroundTaskOptions",
+    "BackgroundTaskSnapshot",
+    "BackgroundTaskState",
+    "BackgroundWorker",
+    "BackgroundWorkerCatalog",
+    "BackgroundWorkerContext",
+    "BackgroundWorkerDefinition",
+    "BackgroundWorkerDefinitionError",
+    "BackgroundWorkerRuntimeError",
+    "BaseOptions",
+    "CacheCatalog",
+    "CacheDefinition",
+    "CacheDefinitionError",
+    "CatalogNativeGraphMismatchError",
+    "CompositionResourceError",
+    "ConfigurationContribution",
+    "ConfigurationProvenance",
+    "ConfigurationRoot",
+    "ConfigurationSource",
+    "ConfigurationSourceDiagnostic",
+    "ConfigurationSourceError",
+    "ConfigurationSourceStatus",
+    "ConfigurationValueDiagnostic",
+    "ConfigureContext",
+    "ContainerCleanupError",
+    "ContainerValidationError",
+    "ConventionCandidate",
+    "ConventionCandidateDecision",
+    "ConventionDiscoveryKind",
+    "ConventionScanError",
+    "ConventionalService",
+    "CrossTaskInvocationError",
+    "CurrentUser",
+    "DataSeedContributor",
+    "DataSeedError",
+    "DataSeeder",
+    "DiagnosticMessage",
+    "DiagnosticSnapshot",
+    "DistributedCache",
+    "DistributedCacheError",
+    "DistributedLock",
+    "DistributedLockError",
+    "DistributedLockOptions",
+    "DuplicateModuleIdentityError",
+    "DuplicateOptionDefinitionError",
+    "Entity",
+    "EventContributionError",
+    "EventContributor",
+    "EventCycleError",
+    "EventStatus",
+    "FailureRecord",
+    "FrameworkError",
+    "GraphInvariantError",
+    "HostedService",
+    "HostedServiceCatalog",
+    "HostedServiceContext",
+    "HostedServiceContractError",
+    "HostedServiceDefinitionError",
+    "HostedServiceInvocationRejectedError",
+    "HostedServiceLifecycleError",
+    "HostedServiceOptions",
+    "HostedServiceRegistration",
+    "HostedServiceSnapshot",
+    "HostedServiceStatus",
+    "InitializeContext",
+    "IntegrationService",
+    "InterceptionStage",
+    "Interceptor",
+    "InterceptorRegistration",
+    "InvalidApplicationStateError",
+    "InvalidConventionDefinitionError",
+    "InvalidDiagnosticCodeError",
+    "InvalidModuleReferenceError",
+    "InvalidOptionDefinitionError",
+    "LifecycleContext",
+    "LifecycleInvocationError",
+    "LifecyclePhase",
+    "LifecycleReturnValueError",
+    "LifecycleStage",
+    "LocalEventBus",
+    "LocalEventCatalog",
+    "LocalEventHandlerError",
+    "LocalEventPhase",
+    "LocalEventSubscription",
+    "MethodInvocation",
+    "ModuleCycleError",
+    "ModuleDependency",
+    "ModuleDependencyEdge",
+    "ModuleDescriptor",
+    "ModuleGraphSnapshot",
+    "ModuleInstantiationError",
+    "ModuleKey",
+    "ModuleRef",
+    "ModuleRegistry",
+    "ModuleResolutionError",
+    "NestedConnectionError",
+    "OptimisticConcurrencyError",
+    "Options",
+    "OptionsContribution",
+    "OptionsContributionClosedError",
+    "OptionsSnapshot",
+    "OptionsValidationError",
+    "OptionsValidationIssue",
+    "PermissionCatalog",
+    "PermissionChecker",
+    "PermissionCheckerUnavailableError",
+    "PermissionDefinition",
+    "PermissionDefinitionContext",
+    "PermissionDefinitionError",
+    "PermissionDefinitionProvider",
+    "PermissionDeniedError",
+    "PermissionName",
+    "PhaseEvent",
+    "PostCommitEventError",
+    "PostConfigureContext",
+    "PostInitializeContext",
+    "PreConfigureContext",
+    "PreInitializeContext",
+    "PreOptionsSnapshot",
+    "ProviderContribution",
+    "ProviderContributionView",
+    "RealtimeDeliveryReport",
+    "RealtimeEnvelope",
+    "RealtimePublisher",
+    "RealtimeSnapshot",
+    "RegistrationConflictError",
+    "RegistrationDecision",
+    "RegistrationKind",
+    "RepositoryContract",
+    "ResourceConflictError",
+    "ResourceNotFoundError",
+    "RolePermissionVersion",
+    "RuntimeSettingError",
+    "RuntimeSettingStore",
+    "ScopedDependency",
+    "ServiceCatalog",
+    "ServiceContributor",
+    "ServiceContributorClosedError",
+    "ServiceRegistration",
+    "SettingCatalog",
+    "SettingDefinition",
+    "SettingDefinitionContext",
+    "SettingDefinitionError",
+    "SettingDefinitionProvider",
+    "SettingManager",
+    "SettingProvider",
+    "ShutdownContext",
+    "ShutdownReason",
+    "SingletonDependency",
+    "SourceLocation",
+    "TransientDependency",
+    "UnauthenticatedError",
+    "UnitOfWork",
+    "UnitOfWorkManager",
+    "UnitOfWorkOptions",
+    "UnitOfWorkState",
+    "UnitOfWorkStateError",
+    "UnitOfWorkTransactionBehavior",
+    "UnknownModuleError",
+    "UnknownOptionsError",
+    "ValueObject",
+    "allow_anonymous",
+    "application_service",
+    "authorize",
+    "disable_validation",
+    "enable_validation",
+    "local_event_handler",
+    "service",
+    "unit_of_work",
+)

python_ddd_framework/application/__init__.py

@@ -0,0 +1,6 @@
+"""Application composition root and public runtime owner."""
+
+from .builder import ApplicationBuilder
+from .runtime import Application
+
+__all__ = ("Application", "ApplicationBuilder")

python_ddd_framework/application/build_spec.py

@@ -0,0 +1,37 @@
+"""spawn 传递的构建输入；不持有 Application、容器或 provider 实例。"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+from ..modularity import AppModule, ModuleRef
+
+if TYPE_CHECKING:
+    from .runtime import Application
+
+
+@dataclass(frozen=True)
+class _ApplicationBuildSpec:
+    startup_module: type[AppModule] | ModuleRef
+    environment: str
+    base_path: Path
+    env_prefix: str
+    cli_args: tuple[str, ...]
+    dotenv_path: Path | None
+    explicit_overrides: dict[str, object]
+    project: Path
+
+    def build(self) -> Application:
+        from .builder import ApplicationBuilder
+
+        return ApplicationBuilder(
+            self.startup_module,
+            environment=self.environment,
+            base_path=self.base_path,
+            env_prefix=self.env_prefix,
+            cli_args=self.cli_args,
+            dotenv_path=self.dotenv_path,
+            explicit_overrides=self.explicit_overrides,
+        ).build()