slixmpp-omemo - Slixmpp OMEMO plugin

A plugin for slixmpp offering the OMEMO Multi-End Message and Object Encryption protocol, based on python-omemo.

OMEMO protocol version support

Currently supports OMEMO in the eu.siacs.conversations.axolotl namespace. Support for OMEMO in the omemo:2 namespace is prepared and will be enabled as soon as Slixmpp gains support for XEP-0420: Stanza Content Encryption.

Trust

Supports Blind Trust Before Verification and manual trust management.

Installation

Install the latest release using pip (pip install slixmpp_omemo) or manually from source by running pip install . in the cloned repository.

Testing, Type Checks and Linting

slixmpp-omemo uses pytest as its testing framework, mypy for static type checks and both pylint and Flake8 for linting. All tests/checks can be run locally with the following commands:

$ pip install --upgrade .[test,lint]
$ mypy slixmpp_omemo/ examples/ tests/
$ pylint slixmpp_omemo/ examples/ tests/
$ flake8 slixmpp_omemo/ examples/ tests/
$ pytest

Getting Started

Refer to the documentation on readthedocs.io, or build it locally. Additional requirements to build the docs can be installed using pip install .[docs]. With all dependencies installed, run make html in the docs/ directory. The documentation can then be found in docs/_build/html/.