parametrize-from-file 0.3.0

Parameterize unit tests with values from YAML, TOML, and NT files.

Parametrizing your tests—in other words, separating the test data from the test code—is frequently a good idea. It makes it easier to add new test cases, while also making it easier to read and understand the test code.

parametrize_from_file provides a convenient way to parametrize tests when using the popular pytest framework. The central idea is to keep the parameters in their own files, separate from the test code. This prevents long lists of parameters from dwarfing your test code, and often allows parameters to be specified more clearly and succinctly than would be possible in python. Below is the basic workflow that this package enables:

• Write test cases in a JSON, YAML, TOML, or NestedText file:

  # test_misc.yml
  test_addition:
    - a: 1
      b: 2
      c: 3

• Decorate the corresponding test functions with parametrize_from_file:

  # test_misc.py
  import parametrize_from_file
  
  @parametrize_from_file
  def test_addition(a, b, c):
      assert a + b == c

• Run pytest as usual:

  $ pytest