errortools 3.2.0__tar.gz → 3.3.0__tar.gz

{errortools-3.2.0 → errortools-3.3.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.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: errortools
-Version: 3.2.0
+Version: 3.3.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.3.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.3.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.3.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.3.0/_errortools/plugins.py

@@ -0,0 +1,83 @@
+"""Ultra-lightweight plugin system for errortools."""
+
+from typing import Callable, Any
+
+_REGISTRY: dict[str, Callable[..., Any]] = {}
+
+__all__ = [
+    "register",
+    "get",
+    "list_all",
+    "run",
+    "remove",
+    "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 = None) -> Any:
+    """
+    Get registered plugin
+
+    .. versionadded:: 3.2
+    """
+    plugin = _REGISTRY.get(name)
+    if plugin is None:
+        if default is not None:
+            return default
+        raise ValueError(f"Plugin {name!r} is not registered")
+    return plugin
+
+
+def remove(name: str) -> None:
+    """
+    Remove a plugin
+
+    .. versionadded:: 3.2
+    """
+    _REGISTRY.pop(name, None)
+
+
+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
+
+    .. versionadded:: 3.2"""
+    return get(name)(*args, **kwargs)
+
+
+class 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)

{errortools-3.2.0 → errortools-3.3.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.3.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.3.0}/docs/conf.py

@@ -1,56 +1,60 @@
-# Configuration file for the Sphinx documentation builder.
-#
-# For the full list of built-in configuration values, see the documentation:
-# https://www.sphinx-doc.org/en/master/usage/configuration.html
-
-# -- Project information -----------------------------------------------------
-# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
-
-
-from _errortools.version import __version__, __version_tuple__
-
-project = "errortools"
-copyright = "(C) 2026 aiwonderland and more-abc team"
-author = "aiwonderland"
-release = __version__
-version = f"{__version_tuple__[0]}.{__version_tuple__[1]}"
-
-
-# -- General configuration ---------------------------------------------------
-# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
-
-
-templates_path = ["_templates"]
-exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
-
-
-# -- Options for HTML output -------------------------------------------------
-# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
-
-html_static_path = ["_static"]
-
-extensions = [
-    "myst_parser",
-    "sphinx_rtd_theme",
-    "sphinx.ext.intersphinx",
-    "sphinx.ext.viewcode",
-]
-
-source_suffix = {
-    # ".rst": "restructuredtext",
-    ".md": "markdown",
-}
-
-html_theme = "sphinx_rtd_theme"
-
-myst_enable_extensions = [
-    "colon_fence",
-    "dollarmath",
-    "tasklist",
-]
-
-intersphinx_mapping = {
-    "python": ("https://docs.python.org/3", None),
-}
-
-autodoc_member_order = "bysource"
+# Configuration file for the Sphinx documentation builder.
+#
+# For the full list of built-in configuration values, see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+# -- Project information -----------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
+
+from _errortools.version import __version__, __version_tuple__
+import os
+import sys
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)) + "/..")
+
+
+project = "errortools"
+copyright = "(C) 2026 aiwonderland and more-abc team"
+author = "aiwonderland"
+release = __version__
+version = f"{__version_tuple__[0]}.{__version_tuple__[1]}"
+
+
+# -- General configuration ---------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
+
+
+templates_path = ["_templates"]
+exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
+
+
+# -- Options for HTML output -------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
+
+html_static_path = ["_static"]
+
+extensions = [
+    "myst_parser",
+    "sphinx_rtd_theme",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.viewcode",
+]
+
+source_suffix = {
+    # ".rst": "restructuredtext",
+    ".md": "markdown",
+}
+
+html_theme = "sphinx_rtd_theme"
+
+myst_enable_extensions = [
+    "colon_fence",
+    "dollarmath",
+    "tasklist",
+]
+
+intersphinx_mapping = {
+    "python": ("https://docs.python.org/3", None),
+}
+
+autodoc_member_order = "bysource"

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

@@ -2,6 +2,8 @@
 errortools - a toolset for working with Python exceptions and warnings and logging.
 """
 
+from typing import Any
+
 from _errortools.raises import raises, assert_raises, raises_all, reraise
 from _errortools.ignore import (
     ignore,
@@ -45,6 +47,22 @@ from _errortools.classes.abc import (
     Raiseable,
     Error,
 )
+from _errortools.classes.protocol import (
+    ExceptionLike,
+    ExceptionGroupLike,
+    BaseExceptionGroupLike,
+    BlockingIOErrorLike,
+    NameErrorLike,
+    StopIterationLike,
+    SyntaxErrorLike,
+    SystemExitLike,
+    ImportErrorLike,
+    UnicodeDecodeErrorLike,
+    UnicodeEncodeErrorLike,
+    UnicodeTranslateErrorLike,
+    AttributeErrorLike,
+    GroupErrorsLike,
+)
 from _errortools.typing import (
     AnyErrorCode,
     BaseErrorCodesType,
@@ -55,6 +73,7 @@ from _errortools.typing import (
     TracebackType,
     FrameType,
 )
+from _errortools.plugins import run, register, list_all, get, remove, Registry
 from _errortools.descriptor.errormsg import ErrorMsg
 from _errortools.descriptor.nonblankmsg import NonBlankErrorMsg
 from _errortools.version import (
@@ -88,6 +107,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 +119,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 +127,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 +139,16 @@ 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()
+
 __all__ = [
     # functions
     "raises",
@@ -158,6 +196,21 @@ __all__ = [
     "PureBaseException",
     "ContextException",
     "Error",
+    "ExceptionLike",
+    "ExceptionGroupLike",
+    "BaseExceptionGroupLike",
+    "BlockingIOErrorLike",
+    "NameErrorLike",
+    "StopIterationLike",
+    "SystemExitLike",
+    "ImportErrorLike",
+    "SyntaxErrorLike",
+    "UnicodeDecodeErrorLike",
+    "UnicodeEncodeErrorLike",
+    "UnicodeTranslateErrorLike",
+    "AttributeErrorLike",
+    "GroupErrorsLike",
+    "ErrortoolsDeprecationWarning",
     # for type hints
     "PureBaseExceptionType",
     "ContextExceptionType",
@@ -169,6 +222,13 @@ __all__ = [
     "RuntimeError_",
     "ExceptionType",
     "WarningType",
+    # plugins
+    "register",
+    "get",
+    "list_all",
+    "run",
+    "remove",
+    "Registry",
     # metadata
     "__version__",
     "__version_tuple__",
@@ -192,3 +252,5 @@ __all__ = [
     "logging",
     "partial",
 ]
+
+__all__.append("plugins")

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: errortools
-Version: 3.2.0
+Version: 3.3.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.3.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
@@ -58,7 +58,6 @@ 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
@@ -68,8 +67,11 @@ 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

{errortools-3.2.0 → errortools-3.3.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.3.0}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "errortools"
-version = "3.2.0"
+version = "3.3.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.3.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.2.5"
+__version_tuple__ = _get_version_tuple(__version__)
 
 try:
     import pytest

errortools-3.3.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__)