This is a compact and simple JSON-RPC client implementation for asyncio python code. This code is forked from https://github.com/gciotta/jsonrpc-requests
- Python 3.4 & 3.5 compatible
- Supports nested namespaces (eg. app.users.getUsers())
- 100% test coverage
It is recommended to manage the aiohttp ClientSession object externally and pass it to the Server constructor. (See the aiohttp documentation.) If not passed to Server, a ClientSession object will be created automatically.
Execute remote JSON-RPC functions
import asyncio
from jsonrpc_async import Server
@asyncio.coroutine
def routine():
server = Server('http://localhost:8080')
try:
yield from server.foo(1, 2)
yield from server.foo(bar=1, baz=2)
yield from server.foo({'foo': 'bar'})
yield from server.foo.bar(baz=1, qux=2)
finally:
yield from server.session.close()
asyncio.get_event_loop().run_until_complete(routine())A notification
import asyncio
from jsonrpc_async import Server
@asyncio.coroutine
def routine():
server = Server('http://localhost:8080')
try:
yield from server.foo(bar=1, _notification=True)
finally:
yield from server.session.close()
asyncio.get_event_loop().run_until_complete(routine())Pass through arguments to aiohttp (see also aiohttp documentation)
import asyncio
import aiohttp
from jsonrpc_async import Server
@asyncio.coroutine
def routine():
server = Server(
'http://localhost:8080',
auth=aiohttp.BasicAuth('user', 'pass'),
headers={'x-test2': 'true'})
try:
yield from server.foo()
finally:
yield from server.session.close()
asyncio.get_event_loop().run_until_complete(routine())Pass through aiohttp exceptions
import asyncio
import aiohttp
from jsonrpc_async import Server
@asyncio.coroutine
def routine():
server = Server('http://unknown-host')
try:
yield from server.foo()
except TransportError as transport_error:
print(transport_error.args[1]) # this will hold a aiohttp exception instance
finally:
yield from server.session.close()
asyncio.get_event_loop().run_until_complete(routine())Install the Python tox package and run tox, it'll test this package with various versions of Python.
@gciotta for creating the base project jsonrpc-requests.
@mbroadst for providing full support for nested method calls, JSON-RPC RFC compliance and other improvements.
@vaab for providing api and tests improvements, better RFC compliance.