tests: support nox and updates

.flake8

@@ -5,3 +5,4 @@ ignore = E203, E231, E501, E722, W503, B950
 select = C,E,F,W,T,B,B9,I
 per-file-ignores =
     tests/*: T
+    noxfile.py: T

.github/CONTRIBUTING.md

@@ -3,6 +3,17 @@ detailed description of best practices for developing Scikit-HEP packages.
 
 [skhep-dev-intro]: https://scikit-hep.org/developer/intro
 
+# Quick run with Nox
+
+If you have nox, this project supports nox. These are the supplied sessions:
+
+```console
+nox -s lint
+nox -s tests
+nox -s docs -- serve
+nox -s build
+```
+
 # Setting up a development environment
 
 You can set up a development environment by running:

.github/workflows/ci.yml

@@ -17,7 +17,7 @@ jobs:
     name: Format
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v1
+    - uses: actions/checkout@v2
     - uses: actions/setup-python@v2
     - uses: pre-commit/action@v2.0.3
       with:
@@ -33,7 +33,7 @@ jobs:
         runs-on: [ubuntu-latest, macos-latest, windows-latest]
 
         include:
-        - python-version: pypy-3.6
+        - python-version: pypy-3.7
           runs-on: ubuntu-latest
 
 
@@ -59,7 +59,7 @@ jobs:
     - uses: actions/checkout@v1
 
     - name: Build sdist and wheel
-      run: pipx run --spec build pyproject-build
+      run: pipx run build
 
     - uses: actions/upload-artifact@v2
       with:
@@ -68,5 +68,4 @@ jobs:
     - uses: pypa/gh-action-pypi-publish@v1.4.2
       if: github.event_name == 'release' && github.event.action == 'published'
       with:
-        user: __token__
         password: ${{ secrets.pypi_password }}

noxfile.py

@@ -0,0 +1,65 @@
+import shutil
+from pathlib import Path
+
+import nox
+
+ALL_PYTHONS = ["3.6", "3.7", "3.8", "3.9"]
+
+nox.options.sessions = ["lint", "tests"]
+
+
+DIR = Path(__file__).parent.resolve()
+
+
+@nox.session
+def lint(session):
+    """
+    Run the linter.
+    """
+    session.install("pre-commit")
+    session.run("pre-commit", "run", "--all-files")
+
+
+@nox.session(python=ALL_PYTHONS)
+def tests(session):
+    """
+    Run the unit and regular tests.
+    """
+    session.install(".[test]")
+    session.run("pytest")
+
+
+@nox.session
+def docs(session):
+    """
+    Build the docs. Pass "serve" to serve.
+    """
+
+    session.install(".[docs]")
+    session.chdir("docs")
+    session.run("sphinx-build", "-M", "html", ".", "_build")
+
+    if session.posargs:
+        if "serve" in session.posargs:
+            print("Launching docs at http://localhost:8000/ - use Ctrl-C to quit")
+            session.run("python", "-m", "http.server", "8000", "-d", "_build/html")
+        else:
+            print("Unsupported argument to docs")
+
+
+@nox.session
+def build(session):
+    """
+    Build an SDist and wheel.
+    """
+
+    build_p = DIR.joinpath("build")
+    if build_p.exists():
+        shutil.rmtree(build_p)
+
+    dist_p = DIR.joinpath("dist")
+    if dist_p.exists():
+        shutil.rmtree(dist_p)
+
+    session.install("build")
+    session.run("python", "-m", "build")