Skip to main content

pytest plugin for testing executables

Project description Read The Docs Status Travis-CI Build Status Codecov coverage report

pytest-executable is a pytest plugin for simplifying the black-box testing of an executable, be it written in python or not. It helps to avoid writing the boilerplate test code to:

  • define the settings of a test case in a yaml file,

  • spawn a subprocess for running an executable,

  • reorder the tests properly either for a single test case or across several test cases,

  • handle the outputs and references directory trees,

  • provide convenient fixtures to customize the checking of the outcome of an executable.

It integrates naturally with standard test scripts written for pytest.

This plugin is originally intended for testing executables that create scientific data but it may hopefully be helpful for other kinds of executables. This project is still young, but already used in a professional environment.


The project documentation and installation instructions are available online.


A contributing guide will be soon available (just a matter of free time).

Please fill an issue on the Github issue tracker for any bug report, feature request or question.


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-executable-0.5.5.tar.gz (54.3 kB view hashes)

Uploaded source

Built Distribution

pytest_executable-0.5.5-py3-none-any.whl (25.3 kB view hashes)

Uploaded 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