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 :
| Couche | Module | Objectif |
|---|---|---|
| Messages | jrpc_core.messages | Modèles Pydantic pour les requêtes, réponses, notifications et erreurs |
| Dispatcher | jrpc_core.dispatcher | Routage basé sur un registre des messages entrants vers les handlers |
Principes de Conception
- Type-safe — chaque modèle est un
BaseModelde Pydantic avec des types de champs et validateurs explicites. - Fonctionnel — la gestion des erreurs utilise
ResultetOptionde pyfplib au lieu des exceptions. - Léger — ne dépend que de
pydanticetpyfplib, 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