summaryrefslogtreecommitdiff
path: root/doc/source/development_guidelines.rst
diff options
context:
space:
mode:
Diffstat (limited to 'doc/source/development_guidelines.rst')
-rw-r--r--doc/source/development_guidelines.rst15
1 files changed, 13 insertions, 2 deletions
diff --git a/doc/source/development_guidelines.rst b/doc/source/development_guidelines.rst
index 1da845768..29d9f35a4 100644
--- a/doc/source/development_guidelines.rst
+++ b/doc/source/development_guidelines.rst
@@ -44,13 +44,24 @@ To execute the unit tests:
If you installed using: `cd ~/swift; sudo python setup.py develop`,
you may need to do: `cd ~/swift; sudo chown -R swift:swift swift.egg-info`
prior to running tox.
- If you ever encounter DistributionNotFound, try to use `tox --recreate`
- or removing .tox directory to force tox to recreate the dependency list
* Optionally, run only specific tox builds:
- `tox -e pep8,py27`
+.. note::
+ As of tox version 2.0.0, most environment variables are not automatically
+ passed to the test environment. Swift's tox.ini overrides this default
+ behavior so that variable names matching SWIFT_* and *_proxy will be passed,
+ but you may need to run tox --recreate for this to take effect after
+ upgrading from tox<2.0.0.
+
+ Conversely, if you do not want those environment variables to be passed to
+ the test environment then you will need to unset them before calling tox.
+
+ Also, if you ever encounter DistributionNotFound, try to use `tox --recreate`
+ or remove the .tox directory to force tox to recreate the dependency list.
+
The functional tests may be executed against a :doc:`development_saio` or
other running Swift cluster using the command: