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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-ddd-framework
-Version: 0.7.1
+Version: 0.7.3
 Summary: Modular DDD application framework with project CLI and bundled templates
 License-Expression: LicenseRef-Proprietary
 License-File: LICENSE
@@ -169,6 +169,8 @@ Open **http://127.0.0.1:8000/docs**. Use the generated `identity.seed_admin_user
 
 The empty `orders` skeleton contributes no business routes. The independent [order-management example](examples/order_management/README.md) supplies `/api/orders`, approval and queued approval, file transfer, and an authenticated WebSocket at `/ws/orders`; use its initializer when you want to explore those capabilities.
 
+For C++ computation, the independent [native integration example](examples/native_integration/README.md) demonstrates an installed nanobind package, typed application-service consumption, cancellation cleanup, source rebuilds, and artifact delivery. It is outside the runtime wheel and does not change the CLI or default templates. Verified platforms and remaining limits are recorded in [status](docs/status.md#c-原生接入样例).
+
 The default business API prefix is `/api`. Liveness and readiness are exposed at `/health/live` and `/health/ready`; readiness describes application lifecycle state, not continuous database or Redis health.
 
 ## CLI reference
@@ -312,6 +314,18 @@ New `ddd` modules contain the full responsibility directories and necessary comp
 
 See the [migration guide](docs/development.md#数据库聚合与迁移) and [verification record](docs/status.md#http-回收与迁移来源判定未发布).
 
+## Invocation performance (0.7.2)
+
+Function calls avoid regenerating DI wrappers, empty extension chains skip unnecessary work, and completed filter/interceptor chains release execution references sooner. Managed declaration checks continue to detect dynamic method and policy changes.
+
+Public APIs, DI scopes, authorization, validation, Unit of Work, exception and cancellation behavior are unchanged. No application-code, configuration or data migration is required. Follow the existing [upgrade procedure](#upgrading); validation evidence and performance limits are recorded in [release status](docs/status.md#当前发布).
+
+## Native C++ integration example (0.7.3)
+
+The repository's [native integration example](examples/native_integration/README.md) demonstrates a separately installed nanobind package, Eigen computation, typed service/HTTP consumption, cancellation cleanup, and wheel/sdist and Docker delivery. Its development entry rebuilds declared native path dependencies before starting the existing Host. The example and its native binaries are maintained outside the framework runtime wheel.
+
+Existing applications need no code, configuration, dependency or data migration. Adopt the example from the source checkout when adding native computation; the CLI, default templates and framework lifecycle contracts are unchanged. Platform evidence and remaining limits are recorded in [release status](docs/status.md#当前发布).
+
 <a id="streaming-and-access-migration-07-unreleased"></a>
 
 ## Streaming and access migration (0.7)

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

@@ -125,6 +125,8 @@ Open **http://127.0.0.1:8000/docs**. Use the generated `identity.seed_admin_user
 
 The empty `orders` skeleton contributes no business routes. The independent [order-management example](examples/order_management/README.md) supplies `/api/orders`, approval and queued approval, file transfer, and an authenticated WebSocket at `/ws/orders`; use its initializer when you want to explore those capabilities.
 
+For C++ computation, the independent [native integration example](examples/native_integration/README.md) demonstrates an installed nanobind package, typed application-service consumption, cancellation cleanup, source rebuilds, and artifact delivery. It is outside the runtime wheel and does not change the CLI or default templates. Verified platforms and remaining limits are recorded in [status](docs/status.md#c-原生接入样例).
+
 The default business API prefix is `/api`. Liveness and readiness are exposed at `/health/live` and `/health/ready`; readiness describes application lifecycle state, not continuous database or Redis health.
 
 ## CLI reference
@@ -268,6 +270,18 @@ New `ddd` modules contain the full responsibility directories and necessary comp
 
 See the [migration guide](docs/development.md#数据库聚合与迁移) and [verification record](docs/status.md#http-回收与迁移来源判定未发布).
 
+## Invocation performance (0.7.2)
+
+Function calls avoid regenerating DI wrappers, empty extension chains skip unnecessary work, and completed filter/interceptor chains release execution references sooner. Managed declaration checks continue to detect dynamic method and policy changes.
+
+Public APIs, DI scopes, authorization, validation, Unit of Work, exception and cancellation behavior are unchanged. No application-code, configuration or data migration is required. Follow the existing [upgrade procedure](#upgrading); validation evidence and performance limits are recorded in [release status](docs/status.md#当前发布).
+
+## Native C++ integration example (0.7.3)
+
+The repository's [native integration example](examples/native_integration/README.md) demonstrates a separately installed nanobind package, Eigen computation, typed service/HTTP consumption, cancellation cleanup, and wheel/sdist and Docker delivery. Its development entry rebuilds declared native path dependencies before starting the existing Host. The example and its native binaries are maintained outside the framework runtime wheel.
+
+Existing applications need no code, configuration, dependency or data migration. Adopt the example from the source checkout when adding native computation; the CLI, default templates and framework lifecycle contracts are unchanged. Platform evidence and remaining limits are recorded in [release status](docs/status.md#当前发布).
+
 <a id="streaming-and-access-migration-07-unreleased"></a>
 
 ## Streaming and access migration (0.7)

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

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

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

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

{python_ddd_framework-0.7.1 → python_ddd_framework-0.7.3}/src/python_ddd_framework/fastapi/filters.py

@@ -87,7 +87,11 @@ async def _run_filters(
     context: ActionFilterContext,
     target: Callable[[], Awaitable[object]],
 ) -> object:
+    if not registrations:
+        return await target()
+
     async def invoke(index: int) -> object:
+        nonlocal invoke
         if index == len(registrations):
             return await target()
         instance = await container.get(registrations[index].filter_type)
@@ -97,7 +101,11 @@ async def _run_filters(
         finally:
             continuation.active = False
 
-    return await invoke(0)
+    try:
+        return await invoke(0)
+    finally:
+        # 保留原失效检查，只解除已结束 filter 链对请求执行状态的引用。
+        del invoke
 
 
 def _validate_filters(registrations: Sequence[ServiceFilter], container: AsyncContainer) -> None:

{python_ddd_framework-0.7.1 → python_ddd_framework-0.7.3}/src/python_ddd_framework/fastapi/parameters.py

@@ -52,7 +52,8 @@ class _HttpParameterValidator:
         for name in self._validators:
             if name in actual:
                 arguments = _InvocationArguments((actual[name],), {})
-                arguments.mark_validated()
+                # HTTP Filter 会获得参数引用，始终保留独立于服务拦截链的改参快照。
+                arguments.mark_validated(capture_structure=True)
                 arguments.exposed = True
                 snapshots[name] = arguments
         return snapshots

{python_ddd_framework-0.7.1 → python_ddd_framework-0.7.3}/src/python_ddd_framework/invocation/callables.py

@@ -1,4 +1,4 @@
-"""调用签名的 DI 分类与原生注入包装；作用域创建仍归各运行入口。"""
+"""调用签名的 DI 分类与参数装配；实例解析和作用域仍归原生容器。"""
 
 from __future__ import annotations
 
@@ -9,7 +9,7 @@ from types import MappingProxyType, SimpleNamespace
 from typing import Annotated, Any, TypeVar, get_args, get_origin, get_type_hints
 
 from dishka import AsyncContainer, BaseScope, DependencyKey
-from dishka.integrations.base import default_parse_dependency, wrap_injection
+from dishka.integrations.base import default_parse_dependency
 
 _R = TypeVar("_R")
 
@@ -124,22 +124,8 @@ class _CallablePlan:
         # 先验证全部业务实参，再解析任何依赖，避免错误调用触发 resource factory。
         bound = self.signature.bind(*args, **kwargs)
         bound.apply_defaults()
-
-        def parse(parameter: inspect.Parameter, hint: Any) -> DependencyKey | None:
-            return self.dependencies.get(parameter.name)
-
-        async def target(*args: object, **kwargs: object) -> _R:
-            return await function(*args, **kwargs)
-
-        # 原函数可能被多个 Application 共享；只给当前调用的 native wrapper 提供签名。
-        target.__signature__ = inspect.signature(function)  # type: ignore[attr-defined]
-        target.__annotations__ = {}
-        injected = wrap_injection(
-            func=target,
-            container_getter=lambda args, kwargs: container,
-            is_async=True,
-            parse_dependency=parse,
-        )
+        # 编译与执行之间可能改变签名元数据；无 DI 的快路径也保留原生边界检查。
+        signature = inspect.signature(function)
         # DI 参数从签名移除后位置会变化；普通业务参数按名称交给原函数。
         positional = tuple(
             bound.arguments[name]
@@ -151,7 +137,33 @@ class _CallablePlan:
             for name, value in bound.arguments.items()
             if self.signature.parameters[name].kind is not inspect.Parameter.POSITIONAL_ONLY
         }
-        return await injected(*positional, **named)
+        if not self.dependencies:
+            return await function(*positional, **named)
+
+        # 与原生注入一致，当前签名决定有效 DI 参数及解析顺序，分类仍来自编译计划。
+        dependencies = {
+            name: self.dependencies[name]
+            for name in signature.parameters
+            if name in self.dependencies
+        }
+        if dependencies:
+            # 保留原生注入剥离 DI 后的签名校验；畸形元数据须在资源获取前失败。
+            inspect.Signature(
+                parameters=[
+                    parameter.replace(annotation=Any)
+                    for name, parameter in signature.parameters.items()
+                    if name not in dependencies
+                ],
+                return_annotation=signature.return_annotation,
+            )
+            for name, dependency in dependencies.items():
+                # 原生常量直接提供值，不触发同 key 的 Provider；其余依赖仍由容器拥有。
+                named[name] = (
+                    dependency.get_const_value()
+                    if dependency.is_const()
+                    else await container.get(dependency.type_hint, dependency.component)
+                )
+        return await function(*positional, **named)
 
 
 async def _call_in_scope(

{python_ddd_framework-0.7.1 → python_ddd_framework-0.7.3}/src/python_ddd_framework/invocation/dispatcher.py

@@ -204,7 +204,8 @@ class _MethodDispatcher:
                         ),
                     ),
                 ) from None
-        arguments.mark_validated()
+        # 没有拦截器时参数不会被公开给扩展；有任一扩展就保留快照，覆盖后期首次改参。
+        arguments.mark_validated(capture_structure=any(pipeline.steps.values()))
 
     async def _write_audit(
         self,

{python_ddd_framework-0.7.1 → python_ddd_framework-0.7.3}/src/python_ddd_framework/invocation/execution.py

@@ -41,8 +41,13 @@ class _InterceptorPipeline:
         callback: Callable[[], Awaitable[object]],
     ) -> object:
         registrations = self.steps[stage]
+        # 空扩展链仍执行原阶段逻辑；不创建自引用的递归闭包，避免把回调
+        # 及其 scope 状态留到循环 GC 才释放。
+        if not registrations:
+            return await callback()
 
         async def proceed(index: int) -> object:
+            nonlocal proceed
             if index == len(registrations):
                 return await callback()
             interceptor = await container.get(registrations[index].interceptor)
@@ -52,7 +57,11 @@ class _InterceptorPipeline:
             finally:
                 invocation._close()
 
-        return await proceed(0)
+        try:
+            return await proceed(0)
+        finally:
+            # continuation 已失效；解除递归 cell，避免旧 invocation 继续持有执行回调。
+            del proceed
 
 
 @dataclass(slots=True)
@@ -80,12 +89,14 @@ class _InvocationArguments:
             or (self.exposed and self._structure([]) != self._validated_structure)
         )
 
-    def mark_validated(self) -> None:
+    def mark_validated(self, *, capture_structure: bool) -> None:
         # 只在验证成功后记录规范化结果；快照与调用共同归属当前 pipeline。
         self._validated_args = self.args
         self._validated_kwargs = dict(self.kwargs)
         self._validated_nodes = []
-        self._validated_structure = self._structure(self._validated_nodes)
+        self._validated_structure = (
+            self._structure(self._validated_nodes) if capture_structure else None
+        )
         # 不重置 exposed：早期扩展可能保留参数引用，并在后续阶段原地修改同一对象。
 
     def _structure(self, retained: list[object]) -> object:

{python_ddd_framework-0.7.1 → python_ddd_framework-0.7.3}/src/python_ddd_framework/invocation/interception.py

@@ -220,15 +220,24 @@ class _EntryInterceptionCatalog:
             )
 
         stages = tuple(
-            stage for stage in InterceptionStage if stage is not InterceptionStage.METHOD
+            stage
+            for stage in InterceptionStage
+            if stage is not InterceptionStage.METHOD and entry.steps[stage]
         )
+        if not stages:
+            return await boundary()
 
         async def run(index: int) -> object:
+            nonlocal run
             if index == len(stages):
                 return await boundary()
             return await pipeline.run(stages[index], container, lambda: run(index + 1))
 
-        return await run(0)
+        try:
+            return await run(0)
+        finally:
+            # 各阶段已退出；不让递归编排额外保留参数、scope 和事务边界回调。
+            del run
 
 
 async def _invoke_managed_entry(

{python_ddd_framework-0.7.1 → python_ddd_framework-0.7.3}/src/python_ddd_framework/invocation/managed_services.py

@@ -25,6 +25,7 @@ from ..unit_of_work.options import (
 )
 from .managed_proxy import _ManagedServiceProxy
 from .methods import (
+    _class_policy_fingerprint,
     _compile_method,
     _CompiledMethod,
     _policy_fingerprint,
@@ -42,25 +43,41 @@ def _managed_names(candidate: type[object]) -> tuple[str, ...]:
     )
     names: list[str] = []
     # 类级标记覆盖公开方法；显式方法标记即使位于非公开方法也必须接受形态校验。
-    members = {
-        name: value for base in reversed(candidate.__mro__) for name, value in vars(base).items()
-    }
-    public = _public_method_names(candidate, is_contract=False)
+    members: dict[str, object] = {}
+    for base in reversed(candidate.__mro__):
+        members.update(vars(base))
+    # 原生 object 成员不携带策略；按身份移除未覆盖项，保留用户声明及其顺序。
+    for name, value in vars(object).items():
+        if name in members and members[name] is value:
+            del members[name]
+    public = set(_public_method_names(candidate, is_contract=False)) if class_marked else set()
     for name, value in members.items():
-        targets = (
-            (value, value.__func__) if isinstance(value, (staticmethod, classmethod)) else (value,)
-        )
-        marked = any(hasattr(target, attribute) for target in targets for attribute in attributes)
-        if marked or (class_marked and name in public):
+        # 类标记已覆盖公开方法时，无需再逐属性判断该方法是否显式标记。
+        marked = name in public
+        if not marked:
+            targets = (
+                (value, value.__func__)
+                if isinstance(value, (staticmethod, classmethod))
+                else (value,)
+            )
+            marked = any(
+                hasattr(target, attribute) for target in targets for attribute in attributes
+            )
+        if marked:
             _require_async_instance_method(candidate, name, role="managed service")
             names.append(name)
     return tuple(names)
 
 
 def _assert_methods(candidate: type[object], methods: Mapping[str, _CompiledMethod]) -> None:
-    if tuple(methods) != _managed_names(candidate) or any(
+    names = _managed_names(candidate)
+    # 每次解析仍读取当前声明；同一类的策略只在本次同步核对内共用，
+    # 不跨请求缓存，后续类级/继承策略修改仍会与编译值发生差异。
+    class_policy = _class_policy_fingerprint(candidate)
+    if tuple(methods) != names or any(
         getattr(candidate, name) is not method.implementation_method
-        or _policy_fingerprint(candidate, method.implementation_method) != method.policy_fingerprint
+        or _policy_fingerprint(candidate, method.implementation_method, class_policy=class_policy)
+        != method.policy_fingerprint
         for name, method in methods.items()
     ):
         raise ApplicationServiceDefinitionError(

{python_ddd_framework-0.7.1 → python_ddd_framework-0.7.3}/src/python_ddd_framework/invocation/methods.py

@@ -3,9 +3,10 @@
 from __future__ import annotations
 
 import inspect
+import keyword
 from collections.abc import Awaitable, Callable, Mapping
 from dataclasses import dataclass, field, replace
-from types import MappingProxyType
+from types import FunctionType, MappingProxyType
 from typing import Any, cast, get_type_hints
 
 from pydantic import ConfigDict, TypeAdapter, validate_call
@@ -199,15 +200,36 @@ _POLICY_ATTRIBUTES = (
     _AUDITING_ATTRIBUTE,
 )
 
+_PolicyRows = tuple[tuple[object, ...], ...]
+_ClassPolicyFingerprint = tuple[bool, _PolicyRows]
 
-def _policy_fingerprint(implementation: type[object], method: object) -> tuple[object, ...]:
+
+def _policy_values(target: object) -> _PolicyRows:
+    namespace = vars(target)
+    if any(attribute in namespace for attribute in _POLICY_ATTRIBUTES):
+        return (tuple(namespace.get(attribute) for attribute in _POLICY_ATTRIBUTES),)
+    return ()
+
+
+def _class_policy_fingerprint(implementation: type[object]) -> _ClassPolicyFingerprint:
     return (
         issubclass(implementation, ValidationEnabled),
-        tuple(
-            tuple(vars(target).get(attribute) for attribute in _POLICY_ATTRIBUTES)
-            for target in (*implementation.__mro__, method)
-            if any(attribute in vars(target) for attribute in _POLICY_ATTRIBUTES)
-        ),
+        tuple(row for target in implementation.__mro__ for row in _policy_values(target)),
+    )
+
+
+def _policy_fingerprint(
+    implementation: type[object],
+    method: object,
+    *,
+    class_policy: _ClassPolicyFingerprint | None = None,
+) -> tuple[object, ...]:
+    validation, rows = (
+        _class_policy_fingerprint(implementation) if class_policy is None else class_policy
+    )
+    return (
+        validation,
+        (*rows, *_policy_values(method)),
     )
 
 
@@ -278,11 +300,7 @@ def _require_async_instance_method(
             symbol=symbol,
             reason=f"public {role} methods must use async def",
         )
-    parameters = tuple(inspect.signature(method).parameters.values())
-    if not parameters or parameters[0].kind not in (
-        inspect.Parameter.POSITIONAL_ONLY,
-        inspect.Parameter.POSITIONAL_OR_KEYWORD,
-    ):
+    if not _has_positional_receiver(method):
         # Catalog 与 HTTP generator 都会剥离 receiver；缺少首个位置参数时不能伪装成实例方法。
         raise ApplicationServiceDefinitionError(
             symbol=symbol,
@@ -291,6 +309,39 @@ def _require_async_instance_method(
     return cast(Callable[..., Awaitable[object]], method)
 
 
+def _has_positional_receiver(method: FunctionType) -> bool:
+    # 普通 Python 函数的位置参数由 code 直接声明；完整签名/类型仍在编译时解析。
+    # 包装、自定义签名和惰性注解沿用 inspect，不能从包装函数的 *args 推断 receiver。
+    code = method.__code__
+    count = code.co_argcount + code.co_kwonlyargcount
+    count += bool(code.co_flags & inspect.CO_VARARGS) + bool(code.co_flags & inspect.CO_VARKEYWORDS)
+    names = code.co_varnames[:count]
+    special = any(
+        hasattr(method, name)
+        for name in (
+            "__wrapped__",
+            "__signature__",
+            "__text_signature__",
+            "_partialmethod",
+            "__partialmethod__",
+            "__annotate__",
+        )
+    )
+    if (
+        special
+        or len(set(names)) != len(names)
+        or any(not name.isidentifier() or keyword.iskeyword(name) for name in names)
+        or len(method.__defaults__ or ()) > code.co_argcount
+    ):
+        # 手工替换 code 的非法参数及特殊声明仍由原生 Signature 报告，不能静默放行。
+        parameters = tuple(inspect.signature(method).parameters.values())
+        return bool(parameters) and parameters[0].kind in (
+            inspect.Parameter.POSITIONAL_ONLY,
+            inspect.Parameter.POSITIONAL_OR_KEYWORD,
+        )
+    return code.co_argcount > 0
+
+
 def _resolved_signature(
     method: Callable[..., Awaitable[object]],
 ) -> tuple[inspect.Signature, dict[str, object]]: