federation/README.md

49 wiersze
2.4 KiB
Markdown
Czysty Zwykły widok Historia

[![pipeline status](https://git.feneas.org/jaywink/federation/badges/master/pipeline.svg)](https://git.feneas.org/jaywink/federation/commits/master) [![codecov.io](https://codecov.io/github/jaywink/federation/coverage.svg?branch=master)](https://codecov.io/github/jaywink/federation?branch=master) [![issue tracker](https://img.shields.io/badge/issue%20tracker-gitlab-orange.svg)](https://git.feneas.org/jaywink/federation/issues)
[![PyPI version](https://badge.fury.io/py/federation.svg)](https://pypi.python.org/pypi/federation) [![Documentation Status](http://readthedocs.org/projects/federation/badge/?version=latest)](http://federation.readthedocs.io/en/latest/?badge=latest) [![PyPI](https://img.shields.io/pypi/pyversions/federation.svg?maxAge=2592000)](https://pypi.python.org/pypi/federation) [![PyPI](https://img.shields.io/pypi/l/federation.svg?maxAge=2592000)](https://pypi.python.org/pypi/federation)
2017-05-14 13:00:59 +00:00
# federation
2017-04-08 08:03:47 +00:00
Python library to abstract social web federation protocols like ActivityPub and Diaspora.
2016-04-03 11:57:46 +00:00
## Introduction
2016-04-03 11:57:46 +00:00
The aim of `federation` is to provide and abstract multiple social web protocols like
ActivityPub and Diaspora in one package, over an easy to use and understand Python API.
This way applications can be built to (almost) transparently support many protocols
without the app builder having to know everything about those protocols.
![](http://federation.readthedocs.io/en/latest/_images/generic_diagram.png)
2016-10-02 10:08:37 +00:00
2016-10-04 18:31:51 +00:00
## Status
Currently two protocols are being focused on. Diaspora is considered to be stable with most
of the protocol implemented. ActivityPub support should be considered as alpha - all the basic
things work but there are likely to be a lot of compatibility issues with other ActivityPub
implementations.
The code base is well tested and in use in several projects. Backward incompatible changes
will be clearly documented in changelog entries.
2016-10-04 18:31:51 +00:00
## Additional information
### Installation and requirements
See [installation documentation](http://federation.readthedocs.io/en/latest/install.html).
2016-10-04 18:31:51 +00:00
### Usage and API documentation
See [usage documentation](http://federation.readthedocs.io/en/latest/usage.html).
2016-10-04 18:31:51 +00:00
### Support and help
See [development and support documentation](http://federation.readthedocs.io/en/latest/development.html).
2016-10-04 18:31:51 +00:00
### License
[BSD 3-clause license](https://www.tldrlegal.com/l/bsd3)
### Author
Jason Robinson / https://jasonrobinson.me / https://git.feneas.org/jaywink / https://github.com/jaywink