DataExcept 1.2.0__tar.gz → 1.3.0__tar.gz

{dataexcept-1.2.0 → dataexcept-1.3.0}/CHANGELOG.md

@@ -7,6 +7,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.3.0] - 2026-09-03
+
+### Added
+
+- **Structured `ExceptionGroup` support** on Python 3.11+:
+  `exception_to_dict` and `exception_to_json` now preserve group members under
+  an `exceptions` field, including nested groups, instead of flattening
+  concurrent failures into one rendered message.
+- Group members use the same public-attribute, redaction, cycle and shared
+  `max_depth` guarantees as ordinary causes and contexts. Python 3.10 remains
+  supported without an `exceptiongroup` backport or additional runtime
+  dependency.
+
+### Changed
+
+- Hostile or malformed exception-group member metadata now degrades to the
+  ordinary exception record rather than allowing serialization itself to fail.
+- The README now uses a PyPI-backed version badge and avoids hard-coded version
+  and citation values that can drift between releases. The documented exception
+  count is contract-tested against the package.
+- The roadmap now records a future language-neutral envelope schema and optional
+  Pino interoperability track without claiming Node.js/Pino support today.
+
 ## [1.2.0] - 2026-09-02
 
 ### Added
@@ -547,7 +570,8 @@ First public release.
 - Published to PyPI via OIDC trusted publishing; no long-lived API token is
   involved in a release.
 
-[Unreleased]: https://github.com/DiogoRibeiro7/DataExcept/compare/v1.2.0...HEAD
+[Unreleased]: https://github.com/DiogoRibeiro7/DataExcept/compare/v1.3.0...HEAD
+[1.3.0]: https://github.com/DiogoRibeiro7/DataExcept/compare/v1.2.0...v1.3.0
 [1.2.0]: https://github.com/DiogoRibeiro7/DataExcept/compare/v1.1.0...v1.2.0
 [1.1.0]: https://github.com/DiogoRibeiro7/DataExcept/compare/v1.0.0...v1.1.0
 [1.0.0]: https://github.com/DiogoRibeiro7/DataExcept/compare/v0.4.3...v1.0.0

{dataexcept-1.2.0 → dataexcept-1.3.0}/CITATION.cff

@@ -1,7 +1,7 @@
 cff-version: 1.2.0
 message: "If you use this software, please cite it using the following metadata."
 title: "DataExcept"
-version: "1.2.0"
+version: "1.3.0"
 authors:
   - family-names: "Ribeiro"
     given-names: "Diogo"
@@ -11,4 +11,4 @@ authors:
 type: software
 url: "https://github.com/DiogoRibeiro7/DataExcept"
 repository-code: "https://github.com/DiogoRibeiro7/DataExcept"
-date-released: "2026-09-02"
+date-released: "2026-09-03"

{dataexcept-1.2.0 → dataexcept-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DataExcept
-Version: 1.2.0
+Version: 1.3.0
 Summary: A Python package providing structured, easily-extendable custom exception types.
 License-Expression: MIT
 License-File: LICENSE
@@ -27,7 +27,7 @@ Description-Content-Type: text/markdown
 
 # DataExcept
 
-[![CI](https://github.com/DiogoRibeiro7/DataExcept/actions/workflows/ci.yml/badge.svg)](https://github.com/DiogoRibeiro7/DataExcept/actions/workflows/ci.yml) [![PyPI version](https://badge.fury.io/py/DataExcept.svg)](https://badge.fury.io/py/DataExcept) [![Python Support](https://img.shields.io/pypi/pyversions/DataExcept.svg)](https://pypi.org/project/DataExcept/) [![Coverage](https://diogoribeiro7.github.io/DataExcept/coverage.svg)](https://diogoribeiro7.github.io/DataExcept/htmlcov/) [![Documentation](https://img.shields.io/badge/docs-GitHub%20Pages-blue)](https://diogoribeiro7.github.io/DataExcept/) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) [![Checked with mypy](https://www.mypy-lang.org/static/mypy_badge.svg)](https://mypy-lang.org/)
+[![CI](https://github.com/DiogoRibeiro7/DataExcept/actions/workflows/ci.yml/badge.svg)](https://github.com/DiogoRibeiro7/DataExcept/actions/workflows/ci.yml) [![PyPI version](https://img.shields.io/pypi/v/DataExcept.svg)](https://pypi.org/project/DataExcept/) [![Python Support](https://img.shields.io/pypi/pyversions/DataExcept.svg)](https://pypi.org/project/DataExcept/) [![Coverage](https://diogoribeiro7.github.io/DataExcept/coverage.svg)](https://diogoribeiro7.github.io/DataExcept/htmlcov/) [![Documentation](https://img.shields.io/badge/docs-GitHub%20Pages-blue)](https://diogoribeiro7.github.io/DataExcept/) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) [![Checked with mypy](https://www.mypy-lang.org/static/mypy_badge.svg)](https://mypy-lang.org/)
 
 **DataExcept** is a production-ready Python library that provides **structured, hierarchical exception classes** specifically designed for **data science**, **machine learning**, and **data engineering** workflows. Stop debugging generic `ValueError`s and `RuntimeError`s -- get meaningful, actionable error messages that help you understand exactly what went wrong in your data pipeline.
 
@@ -223,9 +223,9 @@ BatchProcessingError
 BiasDetectionError
 ...
 
-# Check version
+# Check the installed version
 $ dataexcept --version
-dataexcept 1.0.0
+dataexcept <installed version>
 ```
 
 ## 🎯 Use Cases
@@ -369,18 +369,8 @@ through [SECURITY.md](SECURITY.md), not the public issue tracker.
 
 ## 🎓 Citation
 
-If you use DataExcept in your research, please cite it:
-
-```bibtex
-@software{ribeiro_dataexcept_2026,
-  author = {Ribeiro, Diogo},
-  title = {DataExcept: Structured Exception Handling for Data Science},
-  url = {https://github.com/DiogoRibeiro7/DataExcept},
-  version = {1.0.0},
-  year = {2026},
-  publisher = {GitHub}
-}
-```
+If you use DataExcept in your research, please cite the exact release you used.
+The canonical release metadata is maintained in [CITATION.cff](CITATION.cff).
 
 ## 📄 License
 

{dataexcept-1.2.0 → dataexcept-1.3.0}/README.md

@@ -1,6 +1,6 @@
 # DataExcept
 
-[![CI](https://github.com/DiogoRibeiro7/DataExcept/actions/workflows/ci.yml/badge.svg)](https://github.com/DiogoRibeiro7/DataExcept/actions/workflows/ci.yml) [![PyPI version](https://badge.fury.io/py/DataExcept.svg)](https://badge.fury.io/py/DataExcept) [![Python Support](https://img.shields.io/pypi/pyversions/DataExcept.svg)](https://pypi.org/project/DataExcept/) [![Coverage](https://diogoribeiro7.github.io/DataExcept/coverage.svg)](https://diogoribeiro7.github.io/DataExcept/htmlcov/) [![Documentation](https://img.shields.io/badge/docs-GitHub%20Pages-blue)](https://diogoribeiro7.github.io/DataExcept/) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) [![Checked with mypy](https://www.mypy-lang.org/static/mypy_badge.svg)](https://mypy-lang.org/)
+[![CI](https://github.com/DiogoRibeiro7/DataExcept/actions/workflows/ci.yml/badge.svg)](https://github.com/DiogoRibeiro7/DataExcept/actions/workflows/ci.yml) [![PyPI version](https://img.shields.io/pypi/v/DataExcept.svg)](https://pypi.org/project/DataExcept/) [![Python Support](https://img.shields.io/pypi/pyversions/DataExcept.svg)](https://pypi.org/project/DataExcept/) [![Coverage](https://diogoribeiro7.github.io/DataExcept/coverage.svg)](https://diogoribeiro7.github.io/DataExcept/htmlcov/) [![Documentation](https://img.shields.io/badge/docs-GitHub%20Pages-blue)](https://diogoribeiro7.github.io/DataExcept/) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) [![Checked with mypy](https://www.mypy-lang.org/static/mypy_badge.svg)](https://mypy-lang.org/)
 
 **DataExcept** is a production-ready Python library that provides **structured, hierarchical exception classes** specifically designed for **data science**, **machine learning**, and **data engineering** workflows. Stop debugging generic `ValueError`s and `RuntimeError`s -- get meaningful, actionable error messages that help you understand exactly what went wrong in your data pipeline.
 
@@ -196,9 +196,9 @@ BatchProcessingError
 BiasDetectionError
 ...
 
-# Check version
+# Check the installed version
 $ dataexcept --version
-dataexcept 1.0.0
+dataexcept <installed version>
 ```
 
 ## 🎯 Use Cases
@@ -342,18 +342,8 @@ through [SECURITY.md](SECURITY.md), not the public issue tracker.
 
 ## 🎓 Citation
 
-If you use DataExcept in your research, please cite it:
-
-```bibtex
-@software{ribeiro_dataexcept_2026,
-  author = {Ribeiro, Diogo},
-  title = {DataExcept: Structured Exception Handling for Data Science},
-  url = {https://github.com/DiogoRibeiro7/DataExcept},
-  version = {1.0.0},
-  year = {2026},
-  publisher = {GitHub}
-}
-```
+If you use DataExcept in your research, please cite the exact release you used.
+The canonical release metadata is maintained in [CITATION.cff](CITATION.cff).
 
 ## 📄 License
 

{dataexcept-1.2.0 → dataexcept-1.3.0}/dataexcept/serialization.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import builtins
 import json
 import math
 from collections.abc import Mapping, Sequence, Set
@@ -13,6 +14,7 @@ __all__ = ["exception_to_dict", "exception_to_json"]
 
 _MAX_VALUE_DEPTH = 8
 _NOT_SCALAR = object()
+_EXCEPTION_GROUP_TYPE = getattr(builtins, "BaseExceptionGroup", None)
 
 
 def _redact_export_text(text: str) -> str:
@@ -112,12 +114,24 @@ def _attributes(exc: BaseException) -> dict[str, Any]:
             result[name] = _json_safe(value)
         return result
     except Exception:
-        # This code runs at an error-transport boundary. A hostile __dict__,
-        # custom mapping, iterator or key must not replace the original failure
-        # with a serialization failure.
         return {}
 
 
+def _group_members(exc: BaseException) -> Sequence[BaseException] | None:
+    """Return exception-group members without importing a 3.11-only symbol."""
+    if _EXCEPTION_GROUP_TYPE is None or not isinstance(exc, _EXCEPTION_GROUP_TYPE):
+        return None
+    try:
+        members: object = getattr(exc, "exceptions", None)
+        if not isinstance(members, tuple):
+            return None
+        if not all(isinstance(member, BaseException) for member in members):
+            return None
+        return members
+    except Exception:
+        return None
+
+
 def _exception_record(
     exc: BaseException,
     *,
@@ -149,6 +163,19 @@ def _exception_record(
         if attributes:
             record["attributes"] = attributes
 
+    members = _group_members(exc)
+    if members is not None:
+        record["exceptions"] = [
+            _exception_record(
+                member,
+                include_attributes=include_attributes,
+                max_depth=max_depth,
+                depth=depth + 1,
+                seen=seen,
+            )
+            for member in members
+        ]
+
     if exc.__cause__ is not None:
         record["cause"] = _exception_record(
             exc.__cause__,
@@ -179,8 +206,9 @@ def exception_to_dict(
     """Return a strict JSON-safe structured representation of *exc*.
 
     The representation contains the exception type, module and rendered
-    message, optionally public instance attributes, and bounded cause/context
-    chains. Traceback frames and private attributes are deliberately excluded.
+    message, optionally public instance attributes, bounded cause/context
+    chains, and on Python 3.11+ the member tree of exception groups. Traceback
+    frames and private attributes are deliberately excluded.
     """
     if not isinstance(exc, BaseException):
         raise TypeError("exc must be an exception instance")

{dataexcept-1.2.0 → dataexcept-1.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "DataExcept"
-version = "1.2.0"
+version = "1.3.0"
 description = "A Python package providing structured, easily-extendable custom exception types."
 readme = "README.md"
 license = "MIT"