-
Notifications
You must be signed in to change notification settings - Fork 6
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
139 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,139 @@ | ||
from __future__ import annotations | ||
|
||
import argparse | ||
import shutil | ||
from pathlib import Path | ||
|
||
import nox | ||
|
||
DIR = Path(__file__).parent.resolve() | ||
|
||
nox.options.sessions = ["lint", "pylint", "tests"] | ||
|
||
|
||
@nox.session | ||
def lint(session: nox.Session) -> None: | ||
""" | ||
Run the linter. | ||
""" | ||
session.install("pre-commit") | ||
session.run( | ||
"pre-commit", | ||
"run", | ||
"--all-files", | ||
"--show-diff-on-failure", | ||
*session.posargs, | ||
) | ||
|
||
|
||
@nox.session | ||
def pylint(session: nox.Session) -> None: | ||
""" | ||
Run PyLint. | ||
""" | ||
# This needs to be installed into the package environment, and is slower | ||
# than a pre-commit check | ||
session.install(".", "pylint") | ||
session.run("pylint", "antarctic_plots", *session.posargs) | ||
|
||
|
||
@nox.session(venv_backend="mamba", python="3.11") | ||
def tests(session: nox.Session) -> None: | ||
""" | ||
Run the unit and regular tests. | ||
""" | ||
session.conda_install("pygmt", "geopandas") | ||
session.install(".[test]") | ||
|
||
# run tests with numba jit disabled to get real coverage | ||
session.run( | ||
"pytest", | ||
*session.posargs, | ||
env={"NUMBA_DISABLE_JIT": "1"}, | ||
) | ||
|
||
# run just the numba tests with numba jit enabled | ||
session.run( | ||
"pytest", | ||
"-m", | ||
"use_numba", | ||
*session.posargs, | ||
env={"NUMBA_DISABLE_JIT": "0"}, | ||
) | ||
|
||
|
||
@nox.session(reuse_venv=True) | ||
def docs(session: nox.Session) -> None: | ||
""" | ||
Build the docs. Pass "--serve" to serve. Pass "-b linkcheck" to check links. | ||
""" | ||
|
||
parser = argparse.ArgumentParser() | ||
parser.add_argument("--serve", action="store_true", help="Serve after building") | ||
parser.add_argument( | ||
"-b", dest="builder", default="html", help="Build target (default: html)" | ||
) | ||
args, posargs = parser.parse_known_args(session.posargs) | ||
|
||
if args.builder != "html" and args.serve: | ||
session.error("Must not specify non-HTML builder with --serve") | ||
|
||
extra_installs = ["sphinx-autobuild"] if args.serve else [] | ||
|
||
session.install("-e.[docs]", *extra_installs) | ||
session.chdir("docs") | ||
|
||
if args.builder == "linkcheck": | ||
session.run( | ||
"sphinx-build", "-b", "linkcheck", ".", "_build/linkcheck", *posargs | ||
) | ||
return | ||
|
||
shared_args = ( | ||
"-n", # nitpicky mode | ||
"-T", # full tracebacks | ||
f"-b={args.builder}", | ||
".", | ||
f"_build/{args.builder}", | ||
*posargs, | ||
) | ||
|
||
if args.serve: | ||
session.run("sphinx-autobuild", *shared_args) | ||
else: | ||
session.run("sphinx-build", "--keep-going", *shared_args) | ||
|
||
|
||
@nox.session | ||
def build_api_docs(session: nox.Session) -> None: | ||
""" | ||
Build (regenerate) API docs. | ||
""" | ||
|
||
session.install("sphinx") | ||
session.chdir("docs") | ||
session.run( | ||
"sphinx-apidoc", | ||
"-o", | ||
"api/", | ||
"--module-first", | ||
"--no-toc", | ||
"--force", | ||
"--separate", | ||
"--templatedir=_templates/", | ||
"../src/antarctic_plots", | ||
) | ||
|
||
|
||
@nox.session | ||
def build(session: nox.Session) -> None: | ||
""" | ||
Build an SDist and wheel. | ||
""" | ||
|
||
build_path = DIR.joinpath("build") | ||
if build_path.exists(): | ||
shutil.rmtree(build_path) | ||
|
||
session.install("build") | ||
session.run("python", "-m", "build") |