Python bindings for the Delta Chat Core library using CFFI against the Rust-implemented libdeltachat
Project description
This package provides bindings to the deltachat-core Rust -library which provides imap/smtp/crypto handling as well as chat/group/messages handling to Android, Desktop and IO user interfaces.
Installing pre-built packages (linux-only)
If you have a linux system you may install the deltachat binary “wheel” package without any “build-from-source” steps.
Install virtualenv, then create a fresh python environment and activate it in your shell:
virtualenv -p python3 venv source venv/bin/activate
Afterwards, invoking python or pip install will only modify files in your venv directory and leave your system installation alone.
Install the wheel for linux:
pip install deltachat Verify it worked by typing:: python -c "import deltachat"
Installing a wheel from a PR/branch
For Linux, we automatically build wheels for all github PR branches and push them to a python package index. To install the latest github master branch:
pip install -i https://m.devpi.net/dc/master deltachat
Installing bindings from source
If you can’t use “binary” method above then you need to compile to core deltachat library:
git clone https://github.com/deltachat/deltachat-core-rust cd deltachat-core-rust cargo build -p deltachat_ffi --release
This will result in a libdeltachat.so and libdeltachat.a files in the target/release directory. These files are needed for creating the python bindings for deltachat:
cd python DCC_RS_DEV=`pwd`/.. pip install -e .
Now test if the bindings find the correct library:
python -c 'import deltachat ; print(deltachat.__version__)'
This should print your deltachat bindings version.
Using a system-installed deltachat-core-rust
When calling pip without specifying the DCC_RS_DEV environment variable cffi will try to use a deltachat.h from a system location like /usr/local/include and will try to dynamically link against a libdeltachat.so in a similar location (e.g. /usr/local/lib).
Code examples
You may look at examples.
Running tests
Get a checkout of the deltachat-core-rust github repository and type:
pip install tox ./run-integration-tests.sh
If you want to run functional tests with real e-mail test accounts, generate a “liveconfig” file where each lines contains test account settings, for example:
# 'liveconfig' file specifying imap/smtp accounts addr=some-email@example.org mail_pw=password addr=other-email@example.org mail_pw=otherpassword
The “keyword=value” style allows to specify any deltachat account config setting so you can also specify smtp or imap servers, ports, ssl modes etc. Typically DC’s automatic configuration allows to not specify these settings.
The run-integration-tests.sh script will automatically use python/liveconfig if it exists, to manually run tests with this liveconfig file use:
tox -- --liveconfig liveconfig
Running test using a debug build
If you need to examine e.g. a coredump you may want to run the tests using a debug build:
DCC_RS_TARGET=debug ./run-integration-tests.sh -e py37 -- -x -v -k failing_test
Building manylinux1 wheels
Building portable manylinux1 wheels which come with libdeltachat.so and all it’s dependencies is easy using the provided docker tooling.
using docker pull / premade images
We publish a build environment under the deltachat/wheel tag so that you can pull it from the hub.docker.com site’s “deltachat” organization:
$ docker pull deltachat/wheel
The deltachat/wheel image can be used to build both libdeltachat.so and the Python wheels:
$ docker run --rm -it -v $(pwd):/io/ deltachat/wheel /io/python/wheelbuilder/build-wheels.sh
This command runs a script within the image, after mounting $(pwd) as /io within the docker image. The script is specified as a path within the docker image’s filesystem. The resulting wheel files will be in python/wheelhouse.
Optionally build your own docker image
If you want to build your own custom docker image you can do this:
$ cd deltachat-core # cd to deltachat-core checkout directory $ docker build -t deltachat/wheel python/wheelbuilder/
This will use the python/wheelbuilder/Dockerfile to build up docker image called deltachat/wheel. You can afterwards find it with:
$ docker images
Troubleshooting
On more recent systems running the docker image may crash. You can fix this by adding vsyscall=emulate to the Linux kernel boot arguments commandline. E.g. on Debian you’d add this to GRUB_CMDLINE_LINUX_DEFAULT in /etc/default/grub.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distributions
Hashes for deltachat-0.600.0-cp37-cp37m-manylinux1_x86_64.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 607c22d37d7ec48f27e9f25f50a2c9220cc42067ceb18b4cc5e72de6ce145591 |
|
| MD5 | 50e92c001655974957ba91d5f7f95676 |
|
| BLAKE2b-256 | ebca3b07ec05540e425bff11dd044cc953d1be4abe5c406d8e965cc8c3660666 |
Hashes for deltachat-0.600.0-cp36-cp36m-manylinux1_x86_64.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | db95ed6ed8d8f9e8235be0b8ff362cd51d2b7172319030bbe15a77354487c91d |
|
| MD5 | 039ad26265bf1ff72c32ea58808be72b |
|
| BLAKE2b-256 | 16ec4d5e089785e2e21c1fc400684beb2f82379663cd4d23a7369059b8dafdb3 |
Hashes for deltachat-0.600.0-cp35-cp35m-manylinux1_x86_64.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 1feb338dd5baf4b5a5cfd3fad5d28101cef556919c6bcba36a8fb12bdd15238c |
|
| MD5 | 8df920ad324b6961d1ec129ed314974d |
|
| BLAKE2b-256 | 116fe554436c6d8a2346c6337077386660bf0753ca029b58b1d71ba2ef02c209 |
Hashes for deltachat-0.600.0-cp27-cp27m-manylinux1_x86_64.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 28cc7863fd1c19218f6cc9e7964bc60c949a23a1b3f15d36f6ae2759271c0851 |
|
| MD5 | fc04533ed11bd3b16ad14c98a4172dbd |
|
| BLAKE2b-256 | a81bd685a6d4fea152cb6e41cef3f221eaaf05b89d9fc0eaa5e9c55750e77957 |
