build_ocarina.sh

About

The build_ocarina.sh script is a helper program to get source code, compile, package and test Ocarina on all supported platforms. It relies on shell constructs to coordinate various activities:

fetch Ocarina source, with its runtimes PolyORB-HI/Ada and PolyORB-HI/C, and the AADLib library
compile Ocarina, and install it in a local directory
run Ocarina testsuites, and eventually collect coverage metrics
package Ocarina and its runtime
upload archives

Installation

The preferred way to install this script is simply to clone the repository:

git clone https://github.com/OpenAADL/ocarina-build.git

This will ensure future update of the script in a seamless way.

Demo

The script aims at automating everything, starting with a fresh-install

Details

The following

./build_ocarina.sh --scenario=fresh-install --prefix=$PWD/ocarina_install

builds a fresh copy of Ocarina and install it in $PWD/ocarina_install. This is equivalent to

./build_ocarina.sh --reset --update --configure --build --prefix=$PWD/ocarina_install

Multiple scenarios exist for nightly builds, CI testings and others.

Usage

Usage: ./build_ocarina.sh [switches]

General commands
 -h | --help        : print usage
 --version          : return script version, as a git hash
 --self-update      : update this script
 --install_crontab  : install crontab, then exit
 --purge            : delete source and build directories
 --verbose          : return full log of each action

Script commands
 -c | --configure   : configure Ocarina source directory
 -u | --update      : update Ocarina source directory
 -b | --build       : configure, build and install Ocarina
 -t | --run-test    : run Ocarina testsuite, plus runtimes and AADLib
 -p | --package     : package ocarina distribution as tarball
 --upload           : upload archives, see source code for details
 --distclean        : distclean Ocarina build directory
 --remove-prefix    : remove prefix prior to installation
 --release          : release Ocarina on GitHub
 --force            : force build

Update-time options, options to be passed along with -u
 -s | --reset       : reset source directory prior to update
 --remote=<URL>     : Set URL of the Ocarina git repository

Build-time options, options to be passed along with -b
 --prefix=<dir>     : install ocarina in <dir>
 --enable-doc       : enable building the documentation
 --enable-gcov      : enable coverage during ocarina build
 --enable-debug     : enable debug during ocarina build
 --enable-python    : enable Python bindings
 --build-info       : display information on build environment

Scenarios, specific combination of parameters
 --scenario=<name>  : run a specific scenario

 Valid names are coverage fresh-install nightly-build taste github
 See source code for details.

 Note: a default scenario can be passed using the OCARINA_SCENARIO
 environment variable

Authors

Jerome Hugues, maintainer
Bechir Zalila, original version