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", "--prefer-binary") 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"} )