Asyncio version of the standard lib xmlrpc
aioxmlrpc.client, which works like xmlrpc.client but uses coroutines,
has been implemented.
aioxmlrpc.client is based on httpx for the transport, and just patch
the necessary from the python standard library to get it working.
aioxmlrpc.server, which works much like xmlrpc.server, but runs on the asyncio
event loop and handles remote procedure calls (RPC) using both regular functions and coroutines.
aioxmlrpc.server is based on starlette and uvicorn for handling HTTP.
aioxmlrpc is available on PyPI, it can simply be installed with your favorite tool, example with pip here.
pip install aioxmlrpc
The server dependencies is installed using the extra syntax.
pip install "aioxmlrpc[server]"
This example show how to print the current version of the Gandi XML-RPC api.
import asyncio
from aioxmlrpc.client import ServerProxy
async def print_gandi_api_version():
api = ServerProxy('https://rpc.gandi.net/xmlrpc/')
result = await api.version.info()
print(result)
if __name__ == '__main__':
loop = asyncio.get_event_loop()
loop.run_until_complete(print_gandi_api_version())
loop.stop()
Run the example
uv run examples/gandi_api_version.py
This example show an exemple of the server side.
import asyncio
from aioxmlrpc.server import SimpleXMLRPCServer
class Api:
def info(self):
return "1.0.0"
async def sleep(self):
await asyncio.sleep(1)
return "done"
async def main():
server = SimpleXMLRPCServer(("0.0.0.0", 8080))
server.register_instance(Api(), allow_dotted_names=True)
await server.serve_forever()
if __name__ == "__main__":
asyncio.run(main())