Changelog

0.18.0 (UNRELEASED)

  • ProcessStarter now has attr:terminate_on_interrupt. This flag will make xprocess attempt to terminate and clean up all started process resources upon interruptions during pytest runs (CTRL+C, SIGINT and internal errors) when set to True. It will default to False, so if the described behaviour is desired the flag must be explicitly set True.

  • Add a new popen_kwargs variable to ProcessStarter, this variable can be used for passing keyword values to the subprocess.Popen constructor, giving the user more control over the initialized process.

0.17.1 (2020-02-28)

  • Fix ResourceWarning in XProcess.ensure() caused by not properly waiting on process exit and leaked File handles

0.17.0 (2020-11-26)

  • ProcessStarter now has startup_check(). This method can be optionaly overridden and will be called upon to check process responsiveness after ProcessStarter.pattern is matched. By default, XProcess.ensure() will only attempt to match ProcessStarter.pattern when starting a process, if matched, xprocess will consider the process as ready to answer queries. If startup_check() is provided though, its return value will also be considered to determine if the process has been successfully started. If startup_check() returns True after ProcessStarter.pattern has been matched, XProcess.ensure() will return sucessfully. In contrast, if startup_check() does not return True before timing out, XProcess.ensure() will raise a TimeoutError exception.

  • Remove deprecated xprocess.CompatStarter()

0.16.0 (2020-10-29)

  • ProcessStarter now has a new timeout class variable optionaly overridden to define the maximum time xprocess.ensure() should wait for process output when trying to match ProcessStarter.pattern. Defaults to 120 seconds.

  • The number of lines in the process logfile watched for ProcessStarter.pattern is now configurable and can be changed by setting ProcessStarter.max_read_lines to the desired value. Defaults to 50 lines.

  • Make XProcessInfo.isrunning() ignore zombie processes by default. Pass ignore_zombies=False to get the previous behavior, which was to consider zombie processes as running.

0.15.0 (2020-10-03)

  • pytest-xprocess now uses a sub-directory of .pytest_cache to store process related files.

  • Drop support for Python 2.7

  • Fixed bug when non-ascii characters were written to stdout by external process

  • Removed deprecated XProcessInfo.kill()

0.14.0 (2020-09-24)

  • Now XProcessInfo.terminate will by default also terminate the entire process tree. This is safer as there’s no risk of leaving lingering processes behind. If for some reason you need the previous behavior of only terminating the root process, pass `kill_proc_tree=False to XProcessInfo.terminate.

0.13.1 (2020-01-29)

  • Drop support for Python 2.6 and 3.4.

  • Ignore empty lines in log files when looking for the pattern that indicates a process has started.

0.13.0 (UNRELEASED)

  • Never released due to deploy issues.

0.12.1 (2017-06-07)

  • Fixed example in README.md

0.12.0 (2017-06-06)

  • #3: XProcess.ensure() now accepts preferably a ProcessStarter subclass to define and customize the process startup behavior. Passing a simple function is deprecated and will be removed in a future release.

0.11.1 (2017-05-31)

  • Restored XProcessInfo.kill() as alias for XProcessInfo.terminate() for API compatibility.

0.11 (2017-05-18)

0.10 (2017-05-15)

0.9.1 (2015-07-15)

  • Don’t use __multicall__ in pytest hook

0.9 (2015-07-15)

0.8.0 (2013-10-04)

  • Support python3 (tested on linux/win32)

  • Split out pytest independent process support into xprocess.py

  • Add method:xProcessInfo.kill and some smaller refactoring

  • Fix various windows related Popen / killing details

  • Add tests

0.7.0 (2013-04-05)

  • Initial release