summaryrefslogtreecommitdiff
path: root/CONTRIBUTING.rst
diff options
context:
space:
mode:
authorDeepaJon <deepak.kumar@nectechnologies.in>2016-05-02 15:32:25 +0530
committerDeepaJon <deepak.kumar@nectechnologies.in>2016-05-04 15:48:55 +0530
commit6539445f014b4efc0baf29fa2169d2084010cbbb (patch)
tree0d45fc68a1565975602df9d40855dd65f6fa59e0 /CONTRIBUTING.rst
parenta3b3fcbd7dd01b51dbaea12993c177e6ca6a1b5a (diff)
downloadtrove-6539445f014b4efc0baf29fa2169d2084010cbbb.tar.gz
Update Trove's README
Updated the README.rst, In which updated about trove, getting started, python client for trove and reference, Removed the Usage for integration testing Tests and moved into CONTRIBUTION.rst Taken reference from other component's README.rst file. Change-Id: Ic3ce38155ecb120fc6fde1098fabb60be5383a64 Closes-Bug: #1572224
Diffstat (limited to 'CONTRIBUTING.rst')
-rw-r--r--CONTRIBUTING.rst51
1 files changed, 51 insertions, 0 deletions
diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
index 94b2257c..66791a5b 100644
--- a/CONTRIBUTING.rst
+++ b/CONTRIBUTING.rst
@@ -144,3 +144,54 @@ tox will use the `openstack-doc-tools package
<https://github.com/openstack/openstack-doc-tools>`_ for execution of
these tests. openstack-doc-tools has a requirement on maven for the
build check.
+
+Usage for integration testing
+-----------------------------
+
+If you'd like to start up a fake Trove API daemon for integration testing
+with your own tool, run:
+
+.. code-block:: bash
+
+ $ ./tools/start-fake-mode.sh
+
+Stop the server with:
+
+.. code-block:: bash
+
+ $ ./tools/stop-fake-mode.sh
+
+Tests
+-----
+
+To run all tests and PEP8, run tox, like so:
+
+.. code-block:: bash
+
+ $ tox
+
+To run just the tests for Python 2.7, run:
+
+.. code-block:: bash
+
+ $ tox -epy27
+
+To run just PEP8, run:
+
+.. code-block:: bash
+
+ $ tox -epep8
+
+To generate a coverage report,run:
+
+.. code-block:: bash
+
+ $ tox -ecover
+
+(note: on some boxes, the results may not be accurate unless you run it twice)
+
+If you want to run only the tests in one file you can use testtools e.g.
+
+.. code-block:: bash
+
+ $ python -m testtools.run trove.tests.unittests.python.module.path