Parametrize From File
.. image:: https://img.shields.io/pypi/v/parametrize_from_file.svg :target: https://pypi.python.org/pypi/parametrize_from_file
.. image:: https://img.shields.io/pypi/pyversions/parametrize_from_file.svg :target: https://pypi.python.org/pypi/parametrize_from_file
.. image:: https://img.shields.io/readthedocs/parametrize_from_file.svg :target: https://parametrize-from-file.readthedocs.io/
.. image:: https://img.shields.io/github/actions/workflow/status/kalekundert/parametrize_from_file/test.yml?branch=master :target: https://github.com/kalekundert/parametrize_from_file/actions
.. image:: https://img.shields.io/coveralls/kalekundert/parametrize_from_file.svg :target: https://coveralls.io/github/kalekundert/parametrize_from_file?branch=master
.. image:: https://img.shields.io/github/last-commit/kalekundert/parametrize_from_file?logo=github :target: https://github.com/kalekundert/parametrize_from_file
Parametrize From File is a library for reading unit test parameters from config files. It works with the pytest_ framework. Below is the basic workflow that this package enables:
Write test cases in a JSON, YAML, TOML, or NestedText file:
.. code-block:: yaml
test_str_find:
str: sir lancelot sub: lance loc: 4
str: sir robin sub: brave loc: -1
Decorate the corresponding test functions with @parametrize_from_file:
.. code-block:: py
import parametrize_from_file
@parametrize_from_file def test_str_find(str, sub, loc): assert str.find(sub) == loc
Run pytest_ as usual::
============================= test session starts ============================== platform linux -- Python 3.10.0, pytest-7.4.0, pluggy-1.2.0 rootdir: /home/arthur/holy_grail collected 2 items
test_camelot.py .. [100%]
============================== 2 passed in 0.09s ===============================
Refer to the online documentation <https://parametrize-from-file.rtfd.io>_
for more information.
.. _pytest: https://docs.pytest.org/en/stable/getting-started.html .. _JSON: https://www.json.org/json-en.html .. _YAML: https://yaml.org/ .. _TOML: https://toml.io/en/ .. _NestedText: https://nestedtext.org/en/latest/