History

Angus Gratton c7f19e76d7 docs: Move main docs to cover CMake Add "GNU Make build system" doc with "cheat sheet" for moving to new system		2018-05-07 18:45:49 +08:00
..
components/unity	unit-test-app: support multi stages test	2018-03-30 11:38:49 +08:00
configs	unit tests: add psram configuration	2017-11-06 11:23:15 +08:00
main	Revert "Merge branch 'feature/vfs_select' into 'master'"	2018-04-20 11:51:41 +08:00
tools	unit-test-app: support multi stages test	2018-03-30 11:38:49 +08:00
Makefile	build: Fix problems with building kconfig and generating sdkconfig	2018-03-28 10:39:20 +08:00
partition_table_unit_test_app.csv	Add SPIFFS Component to IDF	2017-09-11 19:56:40 +03:00
README.md	docs: Move main docs to cover CMake	2018-05-07 18:45:49 +08:00
sdkconfig.defaults	Enable -Wwrite-strings when compiling IDF's own C files	2018-04-10 08:53:33 +02:00
unit_test.py	unit-test-app: support multi stages test	2018-03-30 11:38:49 +08:00

README.md

Unit Test App

ESP-IDF unit tests are run using Unit Test App. The app can be built with the unit tests for a specific component. Unit tests are in test subdirectories of respective components.

Building Unit Test App

Follow the setup instructions in the top-level esp-idf README.
Set IDF_PATH environment variable to point to the path to the esp-idf top-level directory.
Change into tools/unit-test-app directory
idf.py menuconfig to configure the Unit Test App.
make TEST_COMPONENTS= with TEST_COMPONENTS set to names of the components to be included in the test app. Or make TESTS_ALL=1 to build the test app with all the tests for components having test subdirectory.
Follow the printed instructions to flash, or run make flash.

Running Unit Tests

The unit test loader will prompt by showing a menu of available tests to run:

Type a number to run a single test.
* to run all tests.
[tagname] to run tests with "tag"
![tagname] to run tests without "tag" (![ignore] is very useful as it runs all CI-enabled tests.)
"test name here" to run test with given name