Backend implementation for python-omemo, equipping python-omemo with support for OMEMO under the namespace urn:xmpp:omemo:2 (casually/jokingly referred to as "twomemo").

Installation

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

Protobuf

Install protoc. Then, in the root directory of this repository, run:

$ pip install --upgrade .[dev]
$ protoc --python_out=twomemo/ --mypy_out=twomemo/ twomemo.proto

This will generate twomemo/twomemo_pb2.py and twomemo/twomemo_pb2.pyi.

Type Checks and Linting

python-twomemo uses mypy for static type checks and both pylint and Flake8 for linting. All checks can be run locally with the following commands:

$ pip install --upgrade .[lint]
$ mypy twomemo/
$ pylint twomemo/
$ flake8 twomemo/

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/.