DataExcept 0.4.2__tar.gz → 0.4.3__tar.gz

{dataexcept-0.4.2 → dataexcept-0.4.3}/CHANGELOG.md

@@ -7,6 +7,51 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Fixed
+
+- The release workflow's `verify-wheel` job installed a hand-written list of
+  test requirements, which went stale the moment `hypothesis` was added — the
+  suite could not even be collected against the built wheel. It now installs
+  the dev group from the lock, so the list cannot drift again. The job did its
+  job: it failed, and publishing was skipped.
+- `test_no_module_imports_tomllib_without_a_fallback` walked the whole tree, so
+  it picked up any virtualenv sitting in it. It now scans the project's own
+  source directories by name; site-packages is not ours to police.
+
+## [0.4.3] - 2026-08-25
+
+### Added
+
+- Property-based tests over the logging helpers and the CLI: generated context
+  values, including hostile ones, must never make `log_exception` raise; the
+  normalised context must be strict-JSON encodable; `log_and_raise` must
+  re-raise the *same* exception with its traceback intact; and the CLI must
+  raise nothing but `SystemExit` for any argument list.
+- **Property-based tests over the exception hierarchy**, using Hypothesis.
+  Generated text is fed to every class and four properties are asserted for
+  each: construction raises nothing but `TypeError`, a message built from real
+  input is non-empty, the exception survives a pickle round trip with its type,
+  message and cause intact, and a credential-bearing URL is never rendered.
+  Every constructor defect the reviews found — `MergeKeyError("id")` becoming
+  `['i', 'd']`, `is_number(True)`, and the one below — was in argument
+  handling and was found by inspection rather than by a test.
+
+### Fixed
+
+- **`log_exception` could raise, replacing the caller's error with its own.**
+  A context value whose `__repr__` raises propagated straight out of the
+  logging helper — so a helper called while handling a failure made the failure
+  worse. Nothing in context normalisation can raise now; a value that cannot be
+  described at all becomes `<unrepresentable TypeName>`.
+- **`NaN` and `Infinity` in a log context produced invalid JSON.**
+  `json.dumps` emits them bare, which a strict consumer downstream rejects.
+  They are stringified instead.
+- `ApiError`, `DatabaseConnectionError` and `WebhookError` raised
+  `AttributeError: 'object' object has no attribute 'decode'` when given a
+  non-string, because the redaction helpers passed whatever they were given to
+  `urlsplit`. That masked the caller's actual mistake with a message about
+  `.decode`. The helpers now return a non-string untouched.
+
 ## [0.4.2] - 2026-08-25
 
 ### Changed
@@ -429,7 +474,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/v0.4.2...HEAD
+[Unreleased]: https://github.com/DiogoRibeiro7/DataExcept/compare/v0.4.3...HEAD
+[0.4.3]: https://github.com/DiogoRibeiro7/DataExcept/compare/v0.4.2...v0.4.3
 [0.4.2]: https://github.com/DiogoRibeiro7/DataExcept/compare/v0.4.1...v0.4.2
 [0.4.1]: https://github.com/DiogoRibeiro7/DataExcept/compare/v0.4.0...v0.4.1
 [0.4.0]: https://github.com/DiogoRibeiro7/DataExcept/compare/v0.3.0...v0.4.0

{dataexcept-0.4.2 → dataexcept-0.4.3}/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: "0.4.2"
+version: "0.4.3"
 authors:
   - family-names: "Ribeiro"
     given-names: "Diogo"

{dataexcept-0.4.2 → dataexcept-0.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DataExcept
-Version: 0.4.2
+Version: 0.4.3
 Summary: A Python package providing structured, easily-extendable custom exception types.
 License-Expression: MIT
 License-File: LICENSE
@@ -225,7 +225,7 @@ BiasDetectionError
 
 # Check version
 $ dataexcept --version
-dataexcept 0.4.2
+dataexcept 0.4.3
 ```
 
 ## 🎯 Use Cases
@@ -375,7 +375,7 @@ If you use DataExcept in your research, please cite it:
   author = {Ribeiro, Diogo},
   title = {DataExcept: Structured Exception Handling for Data Science},
   url = {https://github.com/DiogoRibeiro7/DataExcept},
-  version = {0.4.2},
+  version = {0.4.3},
   year = {2026},
   publisher = {GitHub}
 }

{dataexcept-0.4.2 → dataexcept-0.4.3}/README.md

@@ -198,7 +198,7 @@ BiasDetectionError
 
 # Check version
 $ dataexcept --version
-dataexcept 0.4.2
+dataexcept 0.4.3
 ```
 
 ## 🎯 Use Cases
@@ -348,7 +348,7 @@ If you use DataExcept in your research, please cite it:
   author = {Ribeiro, Diogo},
   title = {DataExcept: Structured Exception Handling for Data Science},
   url = {https://github.com/DiogoRibeiro7/DataExcept},
-  version = {0.4.2},
+  version = {0.4.3},
   year = {2026},
   publisher = {GitHub}
 }

{dataexcept-0.4.2 → dataexcept-0.4.3}/dataexcept/logging_helpers.py

@@ -12,6 +12,9 @@ from .redaction import redact_urls_in_text
 
 Context = Mapping[str, Any]
 
+#: Sentinel: the value could not be coerced into anything JSON will take.
+_UNCOERCIBLE = object()
+
 __all__ = [
     "Context",
     "log_and_raise",
@@ -20,15 +23,61 @@ __all__ = [
 ]
 
 
-def _normalize_context_value(value: Any) -> Any:
+def _is_json_safe(value: Any) -> bool:
+    """True if a strict JSON encoder will accept *value* as it stands.
+
+    ``allow_nan=False`` because ``json.dumps`` otherwise emits bare ``NaN`` and
+    ``Infinity``, which are not valid JSON and will be rejected downstream.
+    """
     try:
-        json.dumps(value)
-        return value
-    except TypeError:
+        json.dumps(value, allow_nan=False)
+    except (TypeError, ValueError):
+        return False
+    return True
+
+
+def _coerced(value: Any) -> Any:
+    """Round-trip *value* through JSON, stringifying whatever will not encode.
+
+    Returns ``_UNCOERCIBLE`` rather than raising: this runs while the caller is
+    already handling a failure.
+    """
+    try:
+        return json.loads(json.dumps(value, default=str, allow_nan=False))
+    except Exception:
+        return _UNCOERCIBLE
+
+
+def _described(value: Any) -> str:
+    """Describe *value* without letting it raise.
+
+    An object may define a ``__repr__`` that raises. Naming the type is the
+    most that can be said without invoking anything the object controls.
+    """
+    try:
+        return repr(value)
+    except Exception:
         try:
-            return json.loads(json.dumps(value, default=str))
-        except Exception:  # pragma: no cover - extremely defensive
-            return repr(value)
+            return f"<unrepresentable {type(value).__name__}>"
+        except Exception:  # pragma: no cover - a type with a hostile __name__
+            return "<unrepresentable>"
+
+
+def _normalize_context_value(value: Any) -> Any:
+    """Return *value* in a form a strict JSON log encoder will accept.
+
+    Nothing here may raise. This runs while the caller is already handling a
+    failure, and an exception escaping would replace their error with one about
+    logging it -- so even a hostile ``__repr__`` has to be survivable.
+    """
+    if _is_json_safe(value):
+        return value
+
+    coerced = _coerced(value)
+    if coerced is not _UNCOERCIBLE:
+        return coerced
+
+    return _described(value)
 
 
 def _build_extra(context: Context | None) -> dict[str, Any] | None:

{dataexcept-0.4.2 → dataexcept-0.4.3}/dataexcept/redaction.py

@@ -170,7 +170,10 @@ def redact_url(url: Optional[str], *, keep_path: bool = True) -> Optional[str]:
     incoming webhook URL is the common case -- Slack, Discord and others put
     the secret in the path, so preserving it would defeat the point.
     """
-    if not url:
+    if not url or not isinstance(url, str):
+        # Anything that is not a string is handed back untouched. urlsplit
+        # would raise AttributeError from inside urllib, masking whatever the
+        # caller's real mistake was with a message about `.decode`.
         return url
 
     try:

{dataexcept-0.4.2 → dataexcept-0.4.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "DataExcept"
-version = "0.4.2"
+version = "0.4.3"
 description = "A Python package providing structured, easily-extendable custom exception types."
 readme = "README.md"
 license = "MIT"
@@ -43,6 +43,7 @@ include = [
 black = "*"
 coverage = "*"
 flake8 = "*"
+hypothesis = "*"
 isort = "*"
 mypy = "*"
 pre-commit = "*"