Skip to content

¿Qué es jrpc-core?

jrpc-core es una biblioteca Python ligera que implementa la especificación JSON-RPC 2.0 con dos capas principales:

CapaMóduloPropósito
Mensajesjrpc_core.messagesModelos Pydantic para solicitudes, respuestas, notificaciones y errores
Dispatcherjrpc_core.dispatcherEnrutamiento basado en registro de mensajes entrantes a llamadas de handler

Principios de Diseño

  • Type-safe — cada modelo es un BaseModel de Pydantic con tipos de campo y validadores explícitos.
  • Funcional — el manejo de errores usa Result y Option de pyfplib en lugar de excepciones.
  • Ligero — solo depende de pydantic y pyfplib, no requiere runtime async.
  • Serializable — ida y vuelta limpia entre objetos Python y cadenas JSON.

Arquitectura

Cadena JSON entrante


   try_parse()

   ┌────┴────┐
   │         │
Solicitud  Notificación
   │         │
   ▼         ▼
JsonRpcDispatcher.__call__()

   ├──► búsqueda en el registro de handlers


JsonRpcResponse

Próximos Pasos