https://github.com/and3rson/radical

Multi-transport RPC with asyncio & Django support.
https://github.com/and3rson/radical

asyncio django inter-service-communication isc python python3 redis rpc sanic

Last synced: 28 days ago
JSON representation

Multi-transport RPC with asyncio & Django support.

• Host: GitHub
• URL: https://github.com/and3rson/radical
• Owner: and3rson
• Created: 2018-07-31T10:33:46.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2018-08-01T18:56:24.000Z (over 6 years ago)
• Last Synced: 2025-01-02T08:03:47.813Z (about 1 month ago)
• Topics: asyncio, django, inter-service-communication, isc, python, python3, redis, rpc, sanic
• Language: Python
• Size: 28.3 KB
• Stars: 2
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst

Awesome Lists containing this project

README

        
.. image:: https://raw.githubusercontent.com/and3rson/radical/master/images/logo.png

.. contents:: Contents

Decription

----------

About

~~~~~

Radical is a RPC library that allows you to have cross-service communication out of the box.

It can serve as a replacement for Celery.

Radical has out-of-the-box integration with Django and also supports asyncio, but can be used without it.

Radical is easily extensible with custom transports and serializers.

Available transports:

* Redis

* Postgres

Default and recommended transport is Redis.

Available serializers:

* JSON

* Pickle

Default and recommended serializer is Pickle.

Glossary

~~~~~~~~

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

Term            Meaning

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

Service         A fully autonomous application written with Django,

                Sanic or vanilla Python.

Transport       Module that provides interface to actual network

                communication: for example, a Redis transport.

Serializer      Module that provides interface to data

                serialization and deserialization.

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

Quick start

-----------

Installing

~~~~~~~~~~

.. code-block:: sh

    pip install radical-rpc

Using with Django

~~~~~~~~~~~~~~~~~

1. Add Radical to INSTALLED_APPS:

    .. code-block:: python

        INSTALLED_APPS = [

            # ...

            'radical',

            # ...

        ]

2. Configure Radical:

    .. code-block:: python

        RADICAL_CONFIG = {

            'TRANSPORT_URL': 'redis://redis:6379/0?request_timeout=10',

            'QUEUE_NAME': 'myapp',

            'MODULES': [

                'radical.demo'

            ]

        }

3. Call it anywhere:

    .. code-block:: python

        from radical.contrib.django import call_wait, call

        from django.http import JsonResponse

        def some_view(request):

            # Call remote method and wait for it to return result.

            result = call_wait('myapp', 'radical.demo.add', 1300, 37)

            return JsonResponse(dict(result=result))  # Returns {'result': 1337}

        def some_view(request):

            # Call remote method and do not wait for it to finish.

            call('myapp', 'radical.demo.add', 1300, 37)

            return JsonResponse(dict(result='Job was scheduled.'))

4. Start Radical worker:

    .. code-block:: bash

        ./manage.py radical