77db475663
- better README reflecting how to use things, don't advertise run-integration-tests to only have one documented way and use less tools for rust-devs that just want to run python tests - fix test skipping and get circle-ci to play along - update docker related docs as well
Continuous Integration Scripts for Delta Chat
Continuous Integration is run through CircleCI but is largely independent of it.
Generating docker containers for performing build step work
All tests, docs and wheel building is run in docker containers:
-
coredeps/Dockerfile specifies an image that contains all of Delta Chat's core dependencies as linkable libraries. It also serves to run python tests and build wheels (binary packages for Python).
-
doxygen/Dockerfile specifies an image that contains the doxygen tool which is used to generate C-docs.
To run tests locally you can pull existing images from "docker.io", the hub for sharing Docker images::
docker pull deltachat/coredeps
docker pull deltachat/doxygen
or you can build the docker images yourself locally to avoid the relatively large download::
cd ci_scripts # where all CI things are
docker build -t deltachat/coredeps docker-coredeps
docker build -t deltachat/doxygen docker-doxygen
ci_run.sh (main entrypoint called by circle-ci)
Once you have the docker images available you can run python testing, documentation generation and building binary wheels::
sh DOCS=1 TESTS=1 ci_scripts/ci_run.sh
ci_upload.sh (uploading artifacts on success)
-
python docs to
https://py.delta.chat/_unofficial_unreleased_docs/<BRANCH> -
doxygen docs to
https://c.delta.chat/_unofficial_unreleased_docs/<BRANCH> -
python wheels to
https://m.devpi.net/dc/<BRANCH>so that you install fully self-contained wheels like this:pip install -U -i https://m.devpi.net/dc/<BRANCH> deltachat