pio-test

Run unit tests for PlatformIO projects

TLDR

Run unit tests

$ pio test

Run tests for specific environment

$ pio test -e [native]

Run specific test

$ pio test -f [test_example]

Run tests with verbose output

$ pio test -v

SYNOPSIS

pio test [options]

DESCRIPTION

pio test runs unit tests for PlatformIO projects. Supports both native (desktop) and embedded testing. Uses Unity test framework by default. Tests can run on actual hardware or simulators.

PARAMETERS

-e, --environment name

Test environment.

-f, --filter pattern

Test filter pattern.

-i, --ignore pattern

Ignore tests matching pattern.

--upload-port port

Upload port for device tests.

--test-port port

Serial/UART port used as communication interface for tests.

-d, --project-dir path

Specify project directory path.

-c, --project-conf file

Use a custom platformio.ini file.

-v, --verbose

Verbose output (repeat for more: -vv, -vvv).

--without-building

Skip the build stage.

--without-uploading

Skip the upload stage.

--without-testing

Skip the test stage.

--list-tests

List tests without running them.

--json-output

Return output in JSON format.

--junit-output-path file

Generate a JUnit XML report at the given path.