django-pubsubpull

Pub/sub and pull for Django


Keywords
django, rest, data, pub-sub, pull
Licenses
BSL-1.0/libpng-2.0
Install
pip install django-pubsubpull==0.1.2

Documentation

Django PubSubPull

Build Status

django-pubsubpull is intended to help you decouple micro-services. It provides mechanisms that allow services to publish changes, subscribe to change notifications, and pull records.

In practice what we'll end up with is along the lines of:

  • Use Django slumber and async to provide a load of basic infrastructure this is going to need.
  • Provide new models for tracking database level changes to certain tables (models), and database triggers to ensure that they are properly recorded.
  • All operations will be based on HTTP using GET, PUT and DELETE only.
  • Django middleware to capture as much information about the request and the underlying changes we can and to tie that in to the records of database changes recorded there.
  • Support for Django 1.0 through 1.7. We may support 1.8 and later if we can make our middleware subsume the functionality of the old transaction middleware.
  • Only support Postgres 9.4 and later.

The use cases we envisage include:

  • A service needs to locally cache a copy of some attributes of an object held in another micro-service, generally for performance reasons (for example, a billing service needing copies of a customer's location so that it can choose the correct rates).
  • A service needs to record meta-data about user instructed changes for audit trail purposes (for example, any change to a customer email subscription is recorded with full details of who made the change and when it was made).
  • A service needs to be notified of certain API calls so that it can in turn trigger other behaviours (for example, a comms service sending a welcome email when a new user is created).

The three parts are:

  • Publish: A service will notify it's subscribers about any changes to the requested model instances. Ultimately the publish will hook into a database trigger to ensure that changes are always properly recorded no matter how it occurs.
  • Subscribe: A service can request change notifications be sent to it from the publishing service. The subscriber is able to specify a URL that is used for a PUT request when changes are notified.
  • Pull: A service can iterate over all of the instances of a particular model and then periodically iterate over new ones.