python-ddd-framework 0.7.0__tar.gz → 0.7.1__tar.gz

{python_ddd_framework-0.7.0 → python_ddd_framework-0.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-ddd-framework
-Version: 0.7.0
+Version: 0.7.1
 Summary: Modular DDD application framework with project CLI and bundled templates
 License-Expression: LicenseRef-Proprietary
 License-File: LICENSE
@@ -304,6 +304,14 @@ The image uses `python -m host.main` without development reload. Runtime install
 
 New `ddd` modules contain the full responsibility directories and necessary composition, with no preset business code or tests. `basic` is unchanged. This affects subsequent generation only: upgrades do not delete or rewrite existing consumers' order code. Keep existing business contracts and data under their application owners. The former order implementation and its existing domain test now live in [the independent example](examples/order_management/README.md); its initializer uses the official CLI, requires a new destination, and is not bundled in the runtime wheel. No CLI parameter or dependency has been added.
 
+## HTTP lifecycle and global migration checks (0.7.1)
+
+- Health endpoints now read their Application from request-local access to the FastAPI instance state. Adapter rollback and lifespan cleanup release the binding; rejected duplicate or concurrent lifespan entry preserves the active lifespan's binding and readiness. Health URLs, responses and readiness semantics are unchanged.
+- Replace Owner filtering used solely to exclude empty ORM skeletons with one `await SqlAlchemyMigrator(application).check_current_heads()` call. Global checks and upgrades waive missing revisions only for ordinary ORM sources whose metadata and revision history are both empty. Sources with tables, historical revisions, migration-only declarations or extensions retain their checks, including unknown database history.
+- Keep the Host's startup orchestration and cleanup. Run the check while the Application is COMPOSED, before starting it; there is no automatic startup check or new configuration. Explicit module operations and first-revision authoring keep their existing behavior.
+
+See the [migration guide](docs/development.md#数据库聚合与迁移) and [verification record](docs/status.md#http-回收与迁移来源判定未发布).
+
 <a id="streaming-and-access-migration-07-unreleased"></a>
 
 ## Streaming and access migration (0.7)
@@ -546,7 +554,7 @@ Do not remove durable job payload versions merely because their Python APIs were
 <details>
 <summary>For maintainers: publishing a changed version</summary>
 
-Routine code and documentation commits may retain the current version. Pull requests to `main` run build, static checks, and short architecture/typing/release-intent checks with read-only permissions. Pushes to `main` run the full release gates, including locked, lowest-direct, and highest allowed dependency samples, but skip publication unless the version increased across the push; initial creation of `main` publishes its current version. Manual workflow runs validate only. A failed run may be retried, but a later same-version push does not resume publication: changed contents require another version bump. Follow [release operations](https://github.com/componet-architecture/python-ddd-framework/blob/main/docs/development.md#发布操作) for publisher setup and retry boundaries. Dependency samples and current API/type checks do not establish backward compatibility or a cross-version upgrade guarantee.
+Routine code and documentation commits may retain the current version. Pushes to `main` run the full release gates, including locked, lowest-direct, and highest allowed dependency samples, but skip publication unless the version increased across the push; initial creation of `main` publishes its current version. Manual workflow runs validate only. A failed run may be retried, but a later same-version push does not resume publication: changed contents require another version bump. Follow [release operations](https://github.com/componet-architecture/python-ddd-framework/blob/main/docs/development.md#发布操作) for publisher setup and retry boundaries. Dependency samples and current API/type checks do not establish backward compatibility or a cross-version upgrade guarantee.
 
 </details>
 

{python_ddd_framework-0.7.0 → python_ddd_framework-0.7.1}/README.md

@@ -260,6 +260,14 @@ The image uses `python -m host.main` without development reload. Runtime install
 
 New `ddd` modules contain the full responsibility directories and necessary composition, with no preset business code or tests. `basic` is unchanged. This affects subsequent generation only: upgrades do not delete or rewrite existing consumers' order code. Keep existing business contracts and data under their application owners. The former order implementation and its existing domain test now live in [the independent example](examples/order_management/README.md); its initializer uses the official CLI, requires a new destination, and is not bundled in the runtime wheel. No CLI parameter or dependency has been added.
 
+## HTTP lifecycle and global migration checks (0.7.1)
+
+- Health endpoints now read their Application from request-local access to the FastAPI instance state. Adapter rollback and lifespan cleanup release the binding; rejected duplicate or concurrent lifespan entry preserves the active lifespan's binding and readiness. Health URLs, responses and readiness semantics are unchanged.
+- Replace Owner filtering used solely to exclude empty ORM skeletons with one `await SqlAlchemyMigrator(application).check_current_heads()` call. Global checks and upgrades waive missing revisions only for ordinary ORM sources whose metadata and revision history are both empty. Sources with tables, historical revisions, migration-only declarations or extensions retain their checks, including unknown database history.
+- Keep the Host's startup orchestration and cleanup. Run the check while the Application is COMPOSED, before starting it; there is no automatic startup check or new configuration. Explicit module operations and first-revision authoring keep their existing behavior.
+
+See the [migration guide](docs/development.md#数据库聚合与迁移) and [verification record](docs/status.md#http-回收与迁移来源判定未发布).
+
 <a id="streaming-and-access-migration-07-unreleased"></a>
 
 ## Streaming and access migration (0.7)
@@ -502,7 +510,7 @@ Do not remove durable job payload versions merely because their Python APIs were
 <details>
 <summary>For maintainers: publishing a changed version</summary>
 
-Routine code and documentation commits may retain the current version. Pull requests to `main` run build, static checks, and short architecture/typing/release-intent checks with read-only permissions. Pushes to `main` run the full release gates, including locked, lowest-direct, and highest allowed dependency samples, but skip publication unless the version increased across the push; initial creation of `main` publishes its current version. Manual workflow runs validate only. A failed run may be retried, but a later same-version push does not resume publication: changed contents require another version bump. Follow [release operations](https://github.com/componet-architecture/python-ddd-framework/blob/main/docs/development.md#发布操作) for publisher setup and retry boundaries. Dependency samples and current API/type checks do not establish backward compatibility or a cross-version upgrade guarantee.
+Routine code and documentation commits may retain the current version. Pushes to `main` run the full release gates, including locked, lowest-direct, and highest allowed dependency samples, but skip publication unless the version increased across the push; initial creation of `main` publishes its current version. Manual workflow runs validate only. A failed run may be retried, but a later same-version push does not resume publication: changed contents require another version bump. Follow [release operations](https://github.com/componet-architecture/python-ddd-framework/blob/main/docs/development.md#发布操作) for publisher setup and retry boundaries. Dependency samples and current API/type checks do not establish backward compatibility or a cross-version upgrade guarantee.
 
 </details>
 

{python_ddd_framework-0.7.0 → python_ddd_framework-0.7.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-ddd-framework"
-version = "0.7.0"
+version = "0.7.1"
 description = "Modular DDD application framework with project CLI and bundled templates"
 readme = "README.md"
 license = "LicenseRef-Proprietary"

{python_ddd_framework-0.7.0 → python_ddd_framework-0.7.1}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "python-ddd-framework"
-version = "0.7.0"
+version = "0.7.1"
 description = "Modular DDD application framework with project CLI and bundled templates"
 readme = "README.md"
 license = "LicenseRef-Proprietary"

{python_ddd_framework-0.7.0 → python_ddd_framework-0.7.1}/src/python_ddd_framework/fastapi/adapter.py

@@ -15,7 +15,13 @@ from starlette.middleware import Middleware
 from ..application import Application
 from ..application_services import ApplicationServiceValidationError
 from ..authorization import PermissionDeniedError, UnauthenticatedError
-from ..errors import BusinessError, FrameworkError, ResourceConflictError, ResourceNotFoundError
+from ..errors import (
+    BusinessError,
+    FrameworkError,
+    InvalidApplicationStateError,
+    ResourceConflictError,
+    ResourceNotFoundError,
+)
 from ..lifecycle import ApplicationState
 from .contracts import RouterCatalog
 from .error_handlers import (
@@ -30,6 +36,7 @@ from .error_handlers import (
 )
 from .errors import FastApiAdapterError
 from .filters import ServiceFilter, _validate_filters
+from .health import _APPLICATION_STATE_ATTRIBUTE
 from .middleware import DiMiddleware, _compile_middlewares
 from .module import FastApiModule
 from .realtime.runtime import _FastApiRealtimeRuntime
@@ -174,6 +181,7 @@ class FastApiAdapter:
         app.state.python_ddd_framework_filters = self._filters
         app.state.python_ddd_framework_upload_limits = self._upload_limits
         app.state.dishka_container = self._application._container_for_integration()
+        setattr(app.state, _APPLICATION_STATE_ATTRIBUTE, self._application)
         app.user_middleware = [*middlewares, Middleware(_RequestTaskMiddleware)]
         app.add_middleware(_RequestContextMiddleware, application=self._application)
         _install_tracing(self._application, app)
@@ -191,17 +199,19 @@ class FastApiAdapter:
         try:
             self._validate_start_target(app)
         except BaseException:
-            if self._installed_app is app:
+            if self._installed_app is app and self._application.state is ApplicationState.COMPOSED:
                 try:
-                    if self._application.state is ApplicationState.COMPOSED:
-                        await self._application.stop()
+                    await self._application.stop()
                 finally:
-                    self._clear_container_bridge(app)
+                    self._clear_application_bridges(app)
             raise
         try:
             await self._application.start()
+        except InvalidApplicationStateError:
+            # Core 在取得转换 ownership 前拒绝重复/并发进入；不能撤销有效 lifespan 的桥。
+            raise
         except BaseException:
-            self._clear_container_bridge(app)
+            self._clear_application_bridges(app)
             raise
 
         try:
@@ -214,7 +224,7 @@ class FastApiAdapter:
                     await self._application.stop()
                 finally:
                     # Container 的 close 始终属于 Application；这里只撤销 Web 引用。
-                    self._clear_container_bridge(app)
+                    self._clear_application_bridges(app)
 
     def _validate_install_target(self, app: FastAPI) -> None:
         if not isinstance(app, FastAPI):
@@ -225,6 +235,8 @@ class FastApiAdapter:
             raise FastApiAdapterError("FastAPI instance already has a Python DDD Framework adapter")
         if hasattr(app.state, _DISHKA_CONTAINER_BRIDGE):
             raise FastApiAdapterError("FastAPI instance already has a Dishka container bridge")
+        if hasattr(app.state, _APPLICATION_STATE_ATTRIBUTE):
+            raise FastApiAdapterError("FastAPI instance already has an Application binding")
         if app.middleware_stack is not None:
             raise FastApiAdapterError("FastAPI middleware stack was already built before install")
         if self._application.state is not ApplicationState.COMPOSED:
@@ -239,6 +251,8 @@ class FastApiAdapter:
             )
         if getattr(app.state, _INSTALLATION_MARKER, None) != str(self._application.id):
             raise FastApiAdapterError("FastAPI installation marker changed before startup")
+        if getattr(app.state, _APPLICATION_STATE_ATTRIBUTE, None) is not self._application:
+            raise FastApiAdapterError("FastAPI Application binding changed before startup")
         if app.state.python_ddd_framework_filters != self._filters:
             raise FastApiAdapterError("HTTP filters changed after adapter installation")
         if tuple(app.user_middleware) != self._installed_middleware:
@@ -258,9 +272,10 @@ class FastApiAdapter:
             raise FastApiAdapterError("Dishka container bridge changed before startup")
 
     @staticmethod
-    def _clear_container_bridge(app: FastAPI) -> None:
-        if hasattr(app.state, _DISHKA_CONTAINER_BRIDGE):
-            delattr(app.state, _DISHKA_CONTAINER_BRIDGE)
+    def _clear_application_bridges(app: FastAPI) -> None:
+        for attribute in (_DISHKA_CONTAINER_BRIDGE, _APPLICATION_STATE_ATTRIBUTE):
+            if hasattr(app.state, attribute):
+                delattr(app.state, attribute)
 
     async def _shutdown_realtime(self) -> None:
         try:

{python_ddd_framework-0.7.0 → python_ddd_framework-0.7.1}/src/python_ddd_framework/fastapi/health.py

@@ -2,10 +2,13 @@
 
 from __future__ import annotations
 
-from fastapi import APIRouter
+from fastapi import APIRouter, Request
 from starlette.responses import JSONResponse
 
 from ..application import Application
+from .errors import FastApiAdapterError
+
+_APPLICATION_STATE_ATTRIBUTE = "_python_ddd_framework_application"
 
 HEALTH_LIVE_PATH = "/health/live"
 HEALTH_READY_PATH = "/health/ready"
@@ -13,18 +16,24 @@ HEALTH_LIVE_OPERATION_ID = "python_ddd_framework_health_live"
 HEALTH_READY_OPERATION_ID = "python_ddd_framework_health_ready"
 
 
-def _create_health_router(application: Application) -> APIRouter:
-    router = APIRouter(tags=["health"])
+async def live() -> JSONResponse:
+    return JSONResponse(status_code=200, content={"status": "live"})
+
+
+async def ready(request: Request) -> JSONResponse:
+    # FastAPI 可长期缓存 callable；应用引用只在当前请求期间从实例状态取得。
+    application = getattr(request.app.state, _APPLICATION_STATE_ATTRIBUTE, None)
+    if not isinstance(application, Application):
+        raise FastApiAdapterError("FastAPI Application binding is unavailable")
+    is_ready = application.is_ready
+    return JSONResponse(
+        status_code=200 if is_ready else 503,
+        content={"status": "ready" if is_ready else "not_ready"},
+    )
 
-    async def live() -> JSONResponse:
-        return JSONResponse(status_code=200, content={"status": "live"})
 
-    async def ready() -> JSONResponse:
-        is_ready = application.is_ready
-        return JSONResponse(
-            status_code=200 if is_ready else 503,
-            content={"status": "ready" if is_ready else "not_ready"},
-        )
+def _create_health_router() -> APIRouter:
+    router = APIRouter(tags=["health"])
 
     router.add_api_route(
         HEALTH_LIVE_PATH,

{python_ddd_framework-0.7.0 → python_ddd_framework-0.7.1}/src/python_ddd_framework/fastapi/routing.py

@@ -135,7 +135,7 @@ def _build_route_plan(
             )
         )
 
-    health_router = _create_health_router(application)
+    health_router = _create_health_router()
     health_route_start = len(preview.routes)
     preview.include_router(health_router)
     health_candidates = _route_candidates(

{python_ddd_framework-0.7.0 → python_ddd_framework-0.7.1}/src/python_ddd_framework/sqlalchemy/migration.py

@@ -332,6 +332,11 @@ def _validate_revision_graph(
     # walk_revisions 强制 Alembic 在任何 engine 创建前加载并校验组合 graph/depends_on。
     script = ScriptDirectory.from_config(config)
     revisions = tuple(script.walk_revisions())
+    empty_model_sources = {
+        (item.owner, item.registration.branch_label, item.migration_path)
+        for item in models.for_connection(connection_name)
+        if not item.registration.metadata.tables
+    }
     for source in migration_sources:
         if source.extension is not None:
             _validate_extension_prerequisites(models, connection_name, source, script)
@@ -341,7 +346,18 @@ def _validate_revision_graph(
             if Path(revision.path).resolve().parent == source.migration_path
         )
         if not owned_revisions:
-            if (owner is not None and source.owner != owner) or allow_empty:
+            # 仅全局操作豁免纯 ORM 骨架的缺失 revision；不跳过图或数据库 heads 检查。
+            # 同一 owner 可贡献多个来源，判定必须限定当前 connection 与具体分支/目录。
+            if (
+                (owner is not None and source.owner != owner)
+                or allow_empty
+                or (
+                    owner is None
+                    and source.extension is None
+                    and (source.owner, source.branch_label, source.migration_path)
+                    in empty_model_sources
+                )
+            ):
                 continue
             raise SqlAlchemyModelRegistrationError(
                 owner=str(source.owner),