Skip to content

Commit 16fe200

Browse files
author
Vasileios Karakasis
committed
Update docs
1 parent a55e84d commit 16fe200

File tree

1 file changed

+8
-2
lines changed

1 file changed

+8
-2
lines changed

docs/manpage.rst

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -484,6 +484,10 @@ Options controlling ReFrame execution
484484

485485
Set variable ``VAR`` in all tests or optionally only in test ``TEST`` to ``VAL``.
486486

487+
``TEST`` can have the form ``[TEST.][FIXT.]*``, in which case ``VAR`` will be set in fixture ``FIXT`` of ``TEST``.
488+
Note that this syntax is recursive on fixtures, so that a variable can be set in a fixture arbitrarily deep.
489+
``TEST`` prefix refers to the test class name, *not* the test name, but ``FIXT`` refers to the fixture name *inside* the referenced test.
490+
487491
Multiple variables can be set at the same time by passing this option multiple times.
488492
This option *cannot* change arbitrary test attributes, but only test variables declared with the :attr:`~reframe.core.pipeline.RegressionMixin.variable` built-in.
489493
If an attempt is made to change an inexistent variable or a test parameter, a warning will be issued.
@@ -511,8 +515,6 @@ Options controlling ReFrame execution
511515
Conversions to arbitrary objects are also supported.
512516
See :class:`~reframe.utility.typecheck.ConvertibleType` for more details.
513517

514-
The optional ``TEST.`` prefix refers to the test class name, *not* the test name.
515-
516518
Variable assignments passed from the command line happen *before* the test is instantiated and is the exact equivalent of assigning a new value to the variable *at the end* of the test class body.
517519
This has a number of implications that users of this feature should be aware of:
518520

@@ -561,6 +563,10 @@ Options controlling ReFrame execution
561563

562564
Proper handling of boolean variables.
563565

566+
.. versionchanged:: 3.11.1
567+
568+
Allow setting variables in fixtures.
569+
564570

565571
.. option:: --skip-performance-check
566572

0 commit comments

Comments
 (0)