errortools 3.2.0__tar.gz → 3.4.0__tar.gz

{errortools-3.2.0 → errortools-3.4.0}/AUTHORS.txt

@@ -1,6 +1,6 @@
 # (Lines starting with # are comments)
 # Tips:
-#   Contributors are not sorted by initials, 
+#   Contributors are not sorted by initials,
 #   but by contribution time.
 # Here are the real contributors
 aiwonderland
@@ -10,3 +10,4 @@ yangphysics
 # And here are bot contributors
 dependabot[bot]
 AbaAbaAba-bot-like[bot]
+pre-commit-ci[bot]

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: errortools
-Version: 3.2.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
@@ -25,6 +25,7 @@ License: Copyright (c) 2026 authors see AUTHORS.txt
         WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
         
 Project-URL: Homepage, https://github.com/more-abc/errortools
+Project-URL: Documentation, https://errortools.readthedocs.io/
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.8

{errortools-3.2.0 → errortools-3.4.0}/_errortools/_speedup.c

@@ -2,23 +2,23 @@
 #include <Python.h>
 
 /* Fast exception type checking
- * 
+ *
  * Optimized check for exception type hierarchy using PyObject_IsSubclass.
  * Returns False immediately if typ is None, otherwise checks if typ is a
  * subclass of excs.
- * 
+ *
  * Args:
  *   typ: The type object to check (or None)
  *   excs: The exception class(es) to check against
- * 
+ *
  * Returns:
  *   True if typ is a subclass of excs, False otherwise
  *   NULL on error with exception set
  */
 static PyObject* fast_issubclass_check(PyObject* self, PyObject* const* args, Py_ssize_t nargs) {
     if (nargs != 2) {
-        PyErr_Format(PyExc_TypeError, 
-                     "fast_issubclass_check() takes exactly 2 arguments (%zd given)", 
+        PyErr_Format(PyExc_TypeError,
+                     "fast_issubclass_check() takes exactly 2 arguments (%zd given)",
                      nargs);
         return NULL;
     }
@@ -33,7 +33,7 @@ static PyObject* fast_issubclass_check(PyObject* self, PyObject* const* args, Py
 
     /* Validate that excs is a class or tuple of classes */
     if (!PyType_Check(excs) && !PyTuple_Check(excs)) {
-        PyErr_SetString(PyExc_TypeError, 
+        PyErr_SetString(PyExc_TypeError,
                         "second argument must be a class or tuple of classes");
         return NULL;
     }
@@ -52,21 +52,21 @@ static PyObject* fast_issubclass_check(PyObject* self, PyObject* const* args, Py
 }
 
 /* Fast exception collector append
- * 
+ *
  * Optimized append operation for adding exceptions to a list.
- * 
+ *
  * Args:
  *   list: The list object to append to
  *   exc: The exception object to append
- * 
+ *
  * Returns:
  *   None on success
  *   NULL on error with exception set
  */
 static PyObject* fast_append_exception(PyObject* self, PyObject* const* args, Py_ssize_t nargs) {
     if (nargs != 2) {
-        PyErr_Format(PyExc_TypeError, 
-                     "fast_append_exception() takes exactly 2 arguments (%zd given)", 
+        PyErr_Format(PyExc_TypeError,
+                     "fast_append_exception() takes exactly 2 arguments (%zd given)",
                      nargs);
         return NULL;
     }

{errortools-3.2.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.2.0 → errortools-3.4.0}/_errortools/decorator/cache.py

@@ -9,7 +9,6 @@ from typing import (
     overload,
 )
 
-from ..const import DEFAULT_ERROR_CACHE_SIZE
 from ..wrappers.cache import ErrorCacheWrapper
 
 _T = TypeVar("_T", bound=Callable[..., Any])
@@ -28,7 +27,7 @@ def error_cache(maxsize: Optional[int] = 128) -> Callable[[_T], ErrorCacheWrappe
 # fmt: on
 
 
-def error_cache(func: Optional[_T] = None, maxsize: Optional[int] = DEFAULT_ERROR_CACHE_SIZE) -> Any:  # type: ignore
+def error_cache(func: Optional[_T] = None, maxsize: Optional[int] = 128) -> Any:  # type: ignore
     """
     Decorator to cache exceptions raised by a function.
 

{errortools-3.2.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.2.0 → errortools-3.4.0}/_errortools/partial.py

@@ -14,12 +14,6 @@ from .ignore import (
     retry,
 )
 from .decorator.cache import error_cache
-from .const import (
-    LARGE_ERROR_CACHE_SIZE,
-    SMALL_ERROR_CACHE_SIZE,
-    DEFAULT_ERROR_CACHE_SIZE,
-    UNLIMITED_ERROR_CACHE,
-)
 
 # ------------------------------------------------------------------
 # ignore: Common exception shortcuts
@@ -114,10 +108,10 @@ retry_5_delay_1s: Callable = partial(retry, times=5, delay=1)
 # error cache presets
 # ------------------------------------------------------------------
 
-unlimited_error_cache: Callable = partial(error_cache, maxsize=UNLIMITED_ERROR_CACHE)
-lru_error_cache: Callable = partial(error_cache, maxsize=DEFAULT_ERROR_CACHE_SIZE)
-small_error_cache: Callable = partial(error_cache, maxsize=SMALL_ERROR_CACHE_SIZE)
-large_error_cache: Callable = partial(error_cache, maxsize=LARGE_ERROR_CACHE_SIZE)
+unlimited_error_cache: Callable = partial(error_cache, maxsize=1024)
+lru_error_cache: Callable = partial(error_cache, maxsize=128)
+small_error_cache: Callable = partial(error_cache, maxsize=64)
+large_error_cache: Callable = partial(error_cache, maxsize=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.2.0 → errortools-3.4.0}/_errortools/version.py

@@ -1,17 +1,17 @@
-def _get_version_tuple(version: str) -> tuple[int, int, int]:
-    parts = [int(p) for p in version.split(".")]
-
-    major = parts[0] if len(parts) >= 1 else 0
-    minor = parts[1] if len(parts) >= 2 else 0
-    patch = parts[2] if len(parts) >= 3 else 0
-
-    return (major, minor, patch)
-
-
-__version__: str = "3.2.0"
-__version_tuple__: tuple[int, int, int] = _get_version_tuple(__version__)
-__commit_id__: str | None = None
-
-version = __version__
-version_tuple = __version_tuple__
-commit_id = __commit_id__
+def _get_version_tuple(version: str) -> tuple[int, int, int]:
+    parts = [int(p) for p in version.split(".")]
+
+    major = parts[0] if len(parts) >= 1 else 0
+    minor = parts[1] if len(parts) >= 2 else 0
+    patch = parts[2] if len(parts) >= 3 else 0
+
+    return (major, minor, patch)
+
+
+__version__: str = "3.4.0"
+__version_tuple__: tuple[int, int, int] = _get_version_tuple(__version__)
+__commit_id__: str | None = None
+
+version = __version__
+version_tuple = __version_tuple__
+commit_id = __commit_id__

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

@@ -2,6 +2,9 @@
 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
 from _errortools.ignore import (
     ignore,
@@ -16,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
@@ -45,6 +48,22 @@ from _errortools.classes.abc import (
     Raiseable,
     Error,
 )
+from _errortools.classes.protocol import (  # noqa: F401
+    ExceptionLike,
+    ExceptionGroupLike,
+    BaseExceptionGroupLike,
+    BlockingIOErrorLike,
+    NameErrorLike,
+    StopIterationLike,
+    SyntaxErrorLike,
+    SystemExitLike,
+    ImportErrorLike,
+    UnicodeDecodeErrorLike,
+    UnicodeEncodeErrorLike,
+    UnicodeTranslateErrorLike,
+    AttributeErrorLike,
+    GroupErrorsLike,
+)
 from _errortools.typing import (
     AnyErrorCode,
     BaseErrorCodesType,
@@ -55,6 +74,7 @@ from _errortools.typing import (
     TracebackType,
     FrameType,
 )
+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 (
@@ -88,6 +108,10 @@ _DEPRECATED_NAMES: dict[str, tuple[str, str]] = {
 }
 
 
+class ErrortoolsDeprecationWarning(DeprecationWarning):
+    """Base class for warnings about deprecated features in errortools module."""
+
+
 def __getattr__(name: str):
     import importlib
     import warnings
@@ -96,7 +120,7 @@ def __getattr__(name: str):
         attr_name, reason = _DEPRECATED_NAMES[name]
         warnings.warn(
             f"errortools.{attr_name} is deprecated. {reason}",
-            DeprecationWarning,
+            ErrortoolsDeprecationWarning,
             stacklevel=2,
         )
         return globals()[f"_{name}"] if f"_{name}" in globals() else globals().get(name)
@@ -104,6 +128,11 @@ def __getattr__(name: str):
     if name in ("future", "logging", "partial"):
         return importlib.import_module(f"_errortools.{name}")
 
+    try:
+        return get(name)
+    except ValueError:
+        pass
+
     raise AttributeError(f"module 'errortools' has no attribute {name!r}")
 
 
@@ -111,6 +140,23 @@ def __dir__() -> list[str]:
     return __all__
 
 
+class PluginNamespace:
+    def __getattr__(self, name: str) -> Any:
+        plugin = get(name)
+        if plugin is None:
+            raise AttributeError(f"Plugin {name!r} not found")
+        return plugin
+
+
+plugins = PluginNamespace()
+
+_PYTHON_3_11_CAN_USE: list[str] = [
+    "GroupErrors",
+    "BaseGroup",
+    "BaseExceptionGroupLike",
+    "ExceptionGroupLike",
+    "GroupErrorsLike",
+]
 __all__ = [
     # functions
     "raises",
@@ -135,8 +181,6 @@ __all__ = [
     "TracebackType",
     "FrameType",
     # classes
-    "GroupErrors",
-    "BaseGroup",
     "BaseErrorCodes",
     "InvalidInputError",
     "NotFoundError",
@@ -158,6 +202,18 @@ __all__ = [
     "PureBaseException",
     "ContextException",
     "Error",
+    "ExceptionLike",
+    "BlockingIOErrorLike",
+    "NameErrorLike",
+    "StopIterationLike",
+    "SystemExitLike",
+    "ImportErrorLike",
+    "SyntaxErrorLike",
+    "UnicodeDecodeErrorLike",
+    "UnicodeEncodeErrorLike",
+    "UnicodeTranslateErrorLike",
+    "AttributeErrorLike",
+    "ErrortoolsDeprecationWarning",
     # for type hints
     "PureBaseExceptionType",
     "ContextExceptionType",
@@ -169,6 +225,15 @@ __all__ = [
     "RuntimeError_",
     "ExceptionType",
     "WarningType",
+    # plugins
+    "register",
+    "get",
+    "has",
+    "list_all",
+    "run",
+    "remove",
+    "clear",
+    "Registry",
     # metadata
     "__version__",
     "__version_tuple__",
@@ -192,3 +257,8 @@ __all__ = [
     "logging",
     "partial",
 ]
+
+__all__.append("plugins")
+
+if sys.version_info >= (3, 11):
+    __all__.append(_PYTHON_3_11_CAN_USE)

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: errortools
-Version: 3.2.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
@@ -25,6 +25,7 @@ License: Copyright (c) 2026 authors see AUTHORS.txt
         WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
         
 Project-URL: Homepage, https://github.com/more-abc/errortools
+Project-URL: Documentation, https://errortools.readthedocs.io/
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.8

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

@@ -7,12 +7,12 @@ _errortools/__main__.py
 _errortools/_cli.py
 _errortools/_speedup.c
 _errortools/cli.py
-_errortools/const.py
 _errortools/errno.py
 _errortools/future.py
 _errortools/ignore.py
 _errortools/metadata.py
 _errortools/partial.py
+_errortools/plugins.py
 _errortools/py.typed
 _errortools/raises.py
 _errortools/typing.py
@@ -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,20 +56,15 @@ testing/__init__.py
 testing/__main__.py
 testing/conftest.py
 testing/run_tests.py
-testing/test_abc.py
-testing/test_const.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_raises.py
 testing/test_typing.py
-testing/test_warnings.py
+testing/test_version.py
 testing/benchmark/__init__.py
 testing/benchmark/test_future_perf.py
 testing/test_testing/__init__.py

{errortools-3.2.0 → errortools-3.4.0}/errortools.egg-info/top_level.txt

@@ -1,8 +1,3 @@
 _errortools
-build
-dist
-docs
-emeps
 errortools
-htmlcov
 testing

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

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "errortools"
-version = "3.2.0"
+version = "3.4.0"
 authors = [
   { name = "Evan Yang", email = "quantbit@126.com" }
 ]
@@ -38,6 +38,7 @@ classifiers = [
 
 [project.urls]
 Homepage = "https://github.com/more-abc/errortools"
+Documentation = "https://errortools.readthedocs.io/"
 
 
 [project.scripts]
@@ -50,6 +51,8 @@ _errortools = ["py.typed"]
 
 [tool.setuptools.packages.find]
 where = ["."]
+include = ["errortools", "_errortools", "testing"]
+exclude = ["htmlcov", ".*", "docs"]
 
 
 [[tool.setuptools.ext-modules]]

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

@@ -2,14 +2,16 @@
 
 import warnings
 
+from _errortools.version import _get_version_tuple
+
 __all__ = [
     "__version__",
     "__version_tuple__",
     "HAS_PYTEST",
     "NO_ONE_CHANGE_VERSION",
 ]
-__version__ = "1.2.0"
-__version_tuple__ = (1, 2, 0)
+__version__ = "1.3.5"
+__version_tuple__ = _get_version_tuple(__version__)
 
 try:
     import pytest

errortools-3.4.0/testing/benchmark/__init__.py

@@ -0,0 +1,4 @@
+from _errortools.version import _get_version_tuple
+
+__version__ = "0.1.0"
+__version_tuple__ = _get_version_tuple(__version__)