Swap out tox for nox

Author: anselor

.appveyor.yml

@@ -7,12 +7,12 @@ environment:
     - PYTHON: "C:\\Miniconda36-x64"
       PYTHON_VERSION: "3.6.x"
       PYTHON_ARCH: "64"
-      TOXENV: "py36"
+      NOXSESSION: "tests-3.6"
 
     - PYTHON: "C:\\Miniconda37-x64"
       PYTHON_VERSION: "3.7.x"
       PYTHON_ARCH: "64"
-      TOXENV: "py37"
+      NOXSESSION: "tests-3.7"
 
 init:
   - "%PYTHON%/python -V"
@@ -30,10 +30,10 @@ install:
   # Update conda stuff to make sure pip, setuptools, wheel etc are up to date
   - "conda update --all -y"
 
-  # Install tox
-  - "python -m pip install --upgrade tox"
+  # Install nox
+  - "python -m pip install --upgrade nox"
 
 
 
 test_script:
-- "tox -e %TOXENV%"
+- "nox --non-interactive --session %NOXSESSION%"

.gitignore

@@ -7,6 +7,7 @@ cmd2.egg-info
 .cache
 *.pyc
 .tox
+.nox
 .pytest_cache
 
 # Code Coverage

.travis.yml

@@ -4,25 +4,25 @@ matrix:
     include:
         - os: linux
           python: 3.5
-          env: TOXENV=py35
+          env: NOXSESSION=tests-3.5
         - os: linux
           python: 3.6
-          env: TOXENV=py36
+          env: NOXSESSION=tests-3.6
         - os: linux
           python: 3.7
           dist: xenial
-          env: TOXENV=py37
+          env: NOXSESSION=tests-3.7
         - os: linux
           python: 3.8
           dist: xenial
-          env: TOXENV=py38
+          env: NOXSESSION=tests-3.8
         - os: linux
           python: 3.9-dev
           dist: xenial
-          env: TOXENV=py39
+          env: NOXSESSION=tests-3.9
         - os: linux
           python: 3.7
-          env: TOXENV=docs
+          env: NOXSESSION=docs
 #        # Warning: Don't try to use code coverage analysis with pypy as it is insanely slow
 #        - os: linux
 #          python: pypy3
@@ -35,7 +35,7 @@ matrix:
 #            - BREW_INSTALL=python3
 
 install:
-  - pip install flake8 tox
+  - pip install flake8 nox
 #  - |
 #    if [[ $TRAVIS_OS_NAME == 'osx' ]]; then
 #      if [[ -n "$BREW_INSTALL" ]]; then
@@ -47,9 +47,9 @@ install:
 before_script:
   # stop the build if there are Python syntax errors or undefined names
   # exit-zero treats all errors as warnings.  The GitHub editor is 127 chars wide
-  if [[ $TOXENV == py38 ]]; then
+  if [[ $NOXSESSION == tests-3.8 ]]; then
     flake8 . --count --ignore=E252,W503 --max-complexity=26 --max-line-length=127 --show-source --statistics ;
   fi
 
 script:
-  - tox
+  - echo "$NOXSESSION"; nox --non-interactive --session "$NOXSESSION"

MANIFEST.in

@@ -1,4 +1,4 @@
-include LICENSE README.md CHANGELOG.md CONTRIBUTING.md tox.ini Pipfile
+include LICENSE README.md CHANGELOG.md CONTRIBUTING.md tox.ini noxfile.py Pipfile
 recursive-include examples *
 recursive-include tests *
 recursive-include docs *

azure-pipelines.yml

@@ -16,16 +16,16 @@ jobs:
     matrix:
       Python35:
         python.version: '3.5'
-        TOXENV: 'py35'
+        NOXSESSION: 'tests-3.5'
       Python36:
         python.version: '3.6'
-        TOXENV: 'py36'
+        NOXSESSION: 'tests-3.6'
       Python37:
         python.version: '3.7'
-        TOXENV: 'py37'
+        NOXSESSION: 'tests-3.7'
       Python38:
         python.version: '3.8'
-        TOXENV: 'py38'
+        NOXSESSION: 'tests-3.8'
     # Increase the maxParallel value to simultaneously run the job for all versions in the matrix (max 10 for free open-source)
     maxParallel: 4
 
@@ -38,15 +38,15 @@ jobs:
 
     # Install dependencies - install specific PyPI packages with pip, including cmd2 dependencies
   - script: |
-      python -m pip install --upgrade pip && pip3 install --upgrade setuptools tox
+      python -m pip install --upgrade pip && pip3 install --upgrade setuptools nox
     displayName: 'Upgrade pip and setuptools'
     continueOnError: false
 
     # TODO: Consider adding a lint test to use pycodestyle, flake8, or pylint, to check code style conventions
 
     # Test - test with pytest, collect coverage metrics with pytest-cov, and publish these metrics to codecov.io
   - script: |
-      tox -e $(TOXENV)
+      nox --non-interactive --session $(NOXSESSION)
     displayName: 'Run tests and code coverage'
     continueOnError: false
 

noxfile.py

@@ -0,0 +1,18 @@
+import nox
+
+
+@nox.session(python=['3.7'])
+def docs(session):
+    session.install('sphinx', 'sphinx-rtd-theme', '.')
+    session.chdir('docs')
+    tmpdir = session.create_tmp()
+
+    session.run('sphinx-build', '-a', '-W', '-T', '-b', 'html',
+                '-d', '{}/doctrees'.format(tmpdir), '.', '{}/html'.format(tmpdir))
+
+
+@nox.session(python=['3.5', '3.6', '3.7', '3.8', '3.9'])
+def tests(session):
+    session.install('invoke', './[test]')
+    session.run('invoke', 'pytest', '--junit', '--no-pty')
+    session.run('codecov')

setup.cfg

@@ -1,5 +1,5 @@
 [flake8]
-exclude = .git,.idea,.pytest_cache,.tox,.venv,.vscode,build,cmd2.egg-info,dist,htmlcov,__pycache__,*.egg
+exclude = .git,.idea,.pytest_cache,.tox,.nox,.venv,.vscode,build,cmd2.egg-info,dist,htmlcov,__pycache__,*.egg
 max-line-length = 127
 max-complexity = 26
 
@@ -12,6 +12,6 @@ force_grid_wrap = 0
 use_parentheses = true
 
 [doc8]
-ignore-path=docs/_build,.git,.idea,.pytest_cache,.tox,.venv,.vscode,build,cmd2,examples,tests,cmd2.egg-info,dist,htmlcov,__pycache__,*.egg
+ignore-path=docs/_build,.git,.idea,.pytest_cache,.tox,.nox,.venv,.vscode,build,cmd2,examples,tests,cmd2.egg-info,dist,htmlcov,__pycache__,*.egg
 max-line-length=117
 verbose=0

setup.py

@@ -33,18 +33,30 @@
 
 SETUP_REQUIRES = ['setuptools_scm >= 3.0']
 
-INSTALL_REQUIRES = ['attrs >= 16.3.0', 'colorama >= 0.3.7', 'pyperclip >= 1.6', 'setuptools >= 34.4', 'wcwidth >= 0.1.7']
+INSTALL_REQUIRES = [
+    'attrs >= 16.3.0',
+    'colorama >= 0.3.7',
+    'pyperclip >= 1.6',
+    'setuptools >= 34.4',
+    'wcwidth >= 0.1.7',
+]
 
 EXTRAS_REQUIRE = {
     # Windows also requires pyreadline to ensure tab completion works
     ":sys_platform=='win32'": ['pyreadline'],
     # Extra dependencies for running unit tests
-    'test': ["gnureadline; sys_platform=='darwin'",  # include gnureadline on macOS to ensure it is available in tox env
-             "mock ; python_version<'3.6'",  # for python 3.5 we need the third party mock module
-             'codecov', 'coverage', 'pytest', 'pytest-cov', 'pytest-mock'],
+    'test': [
+        "gnureadline; sys_platform=='darwin'",  # include gnureadline on macOS to ensure it is available in tox env
+        "mock ; python_version<'3.6'",  # for python 3.5 we need the third party mock module
+        'codecov',
+        'coverage',
+        'pytest',
+        'pytest-cov',
+        'pytest-mock',
+    ],
     # development only dependencies:  install with 'pip install -e .[dev]'
     'dev': ["mock ; python_version<'3.6'",  # for python 3.5 we need the third party mock module
-            'pytest', 'codecov', 'pytest-cov', 'pytest-mock', 'tox', 'flake8',
+            'pytest', 'codecov', 'pytest-cov', 'pytest-mock', 'tox', 'nox', 'flake8',
             'sphinx', 'sphinx-rtd-theme', 'sphinx-autobuild', 'doc8',
             'invoke', 'twine>=1.11',
             ]