Files
khadhroony-solana-project/crates/ksp-logging-lib
2026-08-14 19:54:58 +02:00
..
2026-08-14 19:54:58 +02:00
2026-08-14 19:54:58 +02:00
2026-08-14 19:54:58 +02:00
2026-08-14 18:43:54 +02:00
2026-08-14 19:54:58 +02:00
2026-08-14 19:54:58 +02:00
2026-08-14 19:54:58 +02:00

ksp-logging-lib

ksp-logging-lib est la façade commune de logging/tracing runtime de Khadhroony Solana Project.

Responsabilités

La crate possède :

  • les cinq niveaux KSP error, warn, info, debug et trace ;
  • les macros d'événements et de spans qui préservent le callsite du consommateur ;
  • LoggingSettings et les settings console/fichier indépendants de Config ;
  • l'installation unique du subscriber global ;
  • le hot reload via reinitialize sans second subscriber global ;
  • le takeover des logs : les targets externes sont silencieux par défaut ;
  • les sorties console et fichier non bloquantes ;
  • les WorkerGuard, compteurs de lignes abandonnées, rotation fichier et stripping ANSI ;
  • l'instrumentation de scopes synchrones et de Future async.

Frontières

Une crate KSP comportementale qui journalise son activité dépend de ksp-logging-lib et n'utilise pas directement tracing, tracing-subscriber ou tracing-appender.

Les événements utiles issus d'une dépendance externe ne sont pas renommés : la crate KSP propriétaire de l'opération réémet explicitement l'information utile sous son propre target KSP.

ksp-logging-lib ne dépend pas de ksp-config-lib. Config pourra construire un LoggingSettings puis appeler initialize ou reinitialize.

Documentation

  • USAGE.md — utilisation concrète de la façade et du runtime ;
  • TODO.md — capacités explicitement différées ou points restant à fermer.