errortools 2.3.0__tar.gz → 2.5.0__tar.gz

{errortools-2.3.0 → errortools-2.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: errortools
-Version: 2.3.0
+Version: 2.5.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
@@ -13,6 +13,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Operating System :: OS Independent
 Classifier: Typing :: Typed
 Requires-Python: >=3.10
@@ -36,9 +37,18 @@ Dynamic: summary
 # errortools
 A lightweight Python exception handling utility library.
 
+[![Code Style: Google](https://img.shields.io/badge/style-google-3666d6.svg)](https://google.github.io/styleguide/pyguide.html#s3.8-comments-and-docstrings)
+[![PyPI Version](https://img.shields.io/pypi/v/errortools)](https://pypi.org/project/errortools/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/errortools)](https://pypi.org/project/errortools/)
+![This week commits](https://img.shields.io/github/commit-activity/w/more-abc/errortools)
+![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)
+
 ## 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()`, `retry()` — graceful suppression of exceptions and warnings, with automatic retry
+- **Future Utilities**: `super_fast_catch()`, `super_fast_reraise()`, `ExceptionCollector` — lightweight exception handling for high-performance scenarios
 - **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
@@ -62,7 +72,7 @@ from errortools import (
     error_cache,
     PureBaseException, ContextException, BaseErrorCodes, BaseWarning,
 )
-from errortools.future import super_fast_ignore
+from errortools.future import super_fast_ignore, super_fast_catch, super_fast_reraise, ExceptionCollector
 
 # ── 1. ignore ── context manager with full metadata ──────────────────────────
 with ignore(KeyError) as err:
@@ -154,7 +164,27 @@ raises_all(
 exc = assert_raises(int, [ValueError], "not-a-number")
 print(exc)   # invalid literal for int() with base 10: 'not-a-number'
 
-# ── 10. error_cache ── cache exceptions by call arguments ─────────────────────
+# ── 10. super_fast_catch ── lightweight exception capture ──────────────────────
+with super_fast_catch(ValueError) as ctx:
+    raise ValueError("oops")
+    
+assert ctx.exception is not None
+print(ctx.exception)  # ValueError('oops')
+
+# ── 11. super_fast_reraise ── lightweight exception type conversion ────────────
+with super_fast_reraise(KeyError, ValueError):
+    raise KeyError("missing")           # → ValueError: 'missing'
+
+# ── 12. ExceptionCollector ── batch collect exceptions ───────────────────────────
+collector = ExceptionCollector()
+collector.catch(int, "bad1")
+collector.catch(int, "bad2")
+
+if collector.has_errors:
+    print(f"Collected {collector.count} errors")
+    collector.raise_all("batch operation failed")  # → ExceptionGroup (2 sub-exceptions)
+
+# ── 13. error_cache ── cache exceptions by call arguments ─────────────────────
 @error_cache(maxsize=64)
 def load(user_id: int) -> dict:
     if user_id < 0:
@@ -167,7 +197,7 @@ with ignore(ValueError):
 print(load.cache_info())  # CacheInfo(hits=0, misses=1, maxsize=64, currsize=1)
 load.clear_cache()
 
-# ── 11. Custom exceptions — three layers ──────────────────────────────────────
+# ── 14. Custom exceptions — three layers ──────────────────────────────────────
 
 # Layer 1: PureBaseException — code + detail only
 class AppError(PureBaseException):
@@ -203,7 +233,7 @@ raise BaseErrorCodes.runtime_failure("crash")             # RuntimeFailure     [
 raise BaseErrorCodes.timeout_failure()                    # TimeoutFailure     [4002]
 raise BaseErrorCodes.configuration_error("missing key")   # ConfigurationError [5001]
 
-# ── 12. BaseWarning ── structured warnings with factory methods ───────────────
+# ── 15. BaseWarning ── structured warnings with factory methods ───────────────
 class ExperimentalWarning(BaseWarning):
     default_detail = "This feature is experimental."
 
@@ -234,9 +264,9 @@ logger.success("All systems operational")
 Output (colourised in a terminal):
 
 ```
-2026-01-01 12:00:00.123 | INFO     | app:main:42 - Server started on port 8080
-2026-01-01 12:00:00.124 | WARNING  | app:main:43 - Disk at 92.5%
-2026-01-01 12:00:00.125 | SUCCESS  | app:main:44 - All systems operational
+2026-04-30 08:34:21.850 | ℹ INFO     | <string>:<module>:3 - Server started on port 8080
+2026-04-30 08:34:21.851 | ⚠ WARNING  | <string>:<module>:4 - Disk at 92.5%
+2026-04-30 08:34:21.851 | ✔ SUCCESS  | <string>:<module>:5 - All systems operational
 ```
 
 ### Log levels