Pytest plugin for detecting inadvertent open file handles
Project description
This package provides a plugin for the pytest framework that allows developers to detect whether any file handles or other file-like objects were inadvertently left open at the end of a unit test. It has been moved from the core astropy project since it is of use more generally.
NOTE: This plugin is not supported with Py2.7 on Win32 platforms.
Motivation
The pytest-openfiles plugin allows for the detection of open I/O resources at the end of unit tests. This is particularly useful for testing code that manipulates file handles or other I/O resources. It allows developers to ensure that this kind of code properly cleans up I/O resources when they are no longer needed.
Installation
The pytest-openfiles plugin can be installed using pip:
$ pip install pytest-openfiles
It is also possible to install the latest development version from the source repository:
$ git clone https://github.com/astropy/pytest-openfiles $ cd pytest-openfiles $ python ./setup.py install
In either case, the plugin will automatically be registered for use with pytest.
Usage
This plugin adds the --open-files option to the pytest command. When running tests with --open-files, if a file is opened during the course of a unit test but that file is not closed before the test finishes, the test will fail.
Development Status
Questions, bug reports, and feature requests can be submitted on github.
License
This plugin is licensed under a 3-clause BSD style license - see the LICENSE.rst file.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
