---
syntax: markdown
tags: [tldr, common]
source: https://github.com/tldr-pages/tldr.git
---
# pio test

> Run local tests on a PlatformIO project.
> More information: <https://docs.platformio.org/en/latest/core/userguide/cmd_test.html>.

- Run all tests in all environments of the current PlatformIO project:

`pio test`

- Test only specific environments:

`pio test --environment {{environment1}} --environment {{environment2}}`

- Run only tests whose name matches a specific glob pattern:

`pio test --filter "{{pattern}}"`

- Ignore tests whose name matches a specific glob pattern:

`pio test --ignore "{{pattern}}"`

- Specify a port for firmware uploading:

`pio test --upload-port {{upload_port}}`

- Specify a custom configuration file for running the tests:

`pio test --project-conf {{path/to/platformio.ini}}`
