Skip to content

How to use Birch with Travis CI for continuous integration

Travis CI is one of many continuous-integration services that work alongside code repository services to run tests whenever new commits are made to a code repository. Other continuous-integration services include CircleCI and Bitrise. Software for continuous integration includes Jenkins.

Travis CI happens to be used by the Birch development team. Setting it up was not entirely trivial; this page explains how it was done in case others wish to use Travis CI for their Birch projects.

The main issue is that the Linux image used by Travis CI is based on Ubuntu 14.04, which is now several years old. The default gcc provided with this distribution does not support the C++14 language features required by Birch. Furthermore, the version of Eigen provided with this distribution requires updating for Birch.

After signing up for the Travis CI service, you will need to add a .travis.yml file to your code repository to configure the continuous-integration service. Follow the Travis CI documentation for details, but a suggested template for Birch projects is as follows:

language: cpp
    # macOS environment
    - os: osx
      compiler: clang
      osx_image: xcode9.3

    # Ubuntu 14.04 environment
    - os: linux
      dist: trusty
      compiler: gcc
            - ubuntu-toolchain-r-test
            - gcc-7
            - g++-7
            - autoconf
            - libtool
            - flex
            - bison
            - libboost-all-dev
  # OS-specific things
  - if [[ "$TRAVIS_OS_NAME" == "linux" ]]; then
      export CC=gcc-7;
      export CXX=g++-7;
      wget && tar xzf 3.3.4.tar.gz && sudo cp -Rp eigen-eigen-5a0156e40feb /usr/local/include/eigen3;
    elif [[ "$TRAVIS_OS_NAME" == "osx" ]]; then
      brew install flex bison eigen;

  # Checkout Birch, which may be cached, and (re)build
  - git clone --depth 1 "" || (cd Birch && git pull && cd ..)
  - cd Birch && ./ && ./configure && make -j 2 && sudo make install && cd ..

  # Checkout Birch.Standard, which may be cached, and (re)build
  - git clone --depth 1 "" || (cd Birch.Standard && git pull && cd ..)
  - cd Birch.Standard && birch build && sudo birch install && cd ..
  - birch build && sudo birch install
  - birch sample --model YourModel --input-file input/input_file.json --output-file output/output_file.json
    - Birch
    - Birch.Standard

This configuration file:

  • sets up both macOS and Ubuntu Linux build environments,
  • updates gcc and Eigen in the Ubuntu Linux build environment, and
  • includes caching of the Birch compiler and Birch standard library so that they are only recompiled when necessary.

Anecdotally, for Birch.Example we are observing that tests take about 10 minutes on macOS instances and 20 minutes on Ubuntu Linux instances, reducing to about 4 minutes and 8 minutes when the Birch compiler and Birch standard library do not need to be recompiled.