From eee9e2834079439ce451c64e4ae2dfbfe6d1fccb Mon Sep 17 00:00:00 2001
From: Phil Dawson <phil.dawson@codethink.co.uk>
Date: Thu, 14 Feb 2019 11:48:14 +0000
Subject: tox.ini: Add 'venv' environment to run arbitrary commands in a venv

This is a handy way for developers to make use of the venvs we're
constructing for our test suite to run in.
---
 CONTRIBUTING.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

(limited to 'CONTRIBUTING.rst')

diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
index 6a3fbf05f..c7ab1b8ab 100644
--- a/CONTRIBUTING.rst
+++ b/CONTRIBUTING.rst
@@ -1589,6 +1589,15 @@ can run ``tox`` with ``-r`` or  ``--recreate`` option.
 
      ./setup.py test --addopts 'tests/frontend/buildtrack.py::test_build_track'
 
+.. tip::
+
+   We also have an environment called 'venv' which takes any arguments
+   you give it and runs them inside the same virtualenv we use for our
+   tests::
+
+     tox -e venv -- <your command(s) here>
+     
+   Any commands after ``--`` will be run a virtualenv managed by tox.
 
 Observing coverage
 ~~~~~~~~~~~~~~~~~~
-- 
cgit v1.2.1