Metadata-Version: 2.1
Name: federation
Version: 0.24.0
Summary: Python library to abstract social web federation protocols like ActivityPub, Matrix and Diaspora.
Home-page: https://gitlab.com/jaywink/federation
Download-URL: https://pypi.org/project/federation/
Author: Jason Robinson
Author-email: mail@jasonrobinson.me
Maintainer: Jason Robinson
Maintainer-email: mail@jasonrobinson.me
License: BSD 3-clause
Keywords: federation diaspora activitypub matrix protocols federate fediverse social
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Communications
Classifier: Topic :: Internet
Classifier: Topic :: Software Development :: Libraries :: Python Modules
License-File: LICENSE.txt

Introduction
============

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.

.. image:: _static/generic_diagram.png

Status
------

Currently three protocols are being focused on.

* Diaspora is considered to be stable with most of the protocol implemented.
* ActivityPub support should be considered as beta - inbound payload are
  handled by a jsonld processor (calamus)
* Matrix support cannot be considered usable as of yet.

The code base is well tested and in use in several projects. Backward incompatible changes
will be clearly documented in changelog entries.

Additional information
----------------------

Installation and requirements
.............................

See `installation documentation <http://federation.readthedocs.io/en/latest/install.html>`_.

Usage and API documentation
...........................

See `usage documentation <http://federation.readthedocs.io/en/latest/usage.html>`_.

Support and help
................

See `development and support documentation <http://federation.readthedocs.io/en/latest/development.html>`_.

License
.......

`BSD 3-clause license <https://www.tldrlegal.com/l/bsd3>`_.

Author
......

Jason Robinson / `jasonrobinson.me <https://jasonrobinson.me>`_ / `@jaywink:federator.dev <https://matrix.to/#/@jaywink:federator.dev>`_ / `GitLab <https://gitlab.com/jaywink>`_ / `GitHub <https://github.com/jaywink>`_

