|
|
import os |
|
|
|
|
|
import nox |
|
|
|
|
|
nox.needs_version = ">=2022.1.7" |
|
|
nox.options.sessions = ["lint", "tests", "tests_packaging"] |
|
|
|
|
|
PYTHON_VERSIONS = [ |
|
|
"3.6", |
|
|
"3.7", |
|
|
"3.8", |
|
|
"3.9", |
|
|
"3.10", |
|
|
"3.11", |
|
|
"pypy3.7", |
|
|
"pypy3.8", |
|
|
"pypy3.9", |
|
|
] |
|
|
|
|
|
if os.environ.get("CI", None): |
|
|
nox.options.error_on_missing_interpreters = True |
|
|
|
|
|
|
|
|
@nox.session(reuse_venv=True) |
|
|
def lint(session: nox.Session) -> None: |
|
|
""" |
|
|
Lint the codebase (except for clang-format/tidy). |
|
|
""" |
|
|
session.install("pre-commit") |
|
|
session.run("pre-commit", "run", "-a", *session.posargs) |
|
|
|
|
|
|
|
|
@nox.session(python=PYTHON_VERSIONS) |
|
|
def tests(session: nox.Session) -> None: |
|
|
""" |
|
|
Run the tests (requires a compiler). |
|
|
""" |
|
|
tmpdir = session.create_tmp() |
|
|
session.install("cmake") |
|
|
session.install("-r", "tests/requirements.txt") |
|
|
session.run( |
|
|
"cmake", |
|
|
"-S.", |
|
|
f"-B{tmpdir}", |
|
|
"-DPYBIND11_WERROR=ON", |
|
|
"-DDOWNLOAD_CATCH=ON", |
|
|
"-DDOWNLOAD_EIGEN=ON", |
|
|
*session.posargs, |
|
|
) |
|
|
session.run("cmake", "--build", tmpdir) |
|
|
session.run("cmake", "--build", tmpdir, "--config=Release", "--target", "check") |
|
|
|
|
|
|
|
|
@nox.session |
|
|
def tests_packaging(session: nox.Session) -> None: |
|
|
""" |
|
|
Run the packaging tests. |
|
|
""" |
|
|
|
|
|
session.install("-r", "tests/requirements.txt") |
|
|
session.run("pytest", "tests/extra_python_package", *session.posargs) |
|
|
|
|
|
|
|
|
@nox.session(reuse_venv=True) |
|
|
def docs(session: nox.Session) -> None: |
|
|
""" |
|
|
Build the docs. Pass "serve" to serve. |
|
|
""" |
|
|
|
|
|
session.install("-r", "docs/requirements.txt") |
|
|
session.chdir("docs") |
|
|
|
|
|
if "pdf" in session.posargs: |
|
|
session.run("sphinx-build", "-M", "latexpdf", ".", "_build") |
|
|
return |
|
|
|
|
|
session.run("sphinx-build", "-M", "html", ".", "_build") |
|
|
|
|
|
if "serve" in session.posargs: |
|
|
session.log("Launching docs at http://localhost:8000/ - use Ctrl-C to quit") |
|
|
session.run("python", "-m", "http.server", "8000", "-d", "_build/html") |
|
|
elif session.posargs: |
|
|
session.error("Unsupported argument to docs") |
|
|
|
|
|
|
|
|
@nox.session(reuse_venv=True) |
|
|
def make_changelog(session: nox.Session) -> None: |
|
|
""" |
|
|
Inspect the closed issues and make entries for a changelog. |
|
|
""" |
|
|
session.install("ghapi", "rich") |
|
|
session.run("python", "tools/make_changelog.py") |
|
|
|
|
|
|
|
|
@nox.session(reuse_venv=True) |
|
|
def build(session: nox.Session) -> None: |
|
|
""" |
|
|
Build SDists and wheels. |
|
|
""" |
|
|
|
|
|
session.install("build") |
|
|
session.log("Building normal files") |
|
|
session.run("python", "-m", "build", *session.posargs) |
|
|
session.log("Building pybind11-global files (PYBIND11_GLOBAL_SDIST=1)") |
|
|
session.run( |
|
|
"python", "-m", "build", *session.posargs, env={"PYBIND11_GLOBAL_SDIST": "1"} |
|
|
) |
|
|
|
