Merge pull request #713 from psafont/tox_args

feature: allow users to run specific tests using tox

Author: stain

README.rst

@@ -7,16 +7,16 @@ CWL conformance tests: |Conformance Status| |Linux Status| |Windows Status| |Cov
 
 .. |Conformance Status| image:: https://ci.commonwl.org/buildStatus/icon?job=cwltool-conformance
    :target: https://ci.commonwl.org/job/cwltool-conformance/
-   
+
 .. |Linux Status| image:: https://img.shields.io/travis/common-workflow-language/cwltool/master.svg?label=Linux%20builds
    :target: https://travis-ci.org/common-workflow-language/cwltool
-   
+
 .. |Windows Status| image:: https://img.shields.io/appveyor/ci/mr-c/cwltool/master.svg?label=Windows%20builds
    :target: https://ci.appveyor.com/project/mr-c/cwltool
 
 .. |Coverage Status| image:: https://img.shields.io/codecov/c/github/common-workflow-language/cwltool.svg
   :target: https://codecov.io/gh/common-workflow-language/cwltool
-   
+
 This is the reference implementation of the Common Workflow Language.  It is
 intended to feature complete and provide comprehensive validation of CWL
 files as well as provide other tools related to working with CWL.
@@ -88,6 +88,8 @@ List of all environment can be seen using:
 ``tox --listenvs``
 and running a specfic test env using:
 ``tox -e <env name>``
+and additionally run a specific test using this format:
+``tox -e py36-unit -- tests/test_examples.py::TestParamMatching``
 
 -  Running the entire suite of CWL conformance tests:
 
@@ -139,8 +141,8 @@ Run `cwltool` just as you normally would, but with the new option, e.g. from the
 .. code:: bash
 
   cwltool --user-space-docker-cmd=udocker https://raw.githubusercontent.com/common-workflow-language/common-workflow-language/master/v1.0/v1.0/test-cwl-out2.cwl https://github.com/common-workflow-language/common-workflow-language/blob/master/v1.0/v1.0/empty.json
-  
-or 
+
+or
 
 .. code:: bash
 

tox.ini

@@ -24,7 +24,7 @@ deps =
   py{27,34,35,36}-lint: flake8
 
 commands =
-  py{27,34,35,36}-unit: python setup.py test --addopts "--cov-report xml --cov cwltool"
+  py{27,34,35,36}-unit: python setup.py test --addopts "--cov-report xml --cov cwltool {posargs}"
   py{27,34,35,36}-unit: codecov
   py{27,34,35,36}-lint: flake8 schema_salad setup.py