West: Add west robot command

Introduce `robot` command for running Robot Framework test suites.
Initial implementation consists of one runner dedicated for renode-test,
which is a Renode wrapper for running Robot tests.

Signed-off-by: Michał Szprejda <mszprejda@antmicro.com>
This commit is contained in:
Michał Szprejda 2024-03-07 10:35:06 +01:00 committed by Alberto Escolar
commit 7c084b6649
12 changed files with 168 additions and 4 deletions

View file

@ -698,6 +698,44 @@ determined by the imported subclasses of ``ZephyrBinaryRunner``.
runner implementations are in other submodules, such as ``runners.nrfjprog``,
``runners.openocd``, etc.
Running Robot Framework tests: ``west robot``
*********************************************
.. tip:: Run ``west robot -h`` for additional help.
Basics
======
Currently the command supports only one runner which is using ``renode-test``,
(essentially a wrapper for running Robot tests in Renode), but can be
easily extended by adding other runners.
From a Zephyr build directory, to run a Robot test suite::
west robot --runner=renode-robot --testsuite path/to/testsuite.robot
This will run all tests from testsuite.robot and print output provided
by Robot Framework.
To pass additional parameters to Renode use ``--renode-robot-args`` switch.
For example to show Renode logs in addition to Robot Framework's output:
west robot --runner=renode-robot --testsuite path/to/testsuite.robot --renode-robot-arg="--show-log"
Runner-Specific Overrides
=========================
To view all of the available options for the Robot runners your board
supports, as well as their usage information, use ``--context`` (or
``-H``)::
west robot --runner=renode-robot --context
To view all available options "renode-test" runner supports, use::
west robot --runner=renode-robot --renode-robot-help
Simulating a board with: ``west simulate``
******************************************