pytest_notebook.plugin module

pytest plugin configuration.

For more information on writing pytest plugins see:

• https://docs.pytest.org/en/latest/writing_plugins.html

• https://docs.pytest.org/en/latest/reference.html#request

• https://docs.pytest.org/en/latest/example/simple.html

• https://github.com/pytest-dev/cookiecutter-pytest-plugin

• http://doc.pytest.org/en/latest/example/nonpython.html

• https://docs.pytest.org/en/latest/_modules/_pytest/hookspec.html

class pytest_notebook.plugin.JupyterNbCollector(fspath, parent=None, config=None, session=None, nodeid=None)

Bases: _pytest.nodes.File

This class represents a pytest collector object for Jupyter Notebook files.

A collector is associated with a .ipynb file and collects it for testing.

collect()

Collect tests for the notebook.

class pytest_notebook.plugin.JupyterNbTest(name, parent)

Bases: _pytest.nodes.Item

This class represents a pytest test invocation for a Jupyter Notebook file.

reportinfo()

Report location of item.

repr_failure(exc_info)

Handle exception raised by self.runtest().

Parameters

exc_info – see https://docs.pytest.org/en/latest/reference.html#_pytest._code.ExceptionInfo

runtest()

Run the test.

class pytest_notebook.plugin.NotSet

Bases: object

Class to indicate a configuration value was not set.

pytest_notebook.plugin.gather_config_options(pytestconfig)

Gather all options, from command-line and ini file.

Note: command-line set options are prioritised over ini file ones.

pytest_notebook.plugin.nb_regression(pytestconfig)

Fixture to execute a Jupyter Notebook, and test its output is as expected.

pytest_notebook.plugin.pytest_addoption(parser)

Add pytest commandline and configuration file options.

pytest_notebook.plugin.pytest_collect_file(path, parent)

Collect Jupyter notebooks using the specified pytest hook.

pytest_notebook.plugin.pytest_report_header(config)

Add header information for pytest execution.

pytest_notebook.plugin.str2bool(string)

Convert a string representation of truth to True or False.

True values are ‘y’, ‘yes’, ‘t’, ‘true’, ‘on’, and ‘1’; false values are ‘n’, ‘no’, ‘f’, ‘false’, ‘off’, and ‘0’. Raises ValueError if ‘val’ is anything else.

pytest_notebook.plugin.strip_quotes(string)

Strip quotes from string.

pytest_notebook.plugin.validate_diff_replace(pytestconfig)

Extract the nb_diff_replace option from the ini file.

This should be of the format:

nb_diff_replace =
    /cells/*/outputs \d{1,2}/\d{1,2}/\d{2,4} REPLACE_DATE
    /cells/*/outputs "\d{2}:\d{2}:\d{2}" "REPLACE_TIME"