mic-struct 0.0.1__tar.gz → 0.0.2__tar.gz

{mic_struct-0.0.1 → mic_struct-0.0.2}/CHANGELOG.md

@@ -5,7 +5,24 @@ All notable changes to **mic-struct** are documented in this file.
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [0.0.1] — 2026-05-22
+## [Unreleased]
+
+## [0.0.2] — 2026-05-22
+
+### Fixed — `mic.healthcheck` : préservation du nom du probe sur exception (RDL-627)
+
+`make_db_probe` et `make_callable_probe` capturent désormais l'exception
+**à l'intérieur** du probe et retournent un `ProbeResult` unhealthy en
+**préservant le `name`** canonique (+ `latency_ms`), au lieu de laisser
+l'erreur remonter à `ReadinessChecker._run_probe_safely`, qui retombait sur
+`getattr(probe, "__name__", "unknown_probe")` = `"_probe"` (nom perdu).
+`make_cache_probe` avait déjà ce comportement — les trois factories sont
+maintenant cohérentes.
+
+Permet aux consumers (ex. rdlink-api `providers/readiness.py`, qui écrivait
+ses probes `database`/`schema` à la main *uniquement* pour garder le nom)
+d'utiliser directement les factories mic comme socle. Rétro-compatible : un
+probe sain est inchangé ; seul le chemin d'exception gagne le nom correct.
 
 First public release of `mic-struct` — the building blocks below have
 been consolidated, hardened, and locked behind a 100 % line + branch

{mic_struct-0.0.1 → mic_struct-0.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mic-struct
-Version: 0.0.1
+Version: 0.0.2
 Summary: Model/Interface/Controller boilerplate for Python services — FastAPI/Litestar parity, JWT service auth, SQLModel storage, Prometheus + JSON logs, cookiecutter scaffold
 Project-URL: Homepage, https://gitlab.com/mic-struct/mic-struct
 Project-URL: Documentation, https://gitlab.com/mic-struct/mic-struct/-/blob/master/README.md

{mic_struct-0.0.1 → mic_struct-0.0.2}/pyproject.toml

@@ -7,7 +7,7 @@ name = "mic-struct"
 # First public release. Pre-1.0 (0.x) : per semver, minor bumps may carry
 # breaking changes. Consumers constrain with ">=0.0.1,<1.0.0" (the existing
 # ">=0.0.1.dev0,<1.0.0" pins also accept this release).
-version = "0.0.1"
+version = "0.0.2"
 description = "Model/Interface/Controller boilerplate for Python services — FastAPI/Litestar parity, JWT service auth, SQLModel storage, Prometheus + JSON logs, cookiecutter scaffold"
 readme = "README.md"
 requires-python = ">=3.14"

{mic_struct-0.0.1 → mic_struct-0.0.2}/src/mic/__init__.py

@@ -5,5 +5,5 @@ Cf. README.md et CONTRIBUTING.md.
 
 from __future__ import annotations
 
-__version__ = "0.0.1"
+__version__ = "0.0.2"
 __all__ = ["__version__"]

{mic_struct-0.0.1 → mic_struct-0.0.2}/src/mic/healthcheck/readiness.py

@@ -147,11 +147,27 @@ def make_db_probe(
     Accepte n'importe quel :class:`mic.datastorage.DataStorage` (``SqlDataStorage``,
     ``DocumentDataStorage``, ``GraphDataStorage``, ...) — tous ont la méthode
     ``check_health`` par contrat ABC.
+
+    Si ``check_health()`` **lève** (engine raise-based plutôt que bool), le
+    probe capture l'exception et retourne un ``ProbeResult`` unhealthy en
+    **préservant le ``name``** (sans laisser l'erreur remonter à
+    :func:`_run_probe_safely`, qui perdrait le nom canonique). Un consumer
+    n'a donc plus besoin d'écrire un probe try/except à la main juste pour
+    garder le nom.
     """
 
     def _probe() -> ProbeResult:
         t0 = time_fn()
-        ok = storage.check_health()
+        try:
+            ok = storage.check_health()
+        except Exception as exc:
+            elapsed_ms = (time_fn() - t0) * 1000.0
+            return ProbeResult(
+                name=name,
+                healthy=False,
+                message=f"{type(exc).__name__}: {exc}",
+                latency_ms=round(elapsed_ms, 2),
+            )
         elapsed_ms = (time_fn() - t0) * 1000.0
         return ProbeResult(
             name=name,
@@ -210,13 +226,26 @@ def make_callable_probe(
     """Construit un probe à partir d'un callable bool. Pour les cas
     custom (upstream HTTP, message broker, ...).
 
-    ``fn`` retourne ``True`` si OK, ``False`` sinon. Si ``fn`` lève,
-    le probe capture en ``healthy=False`` avec le message.
+    ``fn`` retourne ``True`` si OK, ``False`` sinon. Si ``fn`` **lève**, le
+    probe capture l'exception et retourne ``healthy=False`` en **préservant
+    le ``name``** (l'erreur ne remonte pas à :func:`_run_probe_safely`, qui
+    retomberait sur ``"_probe"``). Le nom canonique est donc garanti dans le
+    ``ProbeResult``, succès comme échec — plus besoin d'un probe maison juste
+    pour ça.
     """
 
     def _probe() -> ProbeResult:
         t0 = time_fn()
-        ok = fn()
+        try:
+            ok = fn()
+        except Exception as exc:
+            elapsed_ms = (time_fn() - t0) * 1000.0
+            return ProbeResult(
+                name=name,
+                healthy=False,
+                message=f"{type(exc).__name__}: {exc}",
+                latency_ms=round(elapsed_ms, 2),
+            )
         elapsed_ms = (time_fn() - t0) * 1000.0
         return ProbeResult(
             name=name,