errortools 3.3.0__tar.gz → 3.4.0__tar.gz

{errortools-3.3.0/errortools.egg-info → errortools-3.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: errortools
-Version: 3.3.0
+Version: 3.4.0
 Summary: errortools - a toolset for working with Python exceptions and warnings and logging.
 Author-email: Evan Yang <quantbit@126.com>
 License: Copyright (c) 2026 authors see AUTHORS.txt

{errortools-3.3.0 → errortools-3.4.0}/_errortools/classes/abc.py

@@ -1,5 +1,6 @@
 from typing import Any, Literal, Union
 from abc import ABC, abstractmethod
+from _collections_abc import _check_methods  # type: ignore[attr-defined]
 import copy
 import shutil
 import csv
@@ -12,23 +13,6 @@ else:
     from typing_extensions import disjoint_base
 
 
-def _check_methods(C: type[Any], *methods: str) -> Union[bool, Literal[NotImplemented]]:  # type: ignore
-    """Check methods in `C`. If has, return `True`, else `NotImplemented`."""
-    # from `_collections_abc.py`.
-    # Copyright 2007 Google, Inc. All Rights Reserved.
-    # Licensed to PSF under a Contributor Agreement.
-    mro: tuple[type[Any], ...] = C.__mro__  # Added type hints for mro var
-    for method in methods:
-        for B in mro:
-            if method in B.__dict__:
-                if B.__dict__[method] is None:
-                    return NotImplemented
-                break
-        else:
-            return NotImplemented
-    return True
-
-
 # ----------------------------------------------------------------------
 # ErrorCodeable
 # ----------------------------------------------------------------------

{errortools-3.3.0 → errortools-3.4.0}/_errortools/logging/logger.py

@@ -10,4 +10,4 @@ from .level import Level
 # Create the default global logger.
 # It ships with a single stderr sink at DEBUG level (mirrors loguru's default).
 logger: BaseLogger = BaseLogger(name="errortools")
-logger.add(sys.stderr, level=Level.DEBUG, colorize=None)
+logger.add(sys.stderr, level=Level.TRACE, colorize=None)

errortools-3.4.0/_errortools/plugins.py

@@ -0,0 +1,134 @@
+"""Ultra-lightweight plugin system for errortools."""
+
+from typing import Callable, Any
+
+_REGISTRY: dict[str, Callable[..., Any]] = {}
+_UNSET = object()
+
+__all__ = [
+    "register",
+    "get",
+    "has",
+    "list_all",
+    "run",
+    "remove",
+    "clear",
+    "Registry",
+]
+
+
+def register(name: str) -> Callable:
+    """Register plugin (decorator).
+
+    .. versionadded:: 3.2
+    """
+
+    def decorator(func: Callable) -> Callable:
+        _REGISTRY[name] = func
+        return func
+
+    return decorator
+
+
+def get(name: str, default: Any = _UNSET) -> Any:
+    """Get registered plugin.
+
+    Args:
+        name: Plugin identifier.
+        default: Value returned when the plugin is missing.
+            If not provided, a `ValueError` is raised instead.
+
+    Raises:
+        ValueError: If the plugin does not exist and no *default* was supplied.
+
+    .. versionadded:: 3.2
+    """
+    try:
+        return _REGISTRY[name]
+    except KeyError:
+        if default is not _UNSET:
+            return default
+        raise ValueError(f"Plugin {name!r} is not registered")
+
+
+def has(name: str) -> bool:
+    """Check whether a plugin is registered.
+
+    Args:
+        name: Plugin identifier.
+
+    Returns:
+        ``True`` if a plugin with the given *name* is registered,
+        otherwise ``False``.
+
+    .. versionadded:: 3.3
+    """
+    return name in _REGISTRY
+
+
+def remove(name: str) -> None:
+    """Remove a plugin.
+
+    This is a no-op if the plugin does not exist.
+
+    .. versionadded:: 3.2
+    """
+    _REGISTRY.pop(name, None)
+
+
+def clear() -> None:
+    """Remove all plugins from the registry.
+
+    .. versionadded:: 3.3
+    """
+    _REGISTRY.clear()
+
+
+def list_all() -> list[str]:
+    """List all plugin names.
+
+    .. versionadded:: 3.2
+    """
+    return list(_REGISTRY.keys())
+
+
+def run(name: str, *args, **kwargs) -> Any:
+    """Run plugin.
+
+    Raises:
+        ValueError: If the plugin does not exist.
+
+    .. versionadded:: 3.2
+    """
+    return get(name)(*args, **kwargs)
+
+
+class Registry:
+    """Static class providing an alternative API for the plugin registry.
+
+    .. versionadded:: 3.2
+    """
+
+    @staticmethod
+    def register(name: str, func: Callable) -> None:
+        _REGISTRY[name] = func
+
+    @staticmethod
+    def list_all() -> list[str]:
+        return list_all()
+
+    @staticmethod
+    def get(name: str) -> Any:
+        return get(name)
+
+    @staticmethod
+    def has(name: str) -> bool:
+        return has(name)
+
+    @staticmethod
+    def remove(name: str) -> None:
+        remove(name)
+
+    @staticmethod
+    def clear() -> None:
+        clear()

{errortools-3.3.0 → errortools-3.4.0}/_errortools/version.py

@@ -8,7 +8,7 @@ def _get_version_tuple(version: str) -> tuple[int, int, int]:
     return (major, minor, patch)
 
 
-__version__: str = "3.3.0"
+__version__: str = "3.4.0"
 __version_tuple__: tuple[int, int, int] = _get_version_tuple(__version__)
 __commit_id__: str | None = None
 

{errortools-3.3.0 → errortools-3.4.0}/errortools/__init__.py

@@ -2,6 +2,7 @@
 errortools - a toolset for working with Python exceptions and warnings and logging.
 """
 
+import sys
 from typing import Any
 
 from _errortools.raises import raises, assert_raises, raises_all, reraise
@@ -18,7 +19,7 @@ from _errortools.errno import (
     get_all_errno_codes,
     is_valid_errno,
 )
-from _errortools.classes.group import BaseGroup, GroupErrors
+from _errortools.classes.group import BaseGroup, GroupErrors  # noqa: F401
 from _errortools.decorator.cache import error_cache
 from _errortools.decorator.deprecated import deprecated, experimental
 from _errortools.decorator.handlers import suppress, convert
@@ -47,7 +48,7 @@ from _errortools.classes.abc import (
     Raiseable,
     Error,
 )
-from _errortools.classes.protocol import (
+from _errortools.classes.protocol import (  # noqa: F401
     ExceptionLike,
     ExceptionGroupLike,
     BaseExceptionGroupLike,
@@ -73,7 +74,7 @@ from _errortools.typing import (
     TracebackType,
     FrameType,
 )
-from _errortools.plugins import run, register, list_all, get, remove, Registry
+from _errortools.plugins import run, register, list_all, get, has, remove, clear, Registry
 from _errortools.descriptor.errormsg import ErrorMsg
 from _errortools.descriptor.nonblankmsg import NonBlankErrorMsg
 from _errortools.version import (
@@ -149,6 +150,13 @@ class PluginNamespace:
 
 plugins = PluginNamespace()
 
+_PYTHON_3_11_CAN_USE: list[str] = [
+    "GroupErrors",
+    "BaseGroup",
+    "BaseExceptionGroupLike",
+    "ExceptionGroupLike",
+    "GroupErrorsLike",
+]
 __all__ = [
     # functions
     "raises",
@@ -173,8 +181,6 @@ __all__ = [
     "TracebackType",
     "FrameType",
     # classes
-    "GroupErrors",
-    "BaseGroup",
     "BaseErrorCodes",
     "InvalidInputError",
     "NotFoundError",
@@ -197,8 +203,6 @@ __all__ = [
     "ContextException",
     "Error",
     "ExceptionLike",
-    "ExceptionGroupLike",
-    "BaseExceptionGroupLike",
     "BlockingIOErrorLike",
     "NameErrorLike",
     "StopIterationLike",
@@ -209,7 +213,6 @@ __all__ = [
     "UnicodeEncodeErrorLike",
     "UnicodeTranslateErrorLike",
     "AttributeErrorLike",
-    "GroupErrorsLike",
     "ErrortoolsDeprecationWarning",
     # for type hints
     "PureBaseExceptionType",
@@ -225,9 +228,11 @@ __all__ = [
     # plugins
     "register",
     "get",
+    "has",
     "list_all",
     "run",
     "remove",
+    "clear",
     "Registry",
     # metadata
     "__version__",
@@ -254,3 +259,6 @@ __all__ = [
 ]
 
 __all__.append("plugins")
+
+if sys.version_info >= (3, 11):
+    __all__.append(_PYTHON_3_11_CAN_USE)

{errortools-3.3.0 → errortools-3.4.0/errortools.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: errortools
-Version: 3.3.0
+Version: 3.4.0
 Summary: errortools - a toolset for working with Python exceptions and warnings and logging.
 Author-email: Evan Yang <quantbit@126.com>
 License: Copyright (c) 2026 authors see AUTHORS.txt

{errortools-3.3.0 → errortools-3.4.0}/errortools.egg-info/SOURCES.txt

@@ -41,7 +41,6 @@ _errortools/logging/sink.py
 _errortools/wrappers/__init__.py
 _errortools/wrappers/cache.py
 _errortools/wrappers/ignore.py
-docs/conf.py
 errortools/__init__.py
 errortools/__main__.py
 errortools/future.py
@@ -57,22 +56,15 @@ testing/__init__.py
 testing/__main__.py
 testing/conftest.py
 testing/run_tests.py
-testing/test_abc.py
 testing/test_decorator.py
 testing/test_descriptor.py
 testing/test_errno.py
-testing/test_errorcodes.py
-testing/test_future.py
 testing/test_groups.py
 testing/test_ignore.py
-testing/test_logging.py
-testing/test_partials.py
 testing/test_plugins.py
-testing/test_protocols.py
 testing/test_raises.py
 testing/test_typing.py
 testing/test_version.py
-testing/test_warnings.py
 testing/benchmark/__init__.py
 testing/benchmark/test_future_perf.py
 testing/test_testing/__init__.py

{errortools-3.3.0 → errortools-3.4.0}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "errortools"
-version = "3.3.0"
+version = "3.4.0"
 authors = [
   { name = "Evan Yang", email = "quantbit@126.com" }
 ]

{errortools-3.3.0 → errortools-3.4.0}/testing/__init__.py

@@ -10,7 +10,7 @@ __all__ = [
     "HAS_PYTEST",
     "NO_ONE_CHANGE_VERSION",
 ]
-__version__ = "1.2.5"
+__version__ = "1.3.5"
 __version_tuple__ = _get_version_tuple(__version__)
 
 try:

{errortools-3.3.0 → errortools-3.4.0}/testing/test_plugins.py

@@ -1,105 +1,200 @@
-"""Tests for _errortools/plugins — ultra-lightweight plugin system."""
-
-import pytest
-
-from _errortools.plugins import (
-    register,
-    get,
-    run,
-    list_all,
-    remove,
-    Registry,
-)
-
-# =============================================================================
-# register & run
-# =============================================================================
-
-
-class TestPluginRegisterAndRun:
-    def test_register_decorator(self):
-        @register("test_func")
-        def f():
-            return "ok"
-
-        assert run("test_func") == "ok"
-
-    def test_run_raises_when_not_registered(self):
-        with pytest.raises(ValueError, match="Plugin 'nonexistent' is not registered"):
-            run("nonexistent")
-
-    def test_plugin_with_args_kwargs(self):
-        @register("add")
-        def add(a, b):
-            return a + b
-
-        assert run("add", 2, 3) == 5
-        assert run("add", a=10, b=20) == 30
-
-    def test_get_returns_correct_function(self):
-        @register("myfunc")
-        def f():
-            return "test"
-
-        assert get("myfunc") is f
-
-
-# =============================================================================
-# list_all
-# =============================================================================
-
-
-class TestPluginList:
-    def test_list_all_includes_registered_plugins(self):
-        @register("plugin1")
-        def f1():
-            pass
-
-        @register("plugin2")
-        def f2():
-            pass
-
-        plugins = list_all()
-        assert "plugin1" in plugins
-        assert "plugin2" in plugins
-
-
-# =============================================================================
-# remove
-# =============================================================================
-
-
-class TestPluginRemove:
-    def test_remove_existing_plugin(self):
-        @register("toremove")
-        def f():
-            pass
-
-        remove("toremove")
-        with pytest.raises(ValueError):
-            get("toremove")
-
-    def test_remove_nonexistent_is_safe(self):
-        # Should not raise
-        remove("never_existed")
-
-
-# =============================================================================
-# Registry class (static)
-# =============================================================================
-
-
-class TestRegistryClass:
-    def test_static_register_and_get(self):
-        def my_static_func():
-            return "static"
-
-        Registry.register("static_plugin", my_static_func)
-        assert Registry.get("static_plugin") is my_static_func
-
-    def test_static_list_all(self):
-        @register("listme")
-        def f():
-            pass
-
-        assert "listme" in Registry.list_all()
+"""Tests for _errortools/plugins — ultra-lightweight plugin system."""
+
+import pytest
+
+from _errortools.plugins import (
+    register,
+    get,
+    has,
+    run,
+    list_all,
+    remove,
+    clear,
+    Registry,
+)
+
+# =============================================================================
+# register & run
+# =============================================================================
+
+
+class TestPluginRegisterAndRun:
+    def test_register_decorator(self):
+        @register("test_func")
+        def f():
+            return "ok"
+
+        assert run("test_func") == "ok"
+
+    def test_run_raises_when_not_registered(self):
+        with pytest.raises(ValueError, match="Plugin 'nonexistent' is not registered"):
+            run("nonexistent")
+
+    def test_plugin_with_args_kwargs(self):
+        @register("add")
+        def add(a, b):
+            return a + b
+
+        assert run("add", 2, 3) == 5
+        assert run("add", a=10, b=20) == 30
+
+    def test_get_returns_correct_function(self):
+        @register("myfunc")
+        def f():
+            return "test"
+
+        assert get("myfunc") is f
+
+    def test_get_with_default(self):
+        assert get("missing", default=42) == 42
+
+    def test_get_with_none_default(self):
+        assert get("missing", default=None) is None
+
+    def test_register_overwrites(self):
+        @register("overwrite_me")
+        def first():
+            return "first"
+
+        @register("overwrite_me")
+        def second():
+            return "second"
+
+        assert run("overwrite_me") == "second"
+
+    def test_run_forwards_all_args(self):
+        @register("variadic")
+        def variadic(*args, **kwargs):
+            return (args, kwargs)
+
+        assert run("variadic", 1, 2, x=3) == ((1, 2), {"x": 3})
+
+
+# =============================================================================
+# has
+# =============================================================================
+
+
+class TestPluginHas:
+    def test_has_true(self):
+        @register("exists")
+        def f():
+            pass
+
+        assert has("exists") is True
+
+    def test_has_false(self):
+        assert has("never_registered") is False
+
+
+# =============================================================================
+# list_all
+# =============================================================================
+
+
+class TestPluginList:
+    def test_list_all_includes_registered_plugins(self):
+        @register("plugin1")
+        def f1():
+            pass
+
+        @register("plugin2")
+        def f2():
+            pass
+
+        plugins = list_all()
+        assert "plugin1" in plugins
+        assert "plugin2" in plugins
+
+
+# =============================================================================
+# remove
+# =============================================================================
+
+
+class TestPluginRemove:
+    def test_remove_existing_plugin(self):
+        @register("toremove")
+        def f():
+            pass
+
+        remove("toremove")
+        with pytest.raises(ValueError):
+            get("toremove")
+
+    def test_remove_nonexistent_is_safe(self):
+        # Should not raise
+        remove("never_existed")
+
+    def test_remove_returns_none(self):
+        @register("for_remove")
+        def f():
+            pass
+
+        assert remove("for_remove") is None
+
+
+# =============================================================================
+# clear
+# =============================================================================
+
+
+class TestPluginClear:
+    def test_clear_removes_all(self):
+        @register("a")
+        def a():
+            pass
+
+        @register("b")
+        def b():
+            pass
+
+        clear()
+        assert list_all() == []
+        assert has("a") is False
+        assert has("b") is False
+
+
+# =============================================================================
+# Registry class (static)
+# =============================================================================
+
+
+class TestRegistryClass:
+    def test_static_register_and_get(self):
+        def my_static_func():
+            return "static"
+
+        Registry.register("static_plugin", my_static_func)
+        assert Registry.get("static_plugin") is my_static_func
+
+    def test_static_list_all(self):
+        @register("listme")
+        def f():
+            pass
+
+        assert "listme" in Registry.list_all()
+
+    def test_registry_get_raises_when_missing(self):
+        with pytest.raises(ValueError, match="Plugin 'missing' is not registered"):
+            Registry.get("missing")
+
+    def test_registry_register_overwrites(self):
+        def first():
+            return "first"
+
+        def second():
+            return "second"
+
+        Registry.register("overwrite_registry", first)
+        assert Registry.get("overwrite_registry") is first
+        Registry.register("overwrite_registry", second)
+        assert Registry.get("overwrite_registry") is second
+
+    def test_registry_remove(self):
+        @register("registry_remove_me")
+        def f():
+            pass
+
+        Registry.remove("registry_remove_me")
+        assert has("registry_remove_me") is False