Atom feed server for hypothes.is groups
This simple app serves up an Atom feed of posts to a given
hypothes.is group, including private groups. This is useful for e.g. allowing
group members to receive updates to their email rather than having to check
the group stream regularly.
The following assumes you have Python, pip, and virtualenv already installed.
config.example.py
to config.py
, and edit the settings inside.hypothesis-feed
directory by running virtualenv venv
source venv/bin/activate
.pip install -r requirements.txt
.python app.py
.Repeat steps 3 and 5 whenever you want to run the app.
There are a number of ways to do this. The simplest is perhaps to follow the
local instructions and use ngrok to set up a public URL.
However, the local development server is not designed to be used in this way,
so this is advisable only for testing purposes.
Many other services are available to run Python apps on the web. In general,
you’ll need some kind of WSGI setup to run the app.
Python anywhere is easy to use for this if
you don’t have much experience (or just want a free/simple solution). There are
many tutorials around for running Flask apps on there.
As in the local setup, you will have to copy config.example.py
to config.py
and edit the settings inside before running the app.
I made this module for a course I was taking some time ago, so it may be that
hypothes.is will add their own feed to groups and this will become redundant.
There are already feeds for public content (see the hypothes.is help docs),
but none for private groups (as far as I’m aware).
Also, I’m no longer running this myself for the course in question. So,
though it works at the time of writing, I won’t automatically notice any bugs
or API changes. If you still use it and want me to fix it, just contact me or
add an issue here. I’ll try to get around to it as soon as I can. Alternatively,
you can fix it yourself and submit a pull request.