mic-core 0.1.0

MIC — fondations agnostiques (contracts, model, http, auth, client, observability, healthcheck, resilience, cli, grpc).

mic-core

Fondations agnostiques du framework MIC (Model / Interface / Controller). mic-core est le socle : il ne dépend d'aucune brique de persistance ni de plateforme (voir le DAG platform → data → core dans ../README.md).

Modules

Module	Rôle
mic.contracts	Contrats / DTO partagés inter-couches
mic.model	Erreurs de domaine (DomainError, TransientError), value objects
mic.http	Spécifications HTTP agnostiques (HttpRouteSpec, HttpResponseSpec, HttpCookieSpec, HttpRequestContext)
mic.fastapi	Adaptateur FastAPI (router builder, middlewares) — extra [fastapi]
mic.litestar	Adaptateur Litestar — extra [litestar]
mic.auth	JWT service-to-service (signer/verifier) — extra [auth]
mic.client	Client HTTP inter-services (httpx) — extra [client]
mic.observability	Logs JSON, métriques Prometheus, traces OTel — extra [observability] / [full-observability]
mic.healthcheck	Sondes liveness/readiness
mic.resilience	Circuit breaker, retry, timeouts
mic.cli	Squelette CLI (argparse stdlib) — extra [cli]
mic.grpc	Transport gRPC — extra [grpc]

Le paquet est un namespace PEP 420 (pas de mic/__init__.py) : import mic.* reste identique côté consommateur, qu'on installe mic-core seul ou avec mic-datastore / mic-platform.

Installation

pip install "mic-core[fastapi,auth,client,observability]"

Extras

Extra	Tire
fastapi	fastapi + uvicorn[standard] + starlette
litestar	litestar
auth	pyjwt
client	httpx
observability	prometheus-client + opentelemetry-api
sentry	sentry-sdk (+ urllib3 patché)
tracing	opentelemetry-sdk + exporter OTLP
full-observability	observability + sentry + tracing
grpc	grpcio + grpcio-health-checking
cli	(rien — argparse stdlib)

Versionnage

mic-core démarre en 0.x (pré-releases dev/rc sur TestPyPI). Il graduera en 1.0 une fois les frontières prouvées et les services migrés (fin du split, cf. ADR-0001). En 0.x, un bump minor peut porter un changement cassant (SemVer 0.x) — contraindre avec >=0.1,<1.

Release

Voir ../../RELEASING.md § « Release par paquet » (make release-pkg PKG=core VERSION=x.y.z → tag core-vX.Y.Z).