Skip to content

shawnbrown/pytest-datatest

Repository files navigation

pytest-datatest

Travis CI Build Status MIT License

The development version of datatest's pytest integration.

Typically, only developers working on datatest's pytest plugin should install this package. Other users are encouraged to install just datatest—this plugin comes bundled with it.

Minimum Requirements

Installation

For Developers

Clone the git repositories and use pip to perform an editable install from the cloned project directory:

git clone git@github.com:shawnbrown/datatest.git
git clone git@github.com:shawnbrown/pytest-datatest.git
pip install --editable ./datatest
pip install --no-deps --editable ./pytest-datatest

For Users Without Special Requirements

Don't install this package—install datatest instead:

pip install datatest

For Users With Special Requirements

If you need bug-fixes or features that are not yet available from the main datatest project, you can install "pytest-datatest" via pip from PyPI:

pip install pytest-datatest

And if the version on PyPI isn't new enough for your needs, you can install the plugin directly from the live GitHub repository. But be warned, the live development version is a work in progress and you should use it with care:

pip install --upgrade https://github.com/shawnbrown/pytest-datatest/archive/master.zip

Usage

When installed, this development version automatically overrides datatest's bundled pytest integration. If you want to revert back to the bundled plugin, simply uninstall this version.

To disable the development version (and temporarily enable the bundled version) use:

pytest -p no:datatest_devel

To disable both the development and bundled versions use:

pytest -p no:datatest_devel -p no:datatest

Features

  • Provides a 'mandatory' marker to support incremental testing.
  • Provides an '--ignore-mandatory' command line option to override the default 'mandatory' behavior.
  • Strips the leading "E " prefix from ValidationError differences to help users more easily repurpose parts of the error message for allowed([...]) definitions.

License

Distributed under the terms of the MIT license, "pytest-datatest" is free and open source software.

Issues

If you encounter any problems, please file an issue along with a detailed description.