Skip to main content

Simple Resource binding and Consumer Mixin for Django Rest Framework and Channels 2

Project description

DRF Channels

https://travis-ci.org/iamriel/drf-channels.svg?branch=master

DRF Channels provides a simple django-channels bindings and consumer mixin that can be used to automatically listen and send to groups everytime a Resource is created/updated/deleted.

It requires Python >= 3.5, Channels >= 2.0, Django >=1.11, and Django Rest Framework 3.x

This is like a port of Channels 1.x’s Data_Binding and Channels API with few differences.

The data sent to the clients are based on the Serializer class provided.

How does it work?

The API exposes a ResourceBinding class that holds your Model, Serializer class, and Consumer class. Your Consumer class needs to be a subclass of AsyncJsonWebsocketConsumer from channels and have a AsyncConsumerActionMixin mixin.

The ResourceBinding class binds pre_save, pre_delete, post_save, and post_delete signals to your model. These signals will then send to the corresponding Consumer groups that listens to your stream.

The first thing you need to do is connect to your consumer and pass the actions you want to subscribe to via url parameters.

For example, you want to subscribe to the create and update actions Job Resource (Model), and the channels route is /jobs/, You will connect to the websocket like below, if you are using Channels Websocket Wrapper:

const webSocketBridge = new channels.WebSocketBridge()
webSocketBridge.connect('/jobs/?subscribe=create,update')

You then need to add a listener on your webSocketBridge to receive the messages sent by the Consumer via signals.

webSocketBridge.socket.addEventListener('message', function(event) {

})

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
drf_channels-0.1.1-py3-none-any.whl (9.5 kB) Copy SHA256 hash SHA256 Wheel py3
drf_channels-0.1.1.tar.gz (7.2 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page