Simple JSON-RPC service without transport layer
Project description
JSONRPCBase
NOTE: This is a fork of level12/jsonrpcbase with changes maintained by KBase
Simple JSON-RPC service without transport layer
This library is intended as an auxiliary library for easy an implementation of JSON-RPC services with Unix/TCP socket like transport protocols that do not have complex special requirements. You need to utilize some suitable transport protocol with this library to actually provide a working JSON-RPC service.
Features
- Easy to use, small size, well tested.
- Supports JSON-RPC v2.0. Compatible with v1.x style calls with the exception of v1.0 class-hinting.
- Optional argument type validation that significantly eases development of jsonrpc method_data.
Example
Example usage:
import jsonrpcbase
chat_service = jsonrpcbase.JSONRPCService()
def login(username, password, timelimit=0):
# (...)
return True
def receive_message(**kwargs):
# (...)
return chat_message
def send_message(msg):
# (...)
pass
if __name__ == '__main__':
# Adds the method login to the service as a 'login'.
chat_service.add(login, types=[basestring, basestring, int])
# Adds the method receive_message to the service as a 'recv_msg'.
chat_service.add(receive_message, name='recv_msg', types={"msg": basestring, "id": int})
# Adds the method send_message as a 'send_msg' to the service.
chat_service.add(send_message, 'send_msg')
# Receive a JSON-RPC call.
jsonmsg = my_socket.recv()
# Process the JSON-RPC call.
result = chat_service.call(jsonmsg)
# Send back results.
my_socket.send(result)
Development
Install poetry and run poetry install
.
Run tests with make test
.
Deploy with poetry build
and poetry publish
.
Credits
This project was originally developed by Juhani Åhman.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for kbase_jsonrpcbase-0.3.0a5.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6723eccb8a7722a29e6ef99a13b33f33e9735438ee5e4a4d612d448c2820874d |
|
MD5 | bf3768bedbb134445ef619676dca2f93 |
|
BLAKE2b-256 | 0d8b4ad0e99b3104e28f147f49b2e1b507a8d9bbe8a27503f1516bd7f7edc401 |
Hashes for kbase_jsonrpcbase-0.3.0a5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1306bebf9af7f7911a5b5478eef60d40d7b9098d5467adaa06b17fe2780513e5 |
|
MD5 | 1b410b4cf280401838b1816162444e2b |
|
BLAKE2b-256 | fd08bdf9ac53ddeeadd7ebf9bd6633518b3553d2fba2414146b930174e4ce1bd |