Fixed build issue, improved docs.

Author: todofixthis

.travis.yml

@@ -4,7 +4,9 @@ python:
   - '2.7'
   - '3.5'
   - '3.6'
-install: pip install .
+install:
+  - pip install .
+  - pip install docutils # Used to check package metadata.
 script:
   - python setup.py check --strict --metadata --restructuredtext
   - nosetests

README.rst

@@ -58,10 +58,17 @@ To run unit tests after installing from source::
 
   python setup.py test
 
-PyOTA is also compatible with `tox`_::
+PyOTA is also compatible with `tox`_, which will run the unit tests in different
+virtual environments (one for each supported version of Python).
 
-  pip install tox
-  tox
+To run the unit tests, it is recommended that you use the `detox`_ library.
+detox speeds up the tests by running them in parallel.
+
+Install PyOTA with the ``test-runner`` extra to set up the necessary
+dependencies, and then you can run the tests with the ``detox`` command::
+
+  pip install -e .[test-runner]
+  detox -v
 
 =============
 Documentation
@@ -95,5 +102,6 @@ can also build the documentation locally:
 .. _ReadTheDocs: https://pyota.readthedocs.io/
 .. _Slack: https://slack.iota.org/
 .. _dedicated forum: https://forum.iota.org/
+.. _detox: https://pypi.python.org/pypi/detox
 .. _official API: https://iota.readme.io/
 .. _tox: https://tox.readthedocs.io/

setup.py

@@ -67,6 +67,7 @@
   extras_require = {
     'ccurl': ['pyota-ccurl'],
     'docs-builder': ['sphinx', 'sphinx_rtd_theme'],
+    'test-runner': ['detox'],
   },
 
   test_suite    = 'test',