提交 9db70581 编写于 作者: L Lukáš Doktor

docs: Add note about `get_data(..., must_exist=False)`

The `must_exist` is part of the API and significantly changes the way
the datadirs are processed, therefor it deserves to be mentioned in the
documentation.
Signed-off-by: NLukáš Doktor <ldoktor@redhat.com>
上级 d43eb649
...@@ -213,6 +213,9 @@ Avocado looks for data files in the order defined at ...@@ -213,6 +213,9 @@ Avocado looks for data files in the order defined at
from most specific one, to most generic one. That means that, if a variant from most specific one, to most generic one. That means that, if a variant
is being used, the **variant** directory is used first. Then the **test** is being used, the **variant** directory is used first. Then the **test**
level directory is attempted, and finally the **file** level directory. level directory is attempted, and finally the **file** level directory.
Additionally you can use ``get_data(filename, must_exist=False)`` to get
expected location of a possibly non-existing file, which is useful when
you intend to create it.
.. tip:: When running tests you can use the ``--log-test-data-directories`` .. tip:: When running tests you can use the ``--log-test-data-directories``
command line option log the test data directories that will be used command line option log the test data directories that will be used
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册