Metadata-Version: 2.1
Name: pytest-venv
Version: 0.2.1
Summary: py.test fixture for creating a virtual environment
Home-page: https://github.com/mmerickel/pytest-venv
Author: Michael Merickel
Author-email: michael@merickel.org
License: UNKNOWN
Description: ===========
        pytest-venv
        ===========
        
        .. image:: https://img.shields.io/pypi/v/pytest-venv.svg
            :target: https://pypi.python.org/pypi/pytest-venv
        
        .. image:: https://img.shields.io/travis/mmerickel/pytest-venv.svg
            :target: https://travis-ci.org/mmerickel/pytest-venv
        
        ``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.
        
        Usage
        =====
        
        .. code-block:: python
        
            import os
        
            def test_it(venv):
                venv.install('pyramid', upgrade=True)
                subprocess.check_call(
                    [os.path.join(venv.bin, 'pserve'), 'development.ini'],
                )
        
        API
        ===
        
        The ``venv`` fixture is an instance of
        ``pytest_venv.VirtualEnvironment(path)`` which exposes the following API:
        
        ``path``
        
          The path to the virtualenv directory.
        
        ``bin``
        
          The path to the bin / Scripts directory.
        
        ``python``
        
          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.
        
        ``get_version(pkg_name)``
        
          Returns a ``pkg_resources.Version`` object which is sortable and convertable
          to a string.
        
        
        0.2.1 (2020-08-04)
        ==================
        
        - Depend directly on ``pytest``.
          See https://github.com/mmerickel/pytest-venv/pull/2
        
        - Add support for Python 3.6, 3.7, and 3.8.
          See https://github.com/mmerickel/pytest-venv/pull/2
        
        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.
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: Pytest
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Software Development :: Testing
Provides-Extra: testing
