Python library to abstract social web federation protocols like ActivityPub, Diaspora and Matrix.
 
 
Go to file
Jason Robinson ffa59bece3 Update FUNDING.yml 2019-05-31 20:47:59 +00:00
.github Update FUNDING.yml 2019-05-31 20:47:59 +00:00
docs Add Accept entity and ActivityPub follow auto-Accept flow 2019-03-17 03:17:10 +02:00
federation Fix IPData lookup after 3.x version breaking changes 2019-05-12 18:56:40 +03:00
.coveragerc Add tox and gitlab CI 2018-07-23 19:15:34 +03:00
.gitignore Add pytest cache to gitignore 2018-02-02 17:16:16 +02:00
.gitlab-ci.yml Add tox and gitlab CI 2018-07-23 19:15:34 +03:00
CHANGELOG.md Refactor handle_send function recipients and delivery code 2019-03-17 19:39:55 +02:00
LICENSE.txt Add metadata and push 0.3.2 to PyPi 2016-07-15 20:40:33 +03:00
MANIFEST.in Add docs introduction to manifest 2016-10-04 22:42:11 +03:00
README.md Add link to Feneas gitlab issue tracker 2019-05-18 21:32:28 +00:00
dev-requirements.txt Add pytest-blockage 2018-08-11 23:41:15 +03:00
pytest.ini Move test settings and utils for Django to tests root 2018-09-29 12:12:34 +03:00
setup.cfg Add metadata and push 0.3.2 to PyPi 2016-07-15 20:40:33 +03:00
setup.py Fix IPData lookup after 3.x version breaking changes 2019-05-12 18:56:40 +03:00
tox.ini Add tox and gitlab CI 2018-07-23 19:15:34 +03:00

README.md

pipeline status codecov.io issue tracker

PyPI version Documentation Status PyPI PyPI

federation

Python library to abstract social web federation protocols like Diaspora and ActivityPub.

Introduction

The aim of federation is to provide and abstract multiple social web protocols like Diaspora and ActivityPub in one package. This way applications can be built to (almost) transparently support many protocols without the app builder having to know everything about those protocols.

While the library does aim to provide an easy way to implement protocols like Diaspora into your application, it will not be a one to one mirror image of said protocols. The idea is to present one unified collection of entities and high level methods to the application to use. Since protocols can support different feature sets or have different ideas on even simple entities like status messages, it would be impossible to model the core entities according to a single protocol.

Status

Currently two protocols are being focused on. Diaspora is considered in relatively stable status with most of the protocol implemented. ActivityPub support is work in progress.

The code base is well tested and in use in several projects. Backward incompatible changes will however be made at this stage still, however those will be clearly documented in changelog entries.

Additional information

Installation and requirements

See installation documentation.

Usage and API documentation

See usage documentation.

Support and help

See development and support documentation.

License

BSD 3-clause license

Author

Jason Robinson / https://jasonrobinson.me / https://git.feneas.org/jaywink / https://github.com/jaywink