# Testing

AURORA uses the Zephyr {external+zephyr:ref}`ztest <test-framework>` framework
and the {external+zephyr:ref}`twister <twister_script>` test runner.
Unit tests run on `qemu_x86` and require the `x86_64-zephyr-elf` toolchain.

## Running Tests

```shell
# Run all unit tests
west twister -T tests -v --inline-logs

# Run a single test suite by path
west twister -T tests/lib/state -v --inline-logs

# Build-verify sensor_board against all supported boards
west twister -T sensor_board -v --inline-logs --integration
```

## Test Layout

Each test suite lives under `tests/` in a directory that mirrors the
library it covers.  A `testcase.yaml` file alongside the test source
tells Twister how to build and run the suite:

```
tests/
└── lib/
    └── state/
        ├── testcase.yaml
        └── src/
            └── main.c
```

## Writing Tests

Tests use the `ZTEST_SUITE` / `ZTEST` macros.  Per-test setup and
teardown callbacks can be registered to initialize and reset state:

```c
ZTEST_SUITE(my_suite, NULL, NULL, before_fn, after_fn, NULL);

ZTEST(my_suite, test_something)
{
    zassert_equal(result, expected, "message");
}
```

See `tests/lib/state/src/main.c` for a complete example that exercises
the simple state machine through its full flight sequence.