Skip to content

Latest commit

 

History

History
33 lines (27 loc) · 2.04 KB

README.md

File metadata and controls

33 lines (27 loc) · 2.04 KB

Flask-WebSub

Build Status Documentation PyPI version

An implementation of a WebSub hub, publisher and subscriber as a Flask extension. The implementation is meant to be used as a library that can be integrated in a larger application.

WebSub allows content providers to notify content subscribers of new content. For example, a content provider could provide an RSS feed that a user (using a web-based RSS reader) is interested in. Then the content provider could use the publisher functionality of this package to advertise its support for WebSub. The user's client can then subscribe to the feed using the subscriber functionality of this extension. When the content provider publishes a blog post, it notifies the so-called hub, which in turn notifies all subscribers. You can either host your own hub (using the hub functionality of this package) or depend upon one of the existing ones offered online. You can think of WebSub as a standardized version of web hooks, that (due to mandatory resubscribing every now and then) are more robust and support content integrity verification.

The components are split up into multiple packages, so you don't necessarily have to use all three. It is for example possible to use the subscriber implementation with an external hub. To learn to use this package, take a look at the client_example.py (subscriber) and server_example.py (hub/publisher) files. See the documentation for further information: https://flask-websub.readthedocs.io/

Using the flask_websub.hub package requires celery.

For more about WebSub, which was previously named PubSubHubbub, see its specification: https://www.w3.org/TR/websub/