Was ist jrpc-core?
jrpc-core ist eine leichtgewichtige Python-Bibliothek, die die JSON-RPC 2.0-Spezifikation mit zwei Kernschichten implementiert:
| Schicht | Modul | Zweck |
|---|---|---|
| Nachrichten | jrpc_core.messages | Pydantic-Modelle für Anfragen, Antworten, Benachrichtigungen und Fehler |
| Dispatcher | jrpc_core.dispatcher | Registerbasierte Weiterleitung eingehender Nachrichten an Handler-Aufrufe |
Designprinzipien
- Typsicher — jedes Modell ist ein Pydantic-
BaseModelmit expliziten Feldtypen und Validatoren. - Funktional — Fehlerbehandlung verwendet
ResultundOptionaus pyfplib statt Ausnahmen. - Leichtgewichtig — hängt nur von
pydanticundpyfplibab, kein Async-Laufzeitumfeld erforderlich. - Serialisierbar — sauberer Rückweg zwischen Python-Objekten und JSON-Strings.
Architektur
Eingehender JSON-String
│
▼
try_parse()
│
┌────┴────┐
│ │
Anfrage Benachrichtigung
│ │
▼ ▼
JsonRpcDispatcher.__call__()
│
├──► Handler-Register-Suche
│
▼
JsonRpcResponseNächste Schritte
- Erste Schritte — Installation und erste Anfrage
- Nachrichten-API — vollständige Referenz für alle Nachrichtenmodelle
- Dispatcher-API — vollständige Referenz für Routing und Handler-Registrierung