Skip to main content

Pytest fixtures providing data read from function, module or package related (x)files.

Project description

Each test function deserves a companion - a small or large (YAML, JSON or other) file sitting beside.

Providing such data can be as simple as:

"""Test Romeo y Julieta by Shakespeare.

def test_romeo(function_yaml):

def test_julieta(function_yaml):

def test_play(module_yaml):

def test_author(package_yaml):

Run the test:

$ pytest -sv tests/shakespeare/
============================= test session starts ==============================

tests/shakespeare/ {'name': 'Romeo', 'mindmap': ['Julieta', 'Julieta', 'Julieta'], 'spot': 'ladder'}
tests/shakespeare/ {'name': 'Julieta', 'mindmap': ['Romeo', 'Romeo', 'Romeo'], 'spot': 'balcony'}
tests/shakespeare/ {'story': 'Romeo y Julieta', 'main_characters': ['Romeo', 'Julieta'], 'location': 'Verona'}
tests/shakespeare/ {'name': 'William', 'surname': 'Shakespeare'}

=========================== 4 passed in 0.03 seconds ===========================

Where are the files?

$ ls tests/shakespeare/test_romeoyjulieta.*

and one more (for the whole package tests.shakespeare):

$ ls tests/shakespeare/__init__.yaml

File formats supported

The sample above shows use of YAML formatted data. Out of the box, JSON format is also supported via function_json, module_json and package_json fixtures.

More formats can be supported (see below).

The function, the module and the package

The file tests/shakespeare/ defines a test package.

The file tests/shakespeare/test_romeoyjulieta is a test module

The def test_romeo as in:

def test_romeo(function_yaml):

defines a test function.

Currently there is no notion of test class as I did not need it. It may appear later on.

Names of data files

Data file names are derived from related object (package, module, function) and use format specific extensions (.json, .yaml, special ._x_, other can be added).

Package data file has name with extension changed to format specific one, e.g. __init__.json.

Module data file has name such as with extension changed to format specific one, e.g. test_romeoyjulieta.json.

In case of test function, test function name must be added. To make files more readable, the test_ part of the function is removed. For test_romeo function can be e.g. test_romeoyjulieta.romeo.json.

The files are typically in the same directory as relevant python test suite code.

What are the ._x_ files?

There are special fixtures function_xfile, module_xfile and package_xfile, which only return path to a file with extension ._x_ (and do not attempt to load the content).

The ._x_ files are used as base for implementing other fixtures, e.g. as for JSON:

def function_json(function_xfile):
    path = function_xfile.with_suffix(".json")
    with"utf-8") as f:
        import json
        return json.load(f)

As shown, the function_json simply takes the ._x_ file path, replaces the extension with it’s own .json and returns data loaded from such file.

Adding support for other data formats (e.g. CSV)

Following the function_json example above, we may load data from any other data file, e.g. for .csv:

from csv import reader

import pytest

def function_csv(function_xfile):
    path = function_xfile.with_suffix(".csv")
    with"utf-8") as f:
        return list(reader(f))

def test_codes(function_csv):

Creating fixtures based on provided data

It is easy to take any of data availalbe and use it to create object of your preference. E.g. assuming that the package_yaml returns information about author in form of dictionary with keys “name” and “surname”, one can create fixture classy_author returning specific class instance. Put following into

class Author(object):
    def __init__(self, name, surname): = name
        self.surname = surname

    def full_name(self):
        return "{} {self.surname}".format(self=self)

def classy_author(package_yaml):
    return Author(package_yaml["name"], package_yaml["surname"])

and use it from test

def test_custom_fixture(classy_author):

Fixtures provided

Here is summary of fixtures provided. In all cases we assume we have tests/sub/ with a test function test_fun and all required data files are available.

{scope}_xfile family

Each fixture provides path to a file with base name derived from current function, module or package and with an extension “._x_”:

  • function_xfile: tests/sub/test_thing.test_fun._x_

  • module_xfile: tests/sub/test_thing._x_

  • package_xfile: tests/sub/__init__._x_

{scope}_json family

Fixtures provide data loaded from the JSON formatted files:

  • function_json: tests/sub/test_thing.test_fun.json

  • module_json: tests/sub/test_thing.json

  • package_json: tests/sub/__init__.json

{scope}_yaml family

Fixtures provide data loaded from the YAML formatted files:

  • function_yaml: tests/sub/test_thing.test_fun.yaml

  • module_yaml: tests/sub/test_thing.yaml

  • package_yaml: tests/sub/__init__.yaml

Note on YAML package and YAML version

Switched from pyyaml to ruamel.yaml as it supports YAML version 1.2.

If you require YAML files using version 1.1, use % YAML 1.1 in your YAML file.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pytest_xfiles-0.2.0.tar.gz (7.1 kB view hashes)

Uploaded source

Built Distribution

pytest_xfiles-0.2.0-py2.py3-none-any.whl (7.7 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page