From f9d76fd7c237087c9ac7ac19e07e581b2930fbbf Mon Sep 17 00:00:00 2001 From: Chris Dearborn Date: Wed, 27 May 2015 09:40:37 -0400 Subject: [PATCH] Add additional required RPMs to dev instructions Changed dev quick start instructions to include installing gcc and python3-devel as these are required to be present on (at least) Fedora 21 server. Change-Id: I576231cc3ecfda6407279b0326dbe54a408a64e0 --- doc/source/dev/dev-quickstart.rst | 29 ++++++++++++++++++++++++++--- 1 file changed, 26 insertions(+), 3 deletions(-) diff --git a/doc/source/dev/dev-quickstart.rst b/doc/source/dev/dev-quickstart.rst index 7fbad11aaa..9061fed9a7 100644 --- a/doc/source/dev/dev-quickstart.rst +++ b/doc/source/dev/dev-quickstart.rst @@ -8,11 +8,15 @@ This is a quick walkthrough to get you started developing code for Ironic. This assumes you are already familiar with submitting code reviews to an OpenStack project. +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. + .. seealso:: http://docs.openstack.org/infra/manual/developers.html#development-workflow -Install prerequisites: +Install prerequisites (for python 2.7): - Ubuntu/Debian:: @@ -20,7 +24,7 @@ Install prerequisites: - Fedora/RHEL7:: - sudo yum install python-devel openssl-devel python-pip mysql-devel libxml2-devel libxslt-devel postgresql-devel git git-review libffi-devel gettext ipmitool psmisc graphviz + sudo yum install python-devel openssl-devel python-pip mysql-devel libxml2-devel libxslt-devel postgresql-devel git git-review libffi-devel gettext ipmitool psmisc graphviz gcc If using RHEL and yum reports "No package python-pip available" and "No package git-review available", use the EPEL software repository. @@ -34,6 +38,15 @@ Install prerequisites: on openSUSE or SLE 12, see ``_. + +Using Python 3.4: + + Follow the instructions above to install prerequisites and on: + + - Fedora:: + + sudo yum install python3-devel + Install these on all distros:: sudo easy_install nose @@ -65,9 +78,19 @@ All further commands in this section should be run with the venv active:: All unit tests should be run using tox. To run Ironic's entire test suite:: - # run all tests (unit and pep8) + # run all tests (unit under both py27 and py34, and pep8) tox +To run the unit tests under py27 and also run the pep8 tests:: + + # run all tests (unit under py27 and pep8) + tox -epy27 -epep8 + +To run the unit tests under py34 and also run the pep8 tests:: + + # run all tests (unit under py34 and pep8) + tox -epy34 -epep8 + To run a specific test, use a positional argument for the unit tests:: # run a specific test for Python 2.7