1. Stellarity Software Avatar Stellarity Software
  2. GoogleTest Task
  3. GoogleTest Task

Wiki

Clone wiki

GoogleTest Task / Home

View History

GoogleTest Task for Bamboo Documentation

Use Google C++ Testing Framework with Bamboo. The addon runs multiple tests in parallel and parses their results.

1. Overview

This addon provides integration of Google C++ Testing Framework with Atlassian Bamboo.

Features

  • Run tests faster using parallel execution
  • Define tests by Ant Style Pattern
  • One task for a test runner and a log parser
  • Show parameters of parametrized tests
  • Parse-only mode
  • Customize tests with environment variables
  • Avoid test name collision
  • Configurable test execution timeout

Compatibility

  • Version 1.1.x => Bamboo 8.0-9.x (DC only)
  • Version 1.0.x => Bamboo 5.0-9.6

For download and purchasing details visit Atlassian Marketplace.

2. Admin guide

2.1. How to install

The Universal Plugin Manager (UPM) is a tool for administering apps in Atlassian applications. You can use the UPM to find and install, manage, and configure apps:

3. User guide

3.1. Task parameters (general)

Parameter Description
Parse-Only Mode If turned on the plugin won't run test executables but parse already created test output files. Default value is off.
Subdirectory By default the working directory (where Ant Style Pattern is applied) is a plan directory. However it can be changed to any other relative directory. For example you can set it to a build output directory.

Example: bin/release

3.2. Task parameters (normal mode)

Parameter Description
Test Executables This is a comma separated list of test executables. You can use Ant Style Pattern to define them. The task fails if there is no test executables or any of them is not producing a valid Boost::Test output. Note: if a test doesn't produce any output during the specified timeout value (can be changed in advanced options) it is treated as hanging and will be terminated.

Example: *test*.exe, **/test.exe,mytest.exe
Environment Variables There you can specify any extra environment variables you want to pass to your tests. Use the format <name>=<value> and separate name-value pairs with spaces.

Example: myvar1="my value" myvar2=value2

3.3. Task parameters (parse-only mode)

Parameter Description
Test Output Files This is a comma separated list of test output files. You can use Ant Style Pattern to define them. To get proper xml files use the following command line options during tests execution: --output_format=xml --log_level=test_suite.

Example: *test*.xml, **/test.xml,mytest.xml
Pick Outdated Files If turned on the plugin will process all matched files. Otherwise only files changed after the build start time will be processed. Default value is off.

3.4. Task parameters (advanced)

Parameter Description
Use task name to avoid name collisions Task name will be appended to a test suite name (to fulfill Bamboo requirement for unique names).
Use file name to avoid name collisions File name will be appended to a test suite name (to fulfill Bamboo requirement for unique names).
Timeout Test execution timeout, in minutes. Default value is 10.

4. Release notes

4.1. Version 1.1.x (for Bamboo 8.0-9.x DC only)

Version 1.1.0 (29 Mar 2024)

  • Enh: Drop Bamboo Server support (only DC now)
  • Enh: Update dependencies

4.2. Version 1.0.x (for Bamboo 5.0-9.6)

Version 1.0.9 (15 May 2022)

  • New: Data Center compatibility release

Version 1.0.8 (20 Feb 2022)

  • New: INCOMING DATA CENTER APPROVAL

Version 1.0.7 (15 Mar 2020)

  • New: Bamboo 7.0 support

Version 1.0.6 (13 Jan 2019)

  • New: Dump stdout before parsing output file (improve troubleshooting)

Version 1.0.5 (15 Dec 2018)

  • Fix #9: Value of "Pick up test results that were created outside of this build" is reversed

Version 1.0.4 (13 Dec 2018)

  • New #6: Automatically exclude xml files in search pattern for binaries
  • New #8: Better logging of ExecutionException and TaskException
  • Fix #7: New lines are broken in build log on Linux

Version 1.0.3 (1 Oct 2018)

  • Fix #5: Test results can be missed in rare cases under multithreaded load

Version 1.0.2 (25 Dec 2017)

  • New #2: Avoid test name collision
  • New #3: Ability to change test execution timeout value

Version 1.0.1 (30 Oct 2016)

  • Fix #1: Update logo image

Version 1.0.0 (09 May 2016)

  • Initial public release

5. Support

If you find a bug, have a feature request or have an idea how to improve this plugin please post it to the public bug tracker.

6. Contact

Feel free to contact us via email and visit our website.

Updated