# Continuous Integration Scripts for Delta Chat

Continuous Integration, run through [GitHub
Actions](https://docs.github.com/actions),
[CircleCI](https://app.circleci.com/) and an own build machine.

## Description of scripts 

- `../.github/workflows` contains jobs run by GitHub Actions.

- `../.circleci/config.yml` describing the build jobs that are run
  by CircleCI.

- `remote_tests_python.sh` rsyncs to a build machine and runs
  `run-python-test.sh` remotely on the build machine. 

- `remote_tests_rust.sh` rsyncs to the build machine and runs
  `run-rust-test.sh` remotely on the build machine. 

- `doxygen/Dockerfile` specifies an image that contains
  the doxygen tool which is used by `run-doxygen.sh` 
  to generate C-docs which are then uploaded 
  via `ci_upload.sh` to `https://c.delta.chat/_unofficial_unreleased_docs/<BRANCH>`
  (and the master branch is linked to https://c.delta.chat proper). 


## Triggering runs on the build machine locally (fast!)

There is experimental support for triggering a remote Python or Rust test run 
from your local checkout/branch. You will need to be authorized to login to 
the build machine (ask your friendly sysadmin on #deltachat freenode) to type::

    scripts/manual_remote_tests.sh rust
    scripts/manual_remote_tests.sh python

This will **rsync** your current checkout to the remote build machine 
(no need to commit before) and then run either rust or python tests. 

# Outdated files (for later re-use)

`coredeps/Dockerfile` specifies an image that contains all 
of Delta Chat's core dependencies. It used to run 
python tests and build wheels (binary packages for Python)

You can build the docker images yourself locally
to avoid the relatively large download:: 
 
    cd scripts  # where all CI things are 
    docker build -t deltachat/coredeps docker-coredeps
    docker build -t deltachat/doxygen docker-doxygen 

Additionally, you can install qemu and build arm64 docker image:
    apt-get install qemu binfmt-support qemu-user-static
    docker build -t deltachat/coredeps-arm64 docker-coredeps-arm64