Drop some outdated information from our quick start guide
* Only tox has to be installed via pip, everything else is in virtual environment. Nose is no longer used. * One should NOT run other tox commands in an existing tox environment. This is not how tox is intended to be used, and it cause weird failures or seemingly random virtual environment rebuilds. * Drop statement about running unit tests on a clear VM. Not sure where it comes from, only tox and setuptools are required to run unit tests, and they don't mess with system packages. Only leave note about devstack, as people seem to have problems with it. Change-Id: Ie7d0172b66231cfd8f9c4f8f2d76604a187443b0
This commit is contained in:
parent
8633872daf
commit
3ce0401da0
@ -12,9 +12,9 @@ The gate currently runs the unit tests under both
|
||||
Python 2.7 and Python 3.4. It is strongly encouraged to run the unit tests
|
||||
locally under one, the other, or both prior to submitting a patch.
|
||||
|
||||
.. Note:: The unit test environment setup should be done on a clean installed
|
||||
VM or system. Sharing the environment with devstack testing is not
|
||||
recommended due to conflicting configuration with system dependencies.
|
||||
.. note::
|
||||
Do not run unit tests on the same environment as devstack due to
|
||||
conflicting configuration with system dependencies.
|
||||
|
||||
.. seealso::
|
||||
|
||||
@ -59,10 +59,10 @@ Using Python 3.4:
|
||||
|
||||
sudo dnf install python3-devel
|
||||
|
||||
Install these on all distros::
|
||||
If your distro has at least tox 1.8, use similar command to install
|
||||
``python-tox`` package. Otherwise install this on all distros::
|
||||
|
||||
sudo easy_install nose
|
||||
sudo pip install virtualenv setuptools-git flake8 tox testrepository
|
||||
sudo pip install -U tox
|
||||
|
||||
|
||||
You may need to explicitly upgrade virtualenv if you've installed the one
|
||||
@ -78,16 +78,12 @@ Ironic source code should be pulled directly from git::
|
||||
git clone https://git.openstack.org/openstack/ironic
|
||||
cd ironic
|
||||
|
||||
Set up a local environment for development and testing should be done with tox::
|
||||
Set up a local environment for development and testing should be done with tox,
|
||||
for example::
|
||||
|
||||
# create a virtualenv for development
|
||||
tox -evenv --notest
|
||||
|
||||
Activate the virtual environment whenever you want to work in it.
|
||||
All further commands in this section should be run with the venv active::
|
||||
|
||||
source .tox/venv/bin/activate
|
||||
|
||||
All unit tests should be run using tox. To run Ironic's entire test suite::
|
||||
|
||||
# run all tests (unit under both py27 and py34, and pep8)
|
||||
@ -114,10 +110,6 @@ To run only the pep8/flake8 syntax and style checks::
|
||||
|
||||
tox -epep8
|
||||
|
||||
When you're done, deactivate the virtualenv::
|
||||
|
||||
deactivate
|
||||
|
||||
===============================
|
||||
Exercising the Services Locally
|
||||
===============================
|
||||
|
Loading…
x
Reference in New Issue
Block a user