Owl is a tool used for test results reporting and presentation.
In order to use owl, a database with formatted test results should exist. For assistance on how to create such a database and write test results to it see the rspec2db gem, which is used to write RSpec tests to a database. Owl currently supports PostgreSQL databases.
To run the application, Java (JRE) should be installed.
Maven (>= v3) is required for building owl. Run following command to build:
mvn clean package
This command creates
target/owl-VERSION.jar file, which can be started locally or copied to another host to be started on.
To start the application with the default configuration (application.properties) run:
java -jar target/owl-VERSION.jar
An external configuration (application.properties) can be provided when starting the app to configure the project name, database properties, change the port the app is running on or toggle specific features.
The configuration can be saved to a file and passed when starting the app with:
java -jar target/owl-VERSION.jar --spring.config.location=<application.properties>
If there is already a database with data, flyway baseline migration should be run with the flyway properties specified in the properties file:
mvn flyway:baseline -Dflyway.configFile=<application.properties>
To build and run owl (along with Postgres) using Docker Compose:
It will be available on the default
Owl can also be started from a docker image. To build the image run:
docker build -t atlantbh/owl .
By default docker/application.properties will be added to the image.
Start the container:
docker run --name owl -d -p 8090:8090 atlantbh/owl
This API returns all test runs in owl.
Test runs are suite of tests cases that are run on specific
build with specific
To fetch test runs for specific build, one can use:
This API returns all tests cases for given test run id.
Test cases are collection of tests that belong to specific suite.
This API returns all test steps for given test case, identified by
Test steps are lowest level tests, that contain asserts and execution results.
This API returns all test suits in owl.
This API creates new test suite.
This API updates test suite.
This API returns statistics for given test suite id. Statistics is composed of
build identifier with appropriate counts such as
This API allows for parsing and persisting junit format test results. The API accepts Junit Report XML file as body.
Install node (>= v6.0.0)
Install yarn (>= v0.21.3)
brew update brew install yarn yarn --version
owlpasswordshould be created and populated with initial data.
Baseline migrations should be applied by running
Start spring application in debug mode
Start react application development mode (React application is located in
cd src/main/react yarn start