Skip to content

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

License

Notifications You must be signed in to change notification settings

jensneuhaus/drf-channels

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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) {

})

About

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

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages