/aws-build-accumulator

Litani metabuild system

Primary LanguagePythonApache License 2.0Apache-2.0

Litani

Litani is a build system that provides an HTML dashboard of job results, as well as a JSON-formatted record of job results. It provides platform-independent job control (timeouts, return code control) and an output format that is easy to render into reports (for example, using the built-in renderer).

Documentation

Hosted here. The Homebrew and Debian packages also install the man pages locally, try man litani-add-job.

Installation

To install with Homebrew:

brew install litani

On Ubuntu, Install Litani by downloading the *.deb package built by each release, available on the releases page and run

apt install -y litani-x.xx.x.deb  # where x.xx.x is the release version.

Dependencies

If you are cloning the source code, you will need the following dependencies:

Required

  • Python3
  • Ninja
    • apt-get install ninja-build, brew install ninja
  • Jinja
    • pip3 install jinja2

Recommended

  • Graphviz DOT
    • apt-get install graphviz, brew install graphviz
  • Gnuplot to generate graphs on the dashboard
    • apt-get install gnuplot, brew install gnuplot

Optional

  • Voluptuous to perform sanity-checking on internal data structures
    • pip3 install voluptuous
  • coreutils to build the documentation
    • brew install coreutils
  • mandoc to build the documentation
    • brew install mandoc
  • scdoc to build the documentation
    • brew install scdoc