This document covers testing patterns for Antares-Xpansion.

Building Tests

Enable tests during CMake configuration:

cmake -B build -S . -DBUILD_TESTING=ON -DCMAKE_BUILD_TYPE=Release

cmake --build build

Running Tests

All Tests

ctest --test-dir build

Unit Tests Only (C++ and Python)

ctest --test-dir build -L unit

C++ Unit Tests Only

ctest --test-dir build -R '^unit_' -E unit_launcher

Python Unit Tests Only

ctest --test-dir build -R unit_launcher

End-to-End Tests

ctest --test-dir build -L end_to_end

By Duration Label

ctest --test-dir build -L short    # Fast tests
ctest --test-dir build -L medium    # Medium duration
ctest --test-dir build -L long      # Long running tests

With Coverage

cmake -B build -S . -DBUILD_TESTING=ON -DCODE_COVERAGE=ON
cmake --build build
ctest --test-dir build
# Coverage report in build/coverage/

Test Organization

Test Names

Test Pattern	Description
`unit_*`	C++ unit tests
`unit_launcher`	Python unit tests
`examples_*`	Example-based integration tests
`sequential`, `mpibenders`	Benders integration tests

Labels

unit - Unit tests
end_to_end - Integration tests
short, medium, long - Duration categories
benders, lpnamer, bdd - Functional categories

C++ Tests (Google Test)

Location

tests/cpp/
├── benders/
├── full_run/
├── helpers/
├── json_output_writer/
├── logger/
├── lp_namer/
├── merge_mps/
├── multisolver_interface/
├── outer_loop/
├── restart_benders/
├── sensitivity/
├── solvers_interface/
├── study_updater/
├── TestDoubles/
├── tests_utils/
└── zip_mps/

Writing Tests

#include <gtest/gtest.h>
 
class MyClassTest : public ::testing::Test {
protected:
    void SetUp() override {
        // Setup code
    }
};
 
TEST_F(MyClassTest, ShouldDoSomething) {
    MyClass obj;
    EXPECT_EQ(obj.compute(), expected_value);
}

Assertions

Use EXPECT_* for non-fatal failures (test continues)
Use ASSERT_* for fatal failures (stops test)
Prefer clear failure messages:

EXPECT_EQ(actual, expected) << "Failed for input: " << input;

Python Tests (pytest)

Location

tests/python/

Writing Tests

import pytest
 
def test_load_candidates(study_path):
    reader = CandidatesReader(study_path)
    candidates = reader.load()
    assert len(candidates) == 5
    assert "candidate1" in candidates
 
@pytest.fixture
def study_path(tmp_path):
    # Create test study
    return tmp_path / "test_study"

Markers

Available pytest markers (defined in tests/python/pytest.ini or conftest):

@pytest.mark.short_sequential
@pytest.mark.short_mpi
@pytest.mark.medium_*
@pytest.mark.long_*

Run specific markers:

pytest -m short_sequential tests/python/

CI Requirements

All tests must pass before merging
Code coverage must not decrease significantly
Run full test suite locally before pushing