errortools 3.0.0__tar.gz → 3.1.0__tar.gz

errortools-3.1.0/AUTHORS.txt

@@ -0,0 +1,12 @@
+# (Lines starting with # are comments)
+# Tips:
+#   Contributors are not sorted by initials, 
+#   but by contribution time.
+# Here are the real contributors
+aiwonderland
+qorexdev
+vgauraha62
+yangphysics
+# And here are bot contributors
+dependabot[bot]
+AbaAbaAba-bot-like[bot]

{errortools-3.0.0/errortools.egg-info → errortools-3.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: errortools
-Version: 3.0.0
+Version: 3.1.0
 Summary: errortools - a toolset for working with Python exceptions and warnings and logging.
 Home-page: https://github.com/more-abc/errortools
 Author: Evan Yang
@@ -46,6 +46,7 @@ A lightweight Python exception handling utility library.
 ![This month commits](https://img.shields.io/github/commit-activity/m/more-abc/errortools)
 ![Past year commits](https://img.shields.io/github/commit-activity/y/more-abc/errortools)
 ![Total commits badge](https://img.shields.io/github/commit-activity/t/more-abc/errortools)
+![OS support](https://img.shields.io/badge/OS-macOS%20Linux%20Windows-red)
 
 ## Features
 - **Raise Exceptions**: `raises()`, `raises_all()`, `reraise()` — batch raising and exception conversion
@@ -96,7 +97,7 @@ assert err.traceback          # full formatted traceback string
 | `exception` | `Exception \| None` | The original exception instance |
 | `traceback` | `str \| None` | Formatted traceback string for debugging |
 
-## Examples
+## Sorry, but there was more code examples!
 
 ```python
 # ── ignore as a decorator ──

{errortools-3.0.0 → errortools-3.1.0}/README.md

@@ -8,6 +8,7 @@ A lightweight Python exception handling utility library.
 ![This month commits](https://img.shields.io/github/commit-activity/m/more-abc/errortools)
 ![Past year commits](https://img.shields.io/github/commit-activity/y/more-abc/errortools)
 ![Total commits badge](https://img.shields.io/github/commit-activity/t/more-abc/errortools)
+![OS support](https://img.shields.io/badge/OS-macOS%20Linux%20Windows-red)
 
 ## Features
 - **Raise Exceptions**: `raises()`, `raises_all()`, `reraise()` — batch raising and exception conversion
@@ -58,7 +59,7 @@ assert err.traceback          # full formatted traceback string
 | `exception` | `Exception \| None` | The original exception instance |
 | `traceback` | `str \| None` | Formatted traceback string for debugging |
 
-## Examples
+## Sorry, but there was more code examples!
 
 ```python
 # ── ignore as a decorator ──

errortools-3.1.0/_errortools/_speedup.c

@@ -0,0 +1,127 @@
+#define PY_SSIZE_T_CLEAN
+#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)", 
+                     nargs);
+        return NULL;
+    }
+
+    PyObject *typ = args[0];
+    PyObject *excs = args[1];
+
+    /* Handle None case explicitly */
+    if (typ == Py_None) {
+        Py_RETURN_FALSE;
+    }
+
+    /* Validate that excs is a class or tuple of classes */
+    if (!PyType_Check(excs) && !PyTuple_Check(excs)) {
+        PyErr_SetString(PyExc_TypeError, 
+                        "second argument must be a class or tuple of classes");
+        return NULL;
+    }
+
+    int result = PyObject_IsSubclass(typ, excs);
+    if (result == -1) {
+        return NULL;  /* Exception already set by PyObject_IsSubclass */
+    }
+
+    /* Return bool directly instead of going through PyBool_FromLong */
+    if (result == 1) {
+        Py_RETURN_TRUE;
+    } else {
+        Py_RETURN_FALSE;
+    }
+}
+
+/* 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)", 
+                     nargs);
+        return NULL;
+    }
+
+    PyObject *list = args[0];
+    PyObject *exc = args[1];
+
+    /* Validate that first argument is actually a list */
+    if (!PyList_Check(list)) {
+        PyErr_SetString(PyExc_TypeError, "first argument must be a list");
+        return NULL;
+    }
+
+    if (PyList_Append(list, exc) == -1) {
+        return NULL;  /* Exception already set by PyList_Append */
+    }
+
+    Py_RETURN_NONE;
+}
+
+/* Method definitions */
+static PyMethodDef SpeedupMethods[] = {
+    {
+        "fast_issubclass_check",
+        (PyCFunction)fast_issubclass_check,
+        METH_FASTCALL,
+        "fast_issubclass_check(typ, excs) -> bool\n\n"
+        "Check if typ is a subclass of excs exception type(s).\n"
+        "Returns False if typ is None, otherwise uses PyObject_IsSubclass.\n"
+        "Optimized for exception handling performance."
+    },
+    {
+        "fast_append_exception",
+        (PyCFunction)fast_append_exception,
+        METH_FASTCALL,
+        "fast_append_exception(list, exc) -> None\n\n"
+        "Append an exception to a list with minimal overhead.\n"
+        "Validates that the first argument is a list."
+    },
+    {NULL, NULL, 0, NULL}  /* Sentinel */
+};
+
+/* Module definition */
+static struct PyModuleDef speedupmodule = {
+    PyModuleDef_HEAD_INIT,
+    "_speedup",                 /* name */
+    "C speedup module for errortools\n\n"
+    "Provides optimized implementations of exception handling operations:\n"
+    "  - fast_issubclass_check: Quick exception type hierarchy checking\n"
+    "  - fast_append_exception: Efficient exception list append operations",
+    -1,                         /* size */
+    SpeedupMethods               /* methods */
+};
+
+/* Module initialization */
+PyMODINIT_FUNC PyInit__speedup(void) {
+    return PyModule_Create(&speedupmodule);
+}

{errortools-3.0.0 → errortools-3.1.0}/_errortools/cli.py

@@ -95,7 +95,7 @@ def main() -> None:
     elif args.url:
         print(f"URL: {__url__}")
     elif args.run_tests:
-        from tests.run_tests import run_tests
+        from testing.run_tests import run_tests
 
         run_tests()
     elif args.info:

{errortools-3.0.0 → errortools-3.1.0}/_errortools/ignore.py

@@ -107,11 +107,19 @@ class fast_ignore:
         >>> with fast_ignore(KeyError):
         ...     d = {}
         ...     _ = d["missing"]
+
+    .. deprecated:: 3.0.0
+        This class is deprecated as it is functionally redundant.
     """
 
     __slots__ = ("_excs",)
 
     def __init__(self, *excs: ExceptionType) -> None:
+        warnings.warn(
+            "fast_ignore is deprecated as it is functionally redundant.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         for exc in excs:
             if not isinstance(exc, type) or not issubclass(exc, BaseException):
                 raise TypeError(f"Expected Exception subclass, got {exc!r}")

{errortools-3.0.0 → errortools-3.1.0}/_errortools/typing.py

@@ -63,16 +63,28 @@ AnyErrorCode: TypeAlias = Union[
 """Union of all predefined error-code subclasses."""
 
 InputError: TypeAlias = InvalidInputError
-"""Alias for `InvalidInputError` (1001)."""
+"""Alias for `InvalidInputError` (1001).
+
+.. deprecated:: 3.0.0
+    This type alias is deprecated as it is redundant."""
 
 AccessError: TypeAlias = AccessDeniedError
-"""Alias for `AccessDeniedError` (2001)."""
+"""Alias for `AccessDeniedError` (2001).
+
+.. deprecated:: 3.0.0
+    This type alias is deprecated as it is redundant."""
 
 LookupError_: TypeAlias = NotFoundError
-"""Alias for `NotFoundError` (3001). Trailing underscore avoids shadowing builtins."""
+"""Alias for `NotFoundError` (3001). Trailing underscore avoids shadowing builtins.
+
+.. deprecated:: 3.0.0
+    This type alias is deprecated as it is redundant."""
 
 RuntimeError_: TypeAlias = Union[RuntimeFailure, TimeoutFailure]
-"""Union of runtime-related errors: `RuntimeFailure` (4001) and `TimeoutFailure` (4002)."""
+"""Union of runtime-related errors: `RuntimeFailure` (4001) and `TimeoutFailure` (4002).
+
+.. deprecated:: 3.0.0
+    This type alias is deprecated as it is redundant."""
 
 # ---------------------------------------------------------------------------
 # More type aliases

{errortools-3.0.0 → errortools-3.1.0}/_errortools/version.py

@@ -1,5 +1,5 @@
-__version__: str = "3.0.0"
-__version_tuple__: tuple[int, int, int] = (3, 0, 0)
+__version__: str = "3.1.0"
+__version_tuple__: tuple[int, int, int] = (3, 1, 0)
 __commit_id__: str | None = None
 
 version = __version__

{errortools-3.0.0 → errortools-3.1.0/errortools.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: errortools
-Version: 3.0.0
+Version: 3.1.0
 Summary: errortools - a toolset for working with Python exceptions and warnings and logging.
 Home-page: https://github.com/more-abc/errortools
 Author: Evan Yang
@@ -46,6 +46,7 @@ A lightweight Python exception handling utility library.
 ![This month commits](https://img.shields.io/github/commit-activity/m/more-abc/errortools)
 ![Past year commits](https://img.shields.io/github/commit-activity/y/more-abc/errortools)
 ![Total commits badge](https://img.shields.io/github/commit-activity/t/more-abc/errortools)
+![OS support](https://img.shields.io/badge/OS-macOS%20Linux%20Windows-red)
 
 ## Features
 - **Raise Exceptions**: `raises()`, `raises_all()`, `reraise()` — batch raising and exception conversion
@@ -96,7 +97,7 @@ assert err.traceback          # full formatted traceback string
 | `exception` | `Exception \| None` | The original exception instance |
 | `traceback` | `str \| None` | Formatted traceback string for debugging |
 
-## Examples
+## Sorry, but there was more code examples!
 
 ```python
 # ── ignore as a decorator ──

errortools-3.1.0/errortools.egg-info/SOURCES.txt

@@ -0,0 +1,47 @@
+AUTHORS.txt
+LICENSE.txt
+README.md
+setup.py
+_errortools/__init__.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/py.typed
+_errortools/raises.py
+_errortools/typing.py
+_errortools/version.py
+errortools/__init__.py
+errortools/__main__.py
+errortools/future.py
+errortools/logging.py
+errortools/partial.py
+errortools.egg-info/PKG-INFO
+errortools.egg-info/SOURCES.txt
+errortools.egg-info/dependency_links.txt
+errortools.egg-info/entry_points.txt
+errortools.egg-info/requires.txt
+errortools.egg-info/top_level.txt
+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_raises.py
+testing/test_typing.py
+testing/test_warnings.py

{errortools-3.0.0 → errortools-3.1.0}/errortools.egg-info/entry_points.txt

@@ -1,3 +1,2 @@
 [console_scripts]
 logger = _errortools.cli:main
-python -m errortools = _errortools.cli:main

{errortools-3.0.0 → errortools-3.1.0}/errortools.egg-info/top_level.txt

@@ -1,3 +1,3 @@
 _errortools
 errortools
-tests
+testing

{errortools-3.0.0 → errortools-3.1.0}/setup.py

@@ -1,11 +1,11 @@
 import sys
 
-from setuptools import setup, find_packages, Extension
+from setuptools import setup, Extension
 
-_VERSION: str = "3.0.0"
+_VERSION: str = "3.1.0"
 _CLI_INFO: dict[str, list[str]] = {
     "console_scripts": [
-        "python -m errortools = _errortools.cli:main",
+        # "python -m errortools = _errortools.cli:main",
         "logger = _errortools.cli:main",
     ]
 }
@@ -48,7 +48,7 @@ setup(
         "Operating System :: OS Independent",
         "Typing :: Typed",
     ],
-    packages=find_packages(),
+    packages=["_errortools", "errortools", "testing"],
     package_data={"errortools": ["py.typed"]},
     include_package_data=True,
     python_requires=">=3.8",

{errortools-3.0.0/tests → errortools-3.1.0/testing}/__init__.py

@@ -1,7 +1,6 @@
 """Tests for `errortools` module. Using pytest."""
 
-__version__ = "1.16"
-
+__version__ = "1.1.19"
 try:
     import pytest
 except ImportError:

errortools-3.1.0/testing/__main__.py

@@ -0,0 +1,4 @@
+from .run_tests import run_tests
+
+if __name__ == "__main__":
+    run_tests()

{errortools-3.0.0/tests → errortools-3.1.0/testing}/test_abc.py

@@ -17,9 +17,6 @@ import configparser
 # Import the ABC classes to test
 from _errortools.classes.abc import ErrorCodeable, Warnable, Raiseable, Error
 
-# NOTE: Tests for `ErrorAttrable` was in `test_mixin.py`.
-
-
 # =============================================================================
 # ErrorCodeable ABC Tests
 # =============================================================================

errortools-3.1.0/testing/test_groups.py

@@ -0,0 +1,130 @@
+"""Tests for _errortools/classes/group.py — GroupErrors and BaseGroup."""
+
+import sys
+
+import pytest
+
+from _errortools.classes.group import GroupErrors, BaseGroup
+
+# =============================================================================
+# GroupErrors — collect / raise_group / clear
+# =============================================================================
+
+
+class TestGroupErrors:
+    def test_starts_empty(self):
+        g = GroupErrors()
+        assert len(g) == 0
+        assert not g
+
+    def test_collect_adds_exception(self):
+        g = GroupErrors()
+        g.collect(ValueError("v"))
+        assert len(g) == 1
+
+    def test_collect_multiple(self):
+        g = GroupErrors()
+        g.collect(ValueError("v"))
+        g.collect(TypeError("t"))
+        g.collect(KeyError("k"))
+        assert len(g) == 3
+
+    def test_bool_true_when_not_empty(self):
+        g = GroupErrors()
+        g.collect(RuntimeError("r"))
+        assert bool(g) is True
+
+    def test_bool_false_when_empty(self):
+        assert bool(GroupErrors()) is False
+
+    def test_errors_returns_copy(self):
+        g = GroupErrors()
+        e = ValueError("v")
+        g.collect(e)
+        snapshot = g.errors
+        snapshot.clear()  # mutating the copy must not affect the group
+        assert len(g) == 1
+
+    def test_raise_group_raises_exception_group(self):
+        g = GroupErrors()
+        g.collect(ValueError("v"))
+        g.collect(TypeError("t"))
+        with pytest.raises(ExceptionGroup) as exc_info:
+            g.raise_group()
+        assert len(exc_info.value.exceptions) == 2
+
+    def test_raise_group_uses_group_msg(self):
+        g = GroupErrors("my errors")
+        g.collect(ValueError("v"))
+        with pytest.raises(ExceptionGroup) as exc_info:
+            g.raise_group()
+        assert exc_info.value.message == "my errors"
+
+    def test_raise_group_default_msg(self):
+        g = GroupErrors()
+        g.collect(ValueError("v"))
+        with pytest.raises(ExceptionGroup) as exc_info:
+            g.raise_group()
+        assert exc_info.value.message == "multiple errors"
+
+    def test_raise_group_does_nothing_when_empty(self):
+        g = GroupErrors()
+        g.raise_group()  # should not raise
+
+    def test_clear_removes_all_exceptions(self):
+        g = GroupErrors()
+        g.collect(ValueError("v"))
+        g.collect(TypeError("t"))
+        g.clear()
+        assert len(g) == 0
+
+    def test_clear_then_raise_group_noop(self):
+        g = GroupErrors()
+        g.collect(ValueError("v"))
+        g.clear()
+        g.raise_group()  # no raise — nothing collected
+
+    def test_repr_contains_msg_and_count(self):
+        g = GroupErrors("test group")
+        g.collect(ValueError("v"))
+        r = repr(g)
+        assert "GroupErrors" in r
+        assert "test group" in r
+
+    def test_sub_exception_types_preserved(self):
+        g = GroupErrors()
+        v = ValueError("val")
+        t = TypeError("type")
+        g.collect(v)
+        g.collect(t)
+        with pytest.raises(ExceptionGroup) as exc_info:
+            g.raise_group()
+        exc_types = {type(e) for e in exc_info.value.exceptions}
+        assert exc_types == {ValueError, TypeError}
+
+
+if sys.version_info <= (3, 10):
+    del TestGroupErrors
+
+
+# =============================================================================
+# BaseGroup — abstract interface
+# =============================================================================
+
+
+class TestBaseGroupAbstract:
+    def test_base_group_has_abstract_methods(self):
+        abstract = BaseGroup.__abstractmethods__
+        assert "errors" in abstract
+        assert "collect" in abstract
+        assert "clear" in abstract
+        assert "raise_group" in abstract
+
+    def test_concrete_subclass_is_valid(self):
+        g = GroupErrors()
+        assert isinstance(g, BaseGroup)
+
+    def test_group_errors_satisfies_abstract_interface(self):
+        abstract = BaseGroup.__abstractmethods__
+        for method in abstract:
+            assert hasattr(GroupErrors, method), f"GroupErrors missing: {method}"

errortools-3.0.0/AUTHORS.txt

@@ -1,3 +0,0 @@
-aiwonderland
-qorexdev
-vgauraha62

errortools-3.0.0/_errortools/_speedup.c

@@ -1,58 +0,0 @@
-#define PY_SSIZE_T_CLEAN
-#include <Python.h>
-
-/* Fast exception type checking */
-static PyObject* fast_issubclass_check(PyObject* self, PyObject* args) {
-    PyObject *typ, *excs;
-    if (!PyArg_ParseTuple(args, "OO", &typ, &excs)) {
-        return NULL;
-    }
-
-    if (typ == Py_None) {
-        Py_RETURN_FALSE;
-    }
-
-    int result = PyObject_IsSubclass(typ, excs);
-    if (result == -1) {
-        return NULL;
-    }
-
-    return PyBool_FromLong(result);
-}
-
-/* Fast exception collector append */
-static PyObject* fast_append_exception(PyObject* self, PyObject* args) {
-    PyObject *list, *exc;
-    if (!PyArg_ParseTuple(args, "OO", &list, &exc)) {
-        return NULL;
-    }
-
-    if (PyList_Append(list, exc) == -1) {
-        return NULL;
-    }
-
-    Py_RETURN_NONE;
-}
-
-/* Method definitions */
-static PyMethodDef SpeedupMethods[] = {
-    {"fast_issubclass_check", fast_issubclass_check, METH_VARARGS,
-     "Fast exception type checking"},
-    {"fast_append_exception", fast_append_exception, METH_VARARGS,
-     "Fast exception list append"},
-    {NULL, NULL, 0, NULL}
-};
-
-/* Module definition */
-static struct PyModuleDef speedupmodule = {
-    PyModuleDef_HEAD_INIT,
-    "_speedup",
-    "C speedup for errortools",
-    -1,
-    SpeedupMethods
-};
-
-/* Module initialization */
-PyMODINIT_FUNC PyInit__speedup(void) {
-    return PyModule_Create(&speedupmodule);
-}

errortools-3.0.0/_errortools/classes/__init__.py

@@ -1 +0,0 @@
-"""Base classes."""