O que é jrpc-core?
jrpc-core é uma biblioteca Python leve que implementa a especificação JSON-RPC 2.0 com duas camadas principais:
| Camada | Módulo | Finalidade |
|---|---|---|
| Mensagens | jrpc_core.messages | Modelos Pydantic para requisições, respostas, notificações e erros |
| Dispatcher | jrpc_core.dispatcher | Roteamento baseado em registro de mensagens recebidas para chamadas de handler |
Princípios de Design
- Type-safe — cada modelo é um
BaseModeldo Pydantic com tipos de campo e validadores explícitos. - Funcional — tratamento de erros usa
ResulteOptiondo pyfplib em vez de exceções. - Leve — depende apenas de
pydanticepyfplib, não requer runtime async. - Serializável — ida e volta limpa entre objetos Python e strings JSON.
Arquitetura
String JSON recebida
│
▼
try_parse()
│
┌────┴────┐
│ │
Requisição Notificação
│ │
▼ ▼
JsonRpcDispatcher.__call__()
│
├──► busca no registro de handlers
│
▼
JsonRpcResponsePróximos Passos
- Primeiros Passos — instalação e primeira requisição
- API de Mensagens — referência completa para todos os modelos de mensagem
- API de Dispatcher — referência completa para roteamento e registro de handlers