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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-ddd-framework
-Version: 0.7.1
+Version: 0.7.2
 Summary: Modular DDD application framework with project CLI and bundled templates
 License-Expression: LicenseRef-Proprietary
 License-File: LICENSE
@@ -312,6 +312,12 @@ 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#当前发布).
+
 <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.2}/README.md

@@ -268,6 +268,12 @@ 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#当前发布).
+
 <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.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-ddd-framework"
-version = "0.7.1"
+version = "0.7.2"
 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.2}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "python-ddd-framework"
-version = "0.7.1"
+version = "0.7.2"
 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.2}/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.2}/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.2}/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.2}/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.2}/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.2}/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.2}/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.2}/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]]: