jrpc-core

A lightweight, type-safe Python implementation of the JSON-RPC 2.0 specification.

jrpc-core provides two core layers:

Table of Contents

• jrpc-core
  • Table of Contents
  • Features
  • Quick Start
  • Documentation
  • Installation
  • License

Features

• Type-safe — every model is a Pydantic BaseModel with explicit field types and validators.
• Functional — error handling uses Result and Option from pyfplib instead of exceptions.
• Lightweight — only depends on pydantic and pyfplib, no async runtime required.
• Serialisable — round-trips cleanly between Python objects and JSON strings.
• Extensible — custom response constructors, parameter validators, and converters.

Quick Start

import asyncio
from jrpc_core import JsonRpcRequest, JsonRpcDispatcher, JsonRpcMethodWrapper

# Create a request
request = JsonRpcRequest(method="add", params=[1, 2])
print(request.to_json())
# {"jsonrpc":"2.0","method":"add","params":[1,2],"id":"<uuid>"}

# Parse incoming JSON-RPC message
from jrpc_core import try_parse
result = try_parse('{"jsonrpc":"2.0","method":"add","params":[1,2],"id":"1"}')

# Use the dispatcher
async def main():
    dispatcher = JsonRpcDispatcher()
    dispatcher.request_handler_registry.add(
        JsonRpcMethodWrapper(name="add", method=lambda args: args[0] + args[1])
    )
    response = await dispatcher(JsonRpcRequest(method="add", params=[1, 2], id=1))
    print(response.unwrap().unwrap().result)  # 3

asyncio.run(main())

Documentation

Documentation pages.

Installation

pip install jrpc-core

License

jrpc-core is distributed under the terms of the MIT license.