Skip to content

O que é jrpc-core?

jrpc-core é uma biblioteca Python leve que implementa a especificação JSON-RPC 2.0 com duas camadas principais:

CamadaMóduloFinalidade
Mensagensjrpc_core.messagesModelos Pydantic para requisições, respostas, notificações e erros
Dispatcherjrpc_core.dispatcherRoteamento baseado em registro de mensagens recebidas para chamadas de handler

Princípios de Design

  • Type-safe — cada modelo é um BaseModel do Pydantic com tipos de campo e validadores explícitos.
  • Funcional — tratamento de erros usa Result e Option do pyfplib em vez de exceções.
  • Leve — depende apenas de pydantic e pyfplib, 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


JsonRpcResponse

Próximos Passos