forwardpy 0.2.0__tar.gz → 0.3.0__tar.gz

{forwardpy-0.2.0 → forwardpy-0.3.0}/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 forwardpy contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 forwardpy contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{forwardpy-0.2.0/src/forwardpy.egg-info → forwardpy-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: forwardpy
-Version: 0.2.0
+Version: 0.3.0
 Summary: Python Interface And Implementation Separation Library
 Author: forwardpy contributors
 License: MIT

{forwardpy-0.2.0 → forwardpy-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "forwardpy"
-version = "0.2.0"
+version = "0.3.0"
 description = "Python Interface And Implementation Separation Library"
 readme = "README.md"
 license = {text = "MIT"}

forwardpy-0.3.0/src/forwardpy/__init__.py

@@ -0,0 +1,10 @@
+"""
+forwardpy - Python Interface Class
+
+支持将类拆分到多个文件中编写（声明与实现分离）
+"""
+
+from forwardpy.core import Object, Extension, impl, unregister_module_impls
+
+__version__ = "0.3.0"
+__all__ = ["Object", "Extension", "impl", "unregister_module_impls"]

{forwardpy-0.2.0 → forwardpy-0.3.0}/src/forwardpy/core.py

@@ -12,7 +12,7 @@ import textwrap
 import weakref
 from typing import TypeVar, Generic, Callable, Any, get_type_hints, TYPE_CHECKING
 
-__all__ = ["Object", "Extension", "impl"]
+__all__ = ["Object", "Extension", "impl", "unregister_module_impls"]
 
 # 类型变量
 T = TypeVar("T", bound="Object")
@@ -26,6 +26,10 @@ _attribute_registry: dict[type, dict[str, Any]] = {}
 # 全局 property 注册表: {类: {property名: ForwardpyProperty}}
 _property_registry: dict[type, dict[str, "ForwardpyProperty"]] = {}
 
+# impl 来源追踪: {(类, impl_key) -> 来源模块名}
+# impl_key 为 method_name、"prop_name.getter" 或 "prop_name.setter"
+_impl_sources: dict[tuple[type, str], str] = {}
+
 # 声明方法标记（用于标识未实现的方法）
 _DECLARED_METHODS: str = "__forwardpy_declared_methods__"
 
@@ -460,6 +464,7 @@ def impl(
                     f"Use @forwardpy.impl({prop.owner_cls.__name__}.{prop.name}.getter, override=True) to override."
                 )
             prop._fget = func
+            _impl_sources[(prop.owner_cls, f"{prop.name}.getter")] = getattr(func, "__module__", "") or ""
             return func
 
         # 处理 property setter
@@ -471,6 +476,7 @@ def impl(
                     f"Use @forwardpy.impl({prop.owner_cls.__name__}.{prop.name}.setter, override=True) to override."
                 )
             prop._fset = func
+            _impl_sources[(prop.owner_cls, f"{prop.name}.setter")] = getattr(func, "__module__", "") or ""
             return func
 
         # 获取目标类和方法名
@@ -534,6 +540,9 @@ def impl(
             _method_registry[target_cls] = {}
         _method_registry[target_cls][method_name] = func
 
+        # 记录来源模块
+        _impl_sources[(target_cls, method_name)] = getattr(func, "__module__", "") or ""
+
         # 保留类引用，便于后续 override
         func.__forwardpy_class__ = target_cls
         func.__name__ = method_name
@@ -550,3 +559,50 @@ def impl(
         return func
 
     return decorator
+
+
+def unregister_module_impls(module_name: str) -> int:
+    """移除指定模块注册的所有 @impl，恢复为 stub
+
+    Args:
+        module_name: 来源模块的 __name__
+
+    Returns:
+        被卸载的 impl 数量
+    """
+    to_remove: list[tuple[type, str]] = [
+        (cls, impl_key)
+        for (cls, impl_key), src in _impl_sources.items()
+        if src == module_name
+    ]
+
+    for cls, impl_key in to_remove:
+        del _impl_sources[(cls, impl_key)]
+
+        if impl_key.endswith(".getter"):
+            prop_name = impl_key[:-7]
+            prop = _property_registry.get(cls, {}).get(prop_name)
+            if prop is not None:
+                prop._fget = None
+        elif impl_key.endswith(".setter"):
+            prop_name = impl_key[:-7]
+            prop = _property_registry.get(cls, {}).get(prop_name)
+            if prop is not None:
+                prop._fset = None
+        else:
+            # 普通方法、classmethod 或 staticmethod
+            method_name = impl_key
+            if cls in _method_registry and method_name in _method_registry[cls]:
+                del _method_registry[cls][method_name]
+
+            declared_classmethods = getattr(cls, _DECLARED_CLASSMETHODS, set())
+            declared_staticmethods = getattr(cls, _DECLARED_STATICMETHODS, set())
+
+            if method_name in declared_classmethods:
+                setattr(cls, method_name, _make_stub_classmethod(method_name, cls))
+            elif method_name in declared_staticmethods:
+                setattr(cls, method_name, _make_stub_staticmethod(method_name, cls))
+            else:
+                setattr(cls, method_name, _make_stub_method(method_name, cls))
+
+    return len(to_remove)

{forwardpy-0.2.0 → forwardpy-0.3.0/src/forwardpy.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: forwardpy
-Version: 0.2.0
+Version: 0.3.0
 Summary: Python Interface And Implementation Separation Library
 Author: forwardpy contributors
 License: MIT

{forwardpy-0.2.0 → forwardpy-0.3.0}/src/forwardpy.egg-info/SOURCES.txt

@@ -15,4 +15,5 @@ tests/test_extension.py
 tests/test_impl.py
 tests/test_inheritance.py
 tests/test_object.py
-tests/test_property.py
+tests/test_property.py
+tests/test_unregister.py

forwardpy-0.3.0/tests/test_unregister.py

@@ -0,0 +1,196 @@
+"""Tests for impl source tracking and unregister_module_impls."""
+
+import pytest
+import forwardpy
+from forwardpy.core import (
+    _impl_sources,
+    _method_registry,
+    _property_registry,
+    _DECLARED_METHODS,
+    unregister_module_impls,
+)
+
+
+class TestImplSourceTracking:
+
+    def test_impl_records_source_module(self):
+        class Svc(forwardpy.Object):
+            def run(self) -> str: ...
+
+        @forwardpy.impl(Svc.run)
+        def run(self: Svc) -> str:
+            return "ok"
+
+        assert (Svc, "run") in _impl_sources
+        assert _impl_sources[(Svc, "run")] == __name__
+
+    def test_impl_override_updates_source(self):
+        class Svc2(forwardpy.Object):
+            def run(self) -> str: ...
+
+        @forwardpy.impl(Svc2.run)
+        def run_v1(self) -> str:
+            return "v1"
+
+        old_source = _impl_sources[(Svc2, "run")]
+
+        @forwardpy.impl(Svc2.run, override=True)
+        def run_v2(self) -> str:
+            return "v2"
+
+        assert _impl_sources[(Svc2, "run")] == old_source  # same test module
+
+
+class TestUnregisterModuleImpls:
+
+    def test_unregister_restores_stub_method(self):
+        class A(forwardpy.Object):
+            def do_it(self) -> str: ...
+
+        @forwardpy.impl(A.do_it)
+        def do_it(self) -> str:
+            return "done"
+
+        a = A()
+        assert a.do_it() == "done"
+
+        source_module = _impl_sources[(A, "do_it")]
+        count = unregister_module_impls(source_module)
+        assert count >= 1
+
+        with pytest.raises(NotImplementedError):
+            a.do_it()
+
+    def test_unregister_restores_stub_classmethod(self):
+        class B(forwardpy.Object):
+            @classmethod
+            def create(cls) -> str: ...
+
+        @forwardpy.impl(B.create)
+        def create(cls) -> str:
+            return "created"
+
+        assert B.create() == "created"
+
+        source_module = _impl_sources[(B, "create")]
+        unregister_module_impls(source_module)
+
+        with pytest.raises(NotImplementedError):
+            B.create()
+
+    def test_unregister_restores_stub_staticmethod(self):
+        class C(forwardpy.Object):
+            @staticmethod
+            def helper() -> str: ...
+
+        @forwardpy.impl(C.helper)
+        def helper() -> str:
+            return "helped"
+
+        assert C.helper() == "helped"
+
+        source_module = _impl_sources[(C, "helper")]
+        unregister_module_impls(source_module)
+
+        with pytest.raises(NotImplementedError):
+            C.helper()
+
+    def test_unregister_restores_property_getter(self):
+        class D(forwardpy.Object):
+            @property
+            def value(self) -> int: ...
+
+        @forwardpy.impl(D.value.getter)
+        def get_value(self) -> int:
+            return 42
+
+        d = D()
+        assert d.value == 42
+
+        source_module = _impl_sources[(D, "value.getter")]
+        unregister_module_impls(source_module)
+
+        with pytest.raises(NotImplementedError):
+            _ = d.value
+
+    def test_unregister_returns_count(self):
+        class E(forwardpy.Object):
+            def m1(self) -> str: ...
+            def m2(self) -> str: ...
+
+        # Use a unique fake module name to isolate
+        @forwardpy.impl(E.m1)
+        def m1(self) -> str:
+            return "1"
+
+        @forwardpy.impl(E.m2)
+        def m2(self) -> str:
+            return "2"
+
+        source_module = _impl_sources[(E, "m1")]
+        count = unregister_module_impls(source_module)
+        assert count >= 2
+
+    def test_unregister_only_removes_matching_module(self):
+        class F(forwardpy.Object):
+            def alpha(self) -> str: ...
+            def beta(self) -> str: ...
+
+        # Register alpha from "module_a"
+        def alpha_impl(self) -> str:
+            return "a"
+        alpha_impl.__module__ = "module_a"
+        forwardpy.impl(F.alpha)(alpha_impl)
+
+        # Register beta from "module_b"
+        def beta_impl(self) -> str:
+            return "b"
+        beta_impl.__module__ = "module_b"
+        forwardpy.impl(F.beta)(beta_impl)
+
+        f = F()
+        assert f.alpha() == "a"
+        assert f.beta() == "b"
+
+        # Unregister only module_a
+        count = unregister_module_impls("module_a")
+        assert count == 1
+
+        with pytest.raises(NotImplementedError):
+            f.alpha()
+        # beta should still work
+        assert f.beta() == "b"
+
+    def test_unregister_removes_from_method_registry(self):
+        class G(forwardpy.Object):
+            def work(self) -> str: ...
+
+        @forwardpy.impl(G.work)
+        def work(self) -> str:
+            return "working"
+
+        assert "work" in _method_registry.get(G, {})
+
+        source_module = _impl_sources[(G, "work")]
+        unregister_module_impls(source_module)
+
+        assert "work" not in _method_registry.get(G, {})
+
+    def test_unregister_nonexistent_module_is_noop(self):
+        count = unregister_module_impls("nonexistent.module.xyz")
+        assert count == 0
+
+    def test_unregister_removes_from_impl_sources(self):
+        class H(forwardpy.Object):
+            def proc(self) -> str: ...
+
+        @forwardpy.impl(H.proc)
+        def proc(self) -> str:
+            return "processed"
+
+        assert (H, "proc") in _impl_sources
+
+        source_module = _impl_sources[(H, "proc")]
+        unregister_module_impls(source_module)
+
+        assert (H, "proc") not in _impl_sources

forwardpy-0.2.0/src/forwardpy/__init__.py

@@ -1,10 +0,0 @@
-"""
-forwardpy - Python Interface Class
-
-支持将类拆分到多个文件中编写（声明与实现分离）
-"""
-
-from forwardpy.core import Object, Extension, impl
-
-__version__ = "0.2.0"
-__all__ = ["Object", "Extension", "impl"]