Closes #4319 - shorten test names (#4321)

* Closes #4319 - shorten test names

* #4319 update docs and config files

CONTRIBUTING.rst

@@ -102,8 +102,8 @@ We use `nox`_ to instrument our tests.
 
 - To test your changes, run unit tests with ``nox``::
 
-    $ nox -f datastore/nox.py -s "unit_tests(python_version='2.7')"
-    $ nox -f datastore/nox.py -s "unit_tests(python_version='3.4')"
+    $ nox -f datastore/nox.py -s "unit(py='2.7')"
+    $ nox -f datastore/nox.py -s "unit(py='3.4')"
     $ ...
 
   .. note::
@@ -118,7 +118,7 @@ We use `nox`_ to instrument our tests.
 
     $ export GIT_ROOT=$(pwd)
     $ cd ${GIT_ROOT}/datastore/
-    $ nox -s "unit_tests(python_version='3.6')"
+    $ nox -s "unit(py='3.6')"
 
 .. nox: https://pypi.org/project/nox-automation/
 
@@ -184,8 +184,8 @@ Running System Tests
 
 - To run system tests for a given package, you can execute::
 
-   $ nox -f datastore/nox.py -s "system_tests(python_version='3.6')"
-   $ nox -f datastore/nox.py -s "system_tests(python_version='2.7')"
+   $ nox -f datastore/nox.py -s "system(py='3.6')"
+   $ nox -f datastore/nox.py -s "system(py='2.7')"
 
   .. note::
 

api_core/nox.py

@@ -19,15 +19,15 @@
 
 
 @nox.session
-@nox.parametrize('python_version', ['2.7', '3.4', '3.5', '3.6'])
-def unit_tests(session, python_version):
+@nox.parametrize('py', ['2.7', '3.4', '3.5', '3.6'])
+def unit(session, py):
     """Run the unit test suite."""
 
     # Run unit tests against all supported versions of Python.
-    session.interpreter = 'python{}'.format(python_version)
+    session.interpreter = 'python{}'.format(py)
 
     # Set the virtualenv dirname.
-    session.virtualenv_dirname = 'unit-' + python_version
+    session.virtualenv_dirname = 'unit-' + py
 
     # Install all test dependencies, then install this package in-place.
     session.install(

appveyor.yml

@@ -14,10 +14,10 @@ environment:
     # iterations.
 
     - PYTHON: "C:\\Python27"
-      NOX_ENV: "unit_tests(python_version='2.7')"
+      NOX_ENV: "unit(py='2.7')"
 
     - PYTHON: "C:\\Python35-x64"
-      NOX_ENV: "unit_tests(python_version='3.5')"
+      NOX_ENV: "unit(py='3.5')"
 
 install:
   - cmd: echo "Filesystem root:"

bigquery/nox.py

@@ -26,15 +26,15 @@
 
 
 @nox.session
-@nox.parametrize('python_version', ['2.7', '3.4', '3.5', '3.6'])
-def unit_tests(session, python_version):
+@nox.parametrize('py', ['2.7', '3.4', '3.5', '3.6'])
+def unit(session, py):
     """Run the unit test suite."""
 
     # Run unit tests against all supported versions of Python.
-    session.interpreter = 'python{}'.format(python_version)
+    session.interpreter = 'python{}'.format(py)
 
     # Set the virtualenv dirname.
-    session.virtualenv_dirname = 'unit-' + python_version
+    session.virtualenv_dirname = 'unit-' + py
 
     # Install all test dependencies, then install this package in-place.
     session.install('mock', 'pytest', 'pytest-cov', *LOCAL_DEPS)
@@ -56,19 +56,19 @@ def unit_tests(session, python_version):
 
 
 @nox.session
-@nox.parametrize('python_version', ['2.7', '3.6'])
-def system_tests(session, python_version):
+@nox.parametrize('py', ['2.7', '3.6'])
+def system(session, py):
     """Run the system test suite."""
 
     # Sanity check: Only run system tests if the environment variable is set.
     if not os.environ.get('GOOGLE_APPLICATION_CREDENTIALS', ''):
         session.skip('Credentials must be set via environment variable.')
 
     # Run the system tests against latest Python 2 and Python 3 only.
-    session.interpreter = 'python{}'.format(python_version)
+    session.interpreter = 'python{}'.format(py)
 
     # Set the virtualenv dirname.
-    session.virtualenv_dirname = 'sys-' + python_version
+    session.virtualenv_dirname = 'sys-' + py
 
     # Install all test dependencies, then install this package into the
     # virtualenv's dist-packages.
@@ -89,19 +89,19 @@ def system_tests(session, python_version):
 
 
 @nox.session
-@nox.parametrize('python_version', ['2.7', '3.6'])
-def snippets_tests(session, python_version):
+@nox.parametrize('py', ['2.7', '3.6'])
+def snippets_tests(session, py):
     """Run the system test suite."""
 
     # Sanity check: Only run system tests if the environment variable is set.
     if not os.environ.get('GOOGLE_APPLICATION_CREDENTIALS', ''):
         session.skip('Credentials must be set via environment variable.')
 
     # Run the system tests against latest Python 2 and Python 3 only.
-    session.interpreter = 'python{}'.format(python_version)
+    session.interpreter = 'python{}'.format(py)
 
     # Set the virtualenv dirname.
-    session.virtualenv_dirname = 'snip-' + python_version
+    session.virtualenv_dirname = 'snip-' + py
 
     # Install all test dependencies, then install this package into the
     # virtualenv's dist-packages.

bigtable/nox.py

@@ -25,15 +25,15 @@
 
 
 @nox.session
-@nox.parametrize('python_version', ['2.7', '3.4', '3.5', '3.6'])
-def unit_tests(session, python_version):
+@nox.parametrize('py', ['2.7', '3.4', '3.5', '3.6'])
+def unit(session, py):
     """Run the unit test suite."""
 
     # Run unit tests against all supported versions of Python.
-    session.interpreter = 'python{}'.format(python_version)
+    session.interpreter = 'python{}'.format(py)
 
     # Set the virtualenv dirname.
-    session.virtualenv_dirname = 'unit-' + python_version
+    session.virtualenv_dirname = 'unit-' + py
 
     # Install all test dependencies, then install this package in-place.
     session.install('mock', 'pytest', 'pytest-cov', *LOCAL_DEPS)
@@ -55,19 +55,19 @@ def unit_tests(session, python_version):
 
 
 @nox.session
-@nox.parametrize('python_version', ['2.7', '3.6'])
-def system_tests(session, python_version):
+@nox.parametrize('py', ['2.7', '3.6'])
+def system(session, py):
     """Run the system test suite."""
 
     # Sanity check: Only run system tests if the environment variable is set.
     if not os.environ.get('GOOGLE_APPLICATION_CREDENTIALS', ''):
         session.skip('Credentials must be set via environment variable.')
 
     # Run the system tests against latest Python 2 and Python 3 only.
-    session.interpreter = 'python{}'.format(python_version)
+    session.interpreter = 'python{}'.format(py)
 
     # Set the virtualenv dirname.
-    session.virtualenv_dirname = 'sys-' + python_version
+    session.virtualenv_dirname = 'sys-' + py
 
     # Install all test dependencies, then install this package into the
     # virtualenv's dist-packages.

core/nox.py

@@ -24,15 +24,15 @@
 
 
 @nox.session
-@nox.parametrize('python_version', ['2.7', '3.4', '3.5', '3.6'])
-def unit_tests(session, python_version):
+@nox.parametrize('py', ['2.7', '3.4', '3.5', '3.6'])
+def unit(session, py):
     """Run the unit test suite."""
 
     # Run unit tests against all supported versions of Python.
-    session.interpreter = 'python{}'.format(python_version)
+    session.interpreter = 'python{}'.format(py)
 
     # Set the virtualenv dirname.
-    session.virtualenv_dirname = 'unit-' + python_version
+    session.virtualenv_dirname = 'unit-' + py
 
     # Install all test dependencies, then install this package in-place.
     session.install(

datastore/nox.py

@@ -26,15 +26,15 @@
 
 
 @nox.session
-@nox.parametrize('python_version', ['2.7', '3.4', '3.5', '3.6'])
-def unit_tests(session, python_version):
+@nox.parametrize('py', ['2.7', '3.4', '3.5', '3.6'])
+def unit(session, py):
     """Run the unit test suite."""
 
     # Run unit tests against all supported versions of Python.
-    session.interpreter = 'python{}'.format(python_version)
+    session.interpreter = 'python{}'.format(py)
 
     # Set the virtualenv dirname.
-    session.virtualenv_dirname = 'unit-' + python_version
+    session.virtualenv_dirname = 'unit-' + py
 
     # Install all test dependencies, then install this package in-place.
     session.install('mock', 'pytest', 'pytest-cov', *LOCAL_DEPS)
@@ -56,19 +56,19 @@ def unit_tests(session, python_version):
 
 
 @nox.session
-@nox.parametrize('python_version', ['2.7', '3.6'])
-def system_tests(session, python_version):
+@nox.parametrize('py', ['2.7', '3.6'])
+def system(session, py):
     """Run the system test suite."""
 
     # Sanity check: Only run system tests if the environment variable is set.
     if not os.environ.get('GOOGLE_APPLICATION_CREDENTIALS', ''):
         session.skip('Credentials must be set via environment variable.')
 
     # Run the system tests against latest Python 2 and Python 3 only.
-    session.interpreter = 'python{}'.format(python_version)
+    session.interpreter = 'python{}'.format(py)
 
     # Set the virtualenv dirname.
-    session.virtualenv_dirname = 'sys-' + python_version
+    session.virtualenv_dirname = 'sys-' + py
 
     # Install all test dependencies, then install this package into the
     # virtualenv's dist-packages.

dns/nox.py

@@ -26,15 +26,15 @@
 
 
 @nox.session
-@nox.parametrize('python_version', ['2.7', '3.4', '3.5', '3.6'])
-def unit_tests(session, python_version):
+@nox.parametrize('py', ['2.7', '3.4', '3.5', '3.6'])
+def unit(session, py):
     """Run the unit test suite."""
 
     # Run unit tests against all supported versions of Python.
-    session.interpreter = 'python{}'.format(python_version)
+    session.interpreter = 'python{}'.format(py)
 
     # Set the virtualenv dirname.
-    session.virtualenv_dirname = 'unit-' + python_version
+    session.virtualenv_dirname = 'unit-' + py
 
     # Install all test dependencies, then install this package in-place.
     session.install('mock', 'pytest', 'pytest-cov', *LOCAL_DEPS)

error_reporting/nox.py

@@ -27,15 +27,15 @@
 
 
 @nox.session
-@nox.parametrize('python_version', ['2.7', '3.4', '3.5', '3.6'])
-def unit_tests(session, python_version):
+@nox.parametrize('py', ['2.7', '3.4', '3.5', '3.6'])
+def unit(session, py):
     """Run the unit test suite."""
 
     # Run unit tests against all supported versions of Python.
-    session.interpreter = 'python{}'.format(python_version)
+    session.interpreter = 'python{}'.format(py)
 
     # Set the virtualenv dirname.
-    session.virtualenv_dirname = 'unit-' + python_version
+    session.virtualenv_dirname = 'unit-' + py
 
     # Install all test dependencies, then install this package in-place.
     session.install('mock', 'pytest', 'pytest-cov', *LOCAL_DEPS)
@@ -83,19 +83,19 @@ def lint_setup_py(session):
 
 
 @nox.session
-@nox.parametrize('python_version', ['2.7', '3.6'])
-def system_tests(session, python_version):
+@nox.parametrize('py', ['2.7', '3.6'])
+def system(session, py):
     """Run the system test suite."""
 
     # Sanity check: Only run system tests if the environment variable is set.
     if not os.environ.get('GOOGLE_APPLICATION_CREDENTIALS', ''):
         session.skip('Credentials must be set via environment variable.')
 
     # Run the system tests against latest Python 2 and Python 3 only.
-    session.interpreter = 'python{}'.format(python_version)
+    session.interpreter = 'python{}'.format(py)
 
     # Set the virtualenv dirname.
-    session.virtualenv_dirname = 'sys-' + python_version
+    session.virtualenv_dirname = 'sys-' + py
 
     # Install all test dependencies, then install this package into the
     # virtualenv's dist-packages.

firestore/nox.py

@@ -27,15 +27,15 @@
 
 
 @nox.session
-@nox.parametrize('python_version', ['2.7', '3.4', '3.5', '3.6'])
-def unit_tests(session, python_version):
+@nox.parametrize('py', ['2.7', '3.4', '3.5', '3.6'])
+def unit(session, py):
     """Run the unit test suite."""
 
     # Run unit tests against all supported versions of Python.
-    session.interpreter = 'python{}'.format(python_version)
+    session.interpreter = 'python{}'.format(py)
 
     # Set the virtualenv dirname.
-    session.virtualenv_dirname = 'unit-' + python_version
+    session.virtualenv_dirname = 'unit-' + py
 
     # Install all test dependencies, then install this package in-place.
     session.install('mock', 'pytest', 'pytest-cov', *LOCAL_DEPS)
@@ -58,18 +58,18 @@ def unit_tests(session, python_version):
 
 
 @nox.session
-@nox.parametrize('python_version', ['2.7', '3.6'])
-def system_tests(session, python_version):
+@nox.parametrize('py', ['2.7', '3.6'])
+def system(session, py):
     """Run the system test suite."""
     # Sanity check: Only run system tests if the environment variable is set.
     if not os.environ.get('FIRESTORE_APPLICATION_CREDENTIALS'):
         session.skip('Credentials must be set via environment variable.')
 
     # Run the system tests against latest Python 2 and Python 3 only.
-    session.interpreter = 'python{}'.format(python_version)
+    session.interpreter = 'python{}'.format(py)
 
     # Set the virtualenv dirname.
-    session.virtualenv_dirname = 'sys-' + python_version
+    session.virtualenv_dirname = 'sys-' + py
 
     # Install all test dependencies, then install this package into the
     # virtualenv's dist-packages.

language/nox.py

@@ -26,15 +26,15 @@
 
 
 @nox.session
-@nox.parametrize('python_version', ['2.7', '3.4', '3.5', '3.6'])
-def unit_tests(session, python_version):
+@nox.parametrize('py', ['2.7', '3.4', '3.5', '3.6'])
+def unit(session, py):
     """Run the unit test suite."""
 
     # Run unit tests against all supported versions of Python.
-    session.interpreter = 'python{}'.format(python_version)
+    session.interpreter = 'python{}'.format(py)
 
     # Set the virtualenv dirname.
-    session.virtualenv_dirname = 'unit-' + python_version
+    session.virtualenv_dirname = 'unit-' + py
 
     # Install all test dependencies, then install this package in-place.
     session.install('mock', 'pytest', 'pytest-cov', *LOCAL_DEPS)
@@ -52,19 +52,19 @@ def unit_tests(session, python_version):
 
 
 @nox.session
-@nox.parametrize('python_version', ['2.7', '3.6'])
-def system_tests(session, python_version):
+@nox.parametrize('py', ['2.7', '3.6'])
+def system(session, py):
     """Run the system test suite."""
 
     # Sanity check: Only run system tests if the environment variable is set.
     if not os.environ.get('GOOGLE_APPLICATION_CREDENTIALS', ''):
         session.skip('Credentials must be set via environment variable.')
 
     # Run the system tests against latest Python 2 and Python 3 only.
-    session.interpreter = 'python{}'.format(python_version)
+    session.interpreter = 'python{}'.format(py)
 
     # Set the virtualenv dirname.
-    session.virtualenv_dirname = 'sys-' + python_version
+    session.virtualenv_dirname = 'sys-' + py
 
     # Install all test dependencies, then install this package into the
     # virtualenv's dist-packages.