noxfile.py

# Copyright 2025 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

import nox
import sys

PYTHON_VERSIONS = ["3.10", "3.11", "3.12", "3.13"]

TEST_COMMAND = [
    "coverage",
    "run",
    "--append",
    "-m",
    "unittest",
    "discover",
    "--buffer",
    "-s=tests",
    "-p",
    "*_test.py",
]

FREEZE_COMMAND = [sys.executable, "-m", "pip", "freeze"]
TEST_DEPENDENCIES = [
    "pyfakefs>=5.0.0,<6.0",
    "coverage==6.5.0",
]


def _format(session, check=False):
    """Helper function to run formatters.

    Args:
      session: The nox session object.
      check: If True, checks formatting and fails if any file requires
        formatting, but doesn't apply any changes. If False, applies formatting
        fixes.
    """
    black_command = ["black"]
    if check:
        black_command.append("--check")

    black_command.extend(
        [
            "-l",
            "80",
            "--exclude",
            r"/(v[0-9]+|\.eggs|\.git|_cache|\.nox|\.tox|\.venv|env|venv|\.svn|_build|buck-out|build|dist)/",
            ".",
        ]
    )

    session.run(*black_command)


@nox.session(venv_backend="none")
def lint(session):
    """Fails if the code is not formatted correctly."""
    _format(session, check=True)


@nox.session(venv_backend="none")
def format(session):
    """Runs the black formatter and applies formatting fixes."""
    _format(session)


@nox.session(python=PYTHON_VERSIONS)
def tests(session):
    session.install(".")
    # modules for testing
    session.install(*TEST_DEPENDENCIES)
    session.run(*FREEZE_COMMAND)
    session.run(
        *TEST_COMMAND,
    )


@nox.session(venv_backend="none")
def smoke_tests(session):
    """Runs the smoke tests."""
    session.run(sys.executable, "-m", "unittest", "tests/smoke/smoke_test.py")


@nox.session(venv_backend="none")
def llm_tests(session):
    """Runs the LLM tool selection smoke tests."""
    session.run(sys.executable, "-m", "pip", "install", "google-genai")
    session.run(sys.executable, "-m", "unittest", "tests/smoke/llm_test.py")


@nox.session(venv_backend="none")
def update_smoke_golden(session):
    """Updates the smoke test golden file."""
    session.run(sys.executable, "-m", "tests.smoke.generate_golden")