threema.gateway 3.1.0

Note

On machines where Python 3 is not the default Python runtime, you should use pip3 instead of pip.

Prerequisites

$ sudo apt-get install python3 python3-pip

We recommend using venv to create an isolated Python environment:

$ pyvenv venv

You can switch into the created virtual environment venv by running this command:

$ source venv/bin/activate

While the virtual environment is active, all packages installed using pip will be installed into this environment.

To deactivate the virtual environment, just run:

$ deactivate

If you want easier handling of your virtualenvs, you might also want to take a look at virtualenvwrapper.

$ pip install threema.gateway

Command Line Usage

The script threema-gateway provides a command line interface for the Threema gateway. Run the following command to see usage information:

$ threema-gateway --help

Examples

You can find a few example scripts in the examples/ directory.

Note that most of them need to be adjusted to at least add your gateway ID credentials before they run successfully.

Feature Levels

You can see the implemented feature level by invoking the following command:

$ threema-gateway version

$ threema-callback-server --help

Troubleshooting

Invalid environment marker: python_version<=”3.4”

If you’re getting the following error when installing the library:

Unpacking /tmp/threema-msgapi-sdk-python
  Running setup.py (path:/tmp/pip-5b1d7h0w-build/setup.py) egg_info for package from file:///tmp/threema-msgapi-sdk-python
    error in threema.gateway setup command: Invalid environment marker: python_version<="3.4"
    Complete output from command python setup.py egg_info:
    error in threema.gateway setup command: Invalid environment marker: python_version<="3.4"

… then you have an old version of setuptools installed. If you use a venv (as described in the “Prerequisites” section), enter it (using source venv/bin/activate) and then upgrade setuptools:

$ pip install -U setuptools

Now installing the threema.gateway module should work.

Contributing

If you want to contribute to this project, you should install the optional dev requirements of the project in an editable environment:

$ git clone https://github.com/lgrahl/threema-msgapi-sdk-python.git
$ cd threema-msgapi-sdk-python
$ pip install -e .[dev]

Before creating a pull request, it is recommended to run the following commands to check for code style violations (flake8), optimise imports (isort) and run the project’s tests:

$ flake8 .
$ isort -rc .
$ py.test

You should also run the type checker that might catch some additional bugs:

$ mypy .

Reporting Security Issues

Please report security issues directly to one or both of the following contacts:

• Danilo Bargen

  • Email: mail@dbrgn.ch

  • Threema: EBEP4UCA

  • GPG: EA456E8BAF0109429583EED83578F667F2F3A5FA

• Lennart Grahl

  • Email: lennart.grahl@gmail.com

  • Threema: MSFVEW6C

  • GPG: 3FDB14868A2B36D638F3C495F98FBED10482ABA6

Changelog