deltachat-core/ci_scripts

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