Fuze™ Test Executive CLI Specification#
Introduction#
The Fuze™ Test Executive CLI (run-atf.py) provides the user-facing command-line interface for executing automated test cycles.
This tool is used by both human testers and CI systems.
Configuration Sources#
The Executive reads parameters from:
local_params.json — Default configuration file.
Command Line Arguments — Override any value from the configuration file.
Command Line Arguments#
- –module
Name of the software module or feature under test. Required.
- –runtype
Type of test run to execute. Example values: INFORMAL, BVT, CI. [Default == INFORMAL].
- –location
Test environment location name. [Default == local].
- –dut
DUT configuration profile name. Specifies the DUT for the test run.
- –testsetup
Test setup profile. Options include RAM, OTP, FLASH. [Default == RAM].
- –moduleversion
Version string of the module under test. Defaults to latest available.
- –project
Project name or identifier. [Default == helloworld].
- –testrunid
Unique identifier string for this test run. Optional.
- –suite
Test suite file to execute (e.g., suite_smoke.json). Required for most executions.
- –skipdutprep
Boolean flag to skip DUT preparation steps before execution.
- –include
Additional test filters or tags to include in the run. Optional.
- –exclude
Test filters or tags to exclude from the run. Optional.
Example Usage#
Run a test suite using config only:
python run-atf.py --module helloworld_app
Override key parameters:
python run-atf.py --module helloworld_app --runtype INFORMAL --location LAB1 --dut stm32_dut --suite suite_regression.json
Override module version:
python run-atf.py --module helloworld_app --moduleversion v1.2.3
Skip DUT prep:
python run-atf.py --module helloworld_app --skipdutprep