https://github.com/mosquito/aiohttp-jsonrpc

JSON-RPC server and client implementation based on aiohttp
https://github.com/mosquito/aiohttp-jsonrpc

aiohttp async asyncio json-rpc

Last synced: about 10 hours ago
JSON representation

JSON-RPC server and client implementation based on aiohttp

• Host: GitHub
• URL: https://github.com/mosquito/aiohttp-jsonrpc
• Owner: mosquito
• License: mit
• Created: 2017-11-10T21:08:03.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2022-09-15T20:16:57.000Z (over 2 years ago)
• Last Synced: 2024-12-30T01:41:54.282Z (2 days ago)
• Topics: aiohttp, async, asyncio, json-rpc
• Language: Python
• Size: 30.3 KB
• Stars: 16
• Watchers: 3
• Forks: 6
• Open Issues: 2
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
AIOHTTP JSON RPC

================

.. image:: https://github.com/mosquito/aiohttp-jsonrpc/workflows/tox/badge.svg

    :target: https://github.com/mosquito/aiohttp-jsonrpc/actions?query=branch%3Amaster

.. image:: https://img.shields.io/pypi/v/aiohttp-jsonrpc.svg

    :target: https://pypi.python.org/pypi/aiohttp-jsonrpc/

    :alt: Latest Version

.. image:: https://img.shields.io/pypi/wheel/aiohttp-jsonrpc.svg

    :target: https://pypi.python.org/pypi/aiohttp-jsonrpc/

.. image:: https://img.shields.io/pypi/pyversions/aiohttp-jsonrpc.svg

    :target: https://pypi.python.org/pypi/aiohttp-jsonrpc/

.. image:: https://img.shields.io/pypi/l/aiohttp-jsonrpc.svg

    :target: https://pypi.python.org/pypi/aiohttp-jsonrpc/

JSON-RPC server and client implementation based on aiohttp.

Server example

---------------

.. code-block:: python

    from aiohttp import web

    from aiohttp_jsonrpc import handler

    class JSONRPCExample(handler.JSONRPCView):

        def rpc_test(self):

            return None

        def rpc_args(self, *args):

            return len(args)

        def rpc_kwargs(self, **kwargs):

            return len(kwargs)

        def rpc_args_kwargs(self, *args, **kwargs):

            return len(args) + len(kwargs)

        def rpc_exception(self):

            raise Exception("YEEEEEE!!!")

        def rpc_test_notification(self):

            print("Notification received")

    app = web.Application()

    app.router.add_route('*', '/', JSONRPCExample)

    if __name__ == "__main__":

        import logging

        logging.basicConfig(level=logging.INFO)

        web.run_app(app, print=logging.info)

Client example

--------------

.. code-block:: python

    import asyncio

    from aiohttp_jsonrpc.client import ServerProxy

    loop = asyncio.get_event_loop()

    client = ServerProxy("http://127.0.0.1:8080/", loop=loop)

    async def main():

        print(await client.test())

        # Or via __getitem__

        method = client['args']

        notification = client.create_notification("test_notification")

        print(await method(1, 2, 3))

        await notification()

        results = await client.batch(

            client['test'],

            client['test'].prepare(),

            client['args'].prepare(1, 2, 3),

            client['not_found'].prepare(1, 2, 3),

            # notify with params

            notification.prepare(),

            # notification without params

            notification,

        )

        print(results)

        client.close()

    if __name__ == "__main__":

        loop.run_until_complete(main())