This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

pytest plugin to manage external processes across test runs

Project Description

Experimental py.test plugin for managing processes across test runs.

Usage

install via:

pip install pytest-xprocess

This will provide a xprocess fixture which helps you to ensure that one ore more longer-running processes are present for your tests. You can use it to start and pre-configure test-specific databases (Postgres, Couchdb, …).

Additionally there are two new command line options:

--xkill  # terminates all external processes
--xshow  # shows currently running processes and log files

xprocess fixture usage

You typically define a project-specific fixture which uses the xprocess fixture internally:

# content of conftest.py

import pytest

@pytest.fixture
def myserver(xprocess):
    def preparefunc(cwd):
        return ("PATTERN", [subprocess args])

    logfile = xprocess.ensure("myserver", preparefunc)
    conn = # create a connection or url/port info to the server
    return conn

The xprocess.ensure function takes a name for the external process because you can have multiple external processes.

The preparefunc is a function which gets the current working directory and returns a (PATTERN, args, env) tuple. If the server has not yet been started:

  • the returned args are used to perform a subprocess invocation with environment env (a mapping) and redirect its stdout to a new logfile
  • the PATTERN is waited for in the logfile before returning. It should thus match a state of your server where it is ready to answer queries.
  • the logfile is returned pointing to the line right after the match

else, if the server is already running simply the logfile is returned.

To inherit the main test process environment, return None for env, or omit it and return just (PATTERN, args) from the preparefunc.

Note that the plugin needs to persist the process ID and logfile information. It does this in a sub directory of the directory which contains a pytest.ini or setup.py file.

Release History

Release History

This version
History Node

0.11

History Node

0.10

History Node

0.9.1

History Node

0.9

History Node

0.8

History Node

0.7

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
pytest_xprocess-0.11-py2.py3-none-any.whl (7.0 kB) Copy SHA256 Checksum SHA256 3.6 Wheel May 18, 2017
pytest-xprocess-0.11.tar.gz (10.6 kB) Copy SHA256 Checksum SHA256 Source May 18, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting