errortools 1.2.0__tar.gz → 2.0.0__tar.gz

errortools-2.0.0/AUTHORS.txt

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

{errortools-1.2.0/errortools.egg-info → errortools-2.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: errortools
-Version: 1.2.0
+Version: 2.0.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
@@ -19,6 +19,7 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
 License-File: AUTHORS.txt
+Requires-Dist: namebyauthor==1.0.0
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -27,6 +28,7 @@ Dynamic: description-content-type
 Dynamic: home-page
 Dynamic: license
 Dynamic: license-file
+Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary
 
@@ -35,7 +37,7 @@ A lightweight Python exception handling utility library.
 
 ## Features
 - **Raise Exceptions**: `raises()`, `raises_all()`, `reraise()` — batch raising and exception conversion
-- **Catch & Suppress**: `ignore()`, `ignore_subclass()`, `ignore_warns()`, `fast_ignore()`, `super_fast_ignore()`, `timeout()` — graceful suppression of exceptions and warnings
+- **Catch & Suppress**: `ignore()`, `ignore_subclass()`, `ignore_warns()`, `fast_ignore()`, `super_fast_ignore()`, `timeout()`, `retry()` — graceful suppression of exceptions and warnings, with automatic retry
 - **Exception Caching**: `error_cache` — cache exceptions raised by functions (similar to `lru_cache`)
 - **Custom Exceptions**: `PureBaseException`, `ContextException`, `BaseErrorCodes`, `BaseWarning` — structured exception classes with error codes, trace IDs, and context
 - **Attribute Error Mixin**: Customize error behavior for attribute access, assignment, and deletion
@@ -49,12 +51,12 @@ pip install errortools
 
 ---
 
-## Example
+## Examples
 
 ```python
 import warnings
 from errortools import (
-    ignore, fast_ignore, ignore_subclass, ignore_warns, timeout,
+    ignore, fast_ignore, ignore_subclass, ignore_warns, timeout, retry,
     reraise, raises, raises_all, assert_raises,
     error_cache,
     PureBaseException, ContextException, BaseErrorCodes, BaseWarning,
@@ -70,8 +72,22 @@ assert err.name == "KeyError" # exception class name
 assert err.count == 1         # how many times suppressed
 assert err.exception          # the original KeyError instance
 assert err.traceback          # full formatted traceback string
+```
+
+**Attributes on the returned object:**
+
+| Attribute | Type | Description |
+|---|---|---|
+| `be_ignore` | `bool` | `True` if an exception was suppressed |
+| `name` | `str \| None` | Class name of the suppressed exception |
+| `count` | `int` | Number of suppressed exceptions |
+| `exception` | `Exception \| None` | The original exception instance |
+| `traceback` | `str \| None` | Formatted traceback string for debugging |
+
+## Examples
 
-# ignore as a decorator
+```python
+# ── ignore as a decorator ──
 @ignore(ValueError, TypeError)
 def parse(x: str) -> int:
     return int(x)
@@ -103,14 +119,29 @@ async def fetch_data(url: str) -> bytes:
 
 # asyncio.TimeoutError raised automatically if it exceeds 5 s
 
-# ── 6. reraise ── convert exception types on the fly ─────────────────────────
+# ── 6. retry ── automatically retry on failure ───────────────────────────────
+@retry(times=3, on=ConnectionError, delay=1.0)
+def connect(host: str) -> None:
+    ...                               # retried up to 3 times on ConnectionError
+
+# works with async functions too
+@retry(times=5, on=TimeoutError, delay=0.5)
+async def fetch(url: str) -> bytes:
+    ...
+
+# multiple exception types
+@retry(times=2, on=(ValueError, KeyError))
+def parse(data: dict) -> str:
+    return data["key"]
+
+# ── 7. reraise ── convert exception types on the fly ─────────────────────────
 with reraise(KeyError, ValueError):
     raise KeyError("missing key")      # → ValueError: 'missing key'
 
 with reraise((KeyError, IndexError), RuntimeError):
     _ = [][99]                         # → RuntimeError: list index out of range
 
-# ── 7. raises / raises_all ── batch raise ────────────────────────────────────
+# ── 8. raises / raises_all ── batch raise ────────────────────────────────────
 raises([ValueError], ["bad input"])    # → ValueError: bad input
 
 raises_all(
@@ -118,11 +149,11 @@ raises_all(
     ["bad input"],
 )                                      # → ExceptionGroup (2 sub-exceptions)
 
-# ── 8. assert_raises ── assert a callable raises ─────────────────────────────
+# ── 9. assert_raises ── assert a callable raises ─────────────────────────────
 exc = assert_raises(int, [ValueError], "not-a-number")
 print(exc)   # invalid literal for int() with base 10: 'not-a-number'
 
-# ── 9. error_cache ── cache exceptions by call arguments ─────────────────────
+# ── 10. error_cache ── cache exceptions by call arguments ─────────────────────
 @error_cache(maxsize=64)
 def load(user_id: int) -> dict:
     if user_id < 0:
@@ -135,7 +166,7 @@ with ignore(ValueError):
 print(load.cache_info())  # CacheInfo(hits=0, misses=1, maxsize=64, currsize=1)
 load.clear_cache()
 
-# ── 10. Custom exceptions — three layers ──────────────────────────────────────
+# ── 11. Custom exceptions — three layers ──────────────────────────────────────
 
 # Layer 1: PureBaseException — code + detail only
 class AppError(PureBaseException):
@@ -171,7 +202,7 @@ raise BaseErrorCodes.runtime_failure("crash")             # RuntimeFailure     [
 raise BaseErrorCodes.timeout_failure()                    # TimeoutFailure     [4002]
 raise BaseErrorCodes.configuration_error("missing key")   # ConfigurationError [5001]
 
-# ── 11. BaseWarning ── structured warnings with factory methods ───────────────
+# ── 12. BaseWarning ── structured warnings with factory methods ───────────────
 class ExperimentalWarning(BaseWarning):
     default_detail = "This feature is experimental."
 

{errortools-1.2.0 → errortools-2.0.0}/README.md

@@ -3,7 +3,7 @@ A lightweight Python exception handling utility library.
 
 ## Features
 - **Raise Exceptions**: `raises()`, `raises_all()`, `reraise()` — batch raising and exception conversion
-- **Catch & Suppress**: `ignore()`, `ignore_subclass()`, `ignore_warns()`, `fast_ignore()`, `super_fast_ignore()`, `timeout()` — graceful suppression of exceptions and warnings
+- **Catch & Suppress**: `ignore()`, `ignore_subclass()`, `ignore_warns()`, `fast_ignore()`, `super_fast_ignore()`, `timeout()`, `retry()` — graceful suppression of exceptions and warnings, with automatic retry
 - **Exception Caching**: `error_cache` — cache exceptions raised by functions (similar to `lru_cache`)
 - **Custom Exceptions**: `PureBaseException`, `ContextException`, `BaseErrorCodes`, `BaseWarning` — structured exception classes with error codes, trace IDs, and context
 - **Attribute Error Mixin**: Customize error behavior for attribute access, assignment, and deletion
@@ -17,12 +17,12 @@ pip install errortools
 
 ---
 
-## Example
+## Examples
 
 ```python
 import warnings
 from errortools import (
-    ignore, fast_ignore, ignore_subclass, ignore_warns, timeout,
+    ignore, fast_ignore, ignore_subclass, ignore_warns, timeout, retry,
     reraise, raises, raises_all, assert_raises,
     error_cache,
     PureBaseException, ContextException, BaseErrorCodes, BaseWarning,
@@ -38,8 +38,22 @@ assert err.name == "KeyError" # exception class name
 assert err.count == 1         # how many times suppressed
 assert err.exception          # the original KeyError instance
 assert err.traceback          # full formatted traceback string
+```
+
+**Attributes on the returned object:**
+
+| Attribute | Type | Description |
+|---|---|---|
+| `be_ignore` | `bool` | `True` if an exception was suppressed |
+| `name` | `str \| None` | Class name of the suppressed exception |
+| `count` | `int` | Number of suppressed exceptions |
+| `exception` | `Exception \| None` | The original exception instance |
+| `traceback` | `str \| None` | Formatted traceback string for debugging |
+
+## Examples
 
-# ignore as a decorator
+```python
+# ── ignore as a decorator ──
 @ignore(ValueError, TypeError)
 def parse(x: str) -> int:
     return int(x)
@@ -71,14 +85,29 @@ async def fetch_data(url: str) -> bytes:
 
 # asyncio.TimeoutError raised automatically if it exceeds 5 s
 
-# ── 6. reraise ── convert exception types on the fly ─────────────────────────
+# ── 6. retry ── automatically retry on failure ───────────────────────────────
+@retry(times=3, on=ConnectionError, delay=1.0)
+def connect(host: str) -> None:
+    ...                               # retried up to 3 times on ConnectionError
+
+# works with async functions too
+@retry(times=5, on=TimeoutError, delay=0.5)
+async def fetch(url: str) -> bytes:
+    ...
+
+# multiple exception types
+@retry(times=2, on=(ValueError, KeyError))
+def parse(data: dict) -> str:
+    return data["key"]
+
+# ── 7. reraise ── convert exception types on the fly ─────────────────────────
 with reraise(KeyError, ValueError):
     raise KeyError("missing key")      # → ValueError: 'missing key'
 
 with reraise((KeyError, IndexError), RuntimeError):
     _ = [][99]                         # → RuntimeError: list index out of range
 
-# ── 7. raises / raises_all ── batch raise ────────────────────────────────────
+# ── 8. raises / raises_all ── batch raise ────────────────────────────────────
 raises([ValueError], ["bad input"])    # → ValueError: bad input
 
 raises_all(
@@ -86,11 +115,11 @@ raises_all(
     ["bad input"],
 )                                      # → ExceptionGroup (2 sub-exceptions)
 
-# ── 8. assert_raises ── assert a callable raises ─────────────────────────────
+# ── 9. assert_raises ── assert a callable raises ─────────────────────────────
 exc = assert_raises(int, [ValueError], "not-a-number")
 print(exc)   # invalid literal for int() with base 10: 'not-a-number'
 
-# ── 9. error_cache ── cache exceptions by call arguments ─────────────────────
+# ── 10. error_cache ── cache exceptions by call arguments ─────────────────────
 @error_cache(maxsize=64)
 def load(user_id: int) -> dict:
     if user_id < 0:
@@ -103,7 +132,7 @@ with ignore(ValueError):
 print(load.cache_info())  # CacheInfo(hits=0, misses=1, maxsize=64, currsize=1)
 load.clear_cache()
 
-# ── 10. Custom exceptions — three layers ──────────────────────────────────────
+# ── 11. Custom exceptions — three layers ──────────────────────────────────────
 
 # Layer 1: PureBaseException — code + detail only
 class AppError(PureBaseException):
@@ -139,7 +168,7 @@ raise BaseErrorCodes.runtime_failure("crash")             # RuntimeFailure     [
 raise BaseErrorCodes.timeout_failure()                    # TimeoutFailure     [4002]
 raise BaseErrorCodes.configuration_error("missing key")   # ConfigurationError [5001]
 
-# ── 11. BaseWarning ── structured warnings with factory methods ───────────────
+# ── 12. BaseWarning ── structured warnings with factory methods ───────────────
 class ExperimentalWarning(BaseWarning):
     default_detail = "This feature is experimental."
 

errortools-2.0.0/_errortools/_cli.py

@@ -0,0 +1,32 @@
+import sys
+
+from _errortools.metadata import (
+    __author__,
+    __author_email__,
+    __copyright__,
+    __description__,
+    __license__,
+    __url__,
+)
+from _errortools.version import __version__
+
+
+def _cmd_log(message: str, level: str, output: str) -> None:
+    """Emit a single log message via the errortools logger."""
+    from .logging import BaseLogger
+    from .logging.level import get_level
+
+    stream = sys.stdout if output == "stdout" else sys.stderr
+    log = BaseLogger(name="errortools-cli")
+    log.add(stream, level="TRACE", colorize=None)
+    log.log(get_level(level), message)
+
+
+def _print_info() -> None:
+    """Print a summary of all package metadata."""
+    print(f"errortools v{__version__}")
+    print(f"  {__description__}")
+    print(f"  Author:    {__author__} <{__author_email__}>")
+    print(f"  License:   {__license__}")
+    print(f"  URL:       {__url__}")
+    print(f"  Copyright: {__copyright__}")