Skip to content

Qu'est-ce que jrpc-core ?

jrpc-core est une bibliothèque Python légère qui implémente la spécification JSON-RPC 2.0 avec deux couches principales :

CoucheModuleObjectif
Messagesjrpc_core.messagesModèles Pydantic pour les requêtes, réponses, notifications et erreurs
Dispatcherjrpc_core.dispatcherRoutage basé sur un registre des messages entrants vers les handlers

Principes de Conception

  • Type-safe — chaque modèle est un BaseModel de Pydantic avec des types de champs et validateurs explicites.
  • Fonctionnel — la gestion des erreurs utilise Result et Option de pyfplib au lieu des exceptions.
  • Léger — ne dépend que de pydantic et pyfplib, pas de runtime async requis.
  • Sérialisable — aller-retour propre entre les objets Python et les chaînes JSON.

Architecture

Chaîne JSON entrante


   try_parse()

   ┌────┴────┐
   │         │
Requête  Notification
   │         │
   ▼         ▼
JsonRpcDispatcher.__call__()

   ├──► recherche dans le registre des handlers


JsonRpcResponse

Étapes Suivantes

  • Pour Commencer — installation et première requête
  • API Messages — référence complète pour tous les modèles de messages
  • API Dispatcher — référence complète pour le routage et l'enregistrement des handlers