skip to navigation
skip to content

pytest-venv 0.2

py.test fixture for creating a virtual environment

pytest-venv is a simple pytest plugin that exposes a venv fixture. The fixture is used to create a new virtual environment which can be used to install packages and run commands inside tests.


import os

def test_it(venv):
    venv.install('pyramid', upgrade=True)
        [os.path.join(venv.bin, 'pserve'), 'development.ini'],


The venv fixture is an instance of pytest_venv.VirtualEnvironment(path) which exposes the following API:


The path to the virtualenv directory.


The path to the bin / Scripts directory.


The path to the python executable in the virtualenv.

create(system_site_packages=False, python=None)

Create a virtualenv. This is called automatically by the venv fixture. If python is None then the virtual environment will be created using the same executable as the active runtime.

install(pkg_name, editable=False, upgrade=False)

Use pip to install a package into the virtualenv. pkg_name may be a path to a package on disk.


Returns a pkg_resources.Version object which is sortable and convertable to a string.

0.2 (2016-11-27)

  • Add VirtualEnvironment.get_version for querying versions from installed packages in the virtual environment.
  • Support custom python interpreter paths via VirtualEnvironment.create(python=...).

0.1.1 (2016-11-27)

  • Ensure the virtual environment is started with the same Python executable as the current process.

0.1 (2016-11-27)

  • Initial release.
File Type Py Version Uploaded on Size
pytest-venv-0.2.tar.gz (md5, pgp) Source 2016-11-27 6KB
pytest_venv-0.2-py2.py3-none-any.whl (md5, pgp) Python Wheel py2.py3 2016-11-27 4KB