chore: add more Ruff checks and fixes (#893)

* chore: add more Ruff checks and fix issues

Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com>

* chore: add some preview check fixes

Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com>

* chore: fix reporting on _typing

Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com>

* chore: update Ruff to 0.8

Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com>

---------

Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com>

.github/action_helper.py

@@ -22,11 +22,14 @@ def filter_version(version: str) -> str:
 
     version_parts = version_.split(".")
     if len(version_parts) < 2:
-        raise ValueError(f"invalid version: {version}")
+        msg = f"invalid version: {version}"
+        raise ValueError(msg)
     if not version_parts[0].isdigit():
-        raise ValueError(f"invalid major python version: {version}")
+        msg = f"invalid major python version: {version}"
+        raise ValueError(msg)
     if not version_parts[1].isdigit():
-        raise ValueError(f"invalid minor python version: {version}")
+        msg = f"invalid minor python version: {version}"
+        raise ValueError(msg)
     return ".".join(version_parts[:2])
 
 
@@ -36,20 +39,22 @@ def setup_action(input_: str) -> None:
     pypy_versions = [version for version in versions if version.startswith("pypy")]
     pypy_versions_filtered = [filter_version(version) for version in pypy_versions]
     if len(pypy_versions) != len(set(pypy_versions_filtered)):
-        raise ValueError(
+        msg = (
             "multiple versions specified for the same 'major.minor' PyPy interpreter:"
             f" {pypy_versions}"
         )
+        raise ValueError(msg)
 
     cpython_versions = [version for version in versions if version not in pypy_versions]
     cpython_versions_filtered = [
         filter_version(version) for version in cpython_versions
     ]
     if len(cpython_versions) != len(set(cpython_versions_filtered)):
-        raise ValueError(
+        msg = (
             "multiple versions specified for the same 'major.minor' CPython"
             f" interpreter: {cpython_versions}"
         )
+        raise ValueError(msg)
 
     # cpython shall be installed last because
     # other interpreters also define pythonX.Y symlinks.
@@ -70,5 +75,6 @@ def setup_action(input_: str) -> None:
 
 if __name__ == "__main__":
     if len(sys.argv) != 2:
-        raise AssertionError(f"invalid arguments: {sys.argv}")
+        msg = f"invalid arguments: {sys.argv}"
+        raise AssertionError(msg)
     setup_action(sys.argv[1])

.pre-commit-config.yaml

@@ -24,7 +24,7 @@ repos:
       - id: pyproject-fmt
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.7.3
+    rev: v0.8.0
     hooks:
       - id: ruff
         args: ["--fix", "--show-fixes"]

nox/__init__.py

@@ -17,7 +17,7 @@
 from nox import project
 from nox._cli import main
 from nox._options import noxfile_options as options
-from nox._parametrize import Param as param
+from nox._parametrize import Param as param  # noqa: N813
 from nox._parametrize import parametrize_decorator as parametrize
 from nox.registry import session_decorator as session
 from nox.sessions import Session
@@ -26,11 +26,11 @@
 
 __all__ = [
     "Session",
+    "main",
     "needs_version",
     "options",
     "param",
     "parametrize",
     "project",
     "session",
-    "main",
 ]

nox/_decorators.py

@@ -18,12 +18,12 @@
 import functools
 import inspect
 import types
-from collections.abc import Iterable, Mapping, Sequence
 from typing import TYPE_CHECKING, Any, Callable, TypeVar, cast
 
-from . import _typing
-
 if TYPE_CHECKING:
+    from collections.abc import Iterable, Mapping, Sequence
+
+    from . import _typing
     from ._parametrize import Param
 
 T = TypeVar("T", bound=Callable[..., Any])
@@ -32,12 +32,12 @@
 class FunctionDecorator:
     """This is a function decorator."""
 
-    def __new__(
+    def __new__(  # noqa: PYI034
         cls: Any, func: Callable[..., Any], *args: Any, **kwargs: Any
     ) -> FunctionDecorator:
-        obj = super().__new__(cls)
-        functools.update_wrapper(obj, func)
-        return cast(FunctionDecorator, obj)
+        self = super().__new__(cls)
+        functools.update_wrapper(self, func)
+        return cast(FunctionDecorator, self)
 
 
 def _copy_func(src: T, name: str | None = None) -> T:

nox/_option_set.py

@@ -23,13 +23,15 @@
 import functools
 from argparse import ArgumentError as ArgumentError  # noqa: PLC0414
 from argparse import ArgumentParser, Namespace
-from collections.abc import Callable, Iterable
-from typing import Any, Literal
+from typing import TYPE_CHECKING, Any, Literal
 
 import argcomplete
 import attrs
 import attrs.validators as av
 
+if TYPE_CHECKING:
+    from collections.abc import Callable, Iterable
+
 av_opt_str = av.optional(av.instance_of(str))
 av_opt_list_str = av.optional(
     av.deep_iterable(
@@ -198,6 +200,7 @@ def make_flag_pair(
     name: str,
     enable_flags: tuple[str, str] | tuple[str],
     disable_flags: tuple[str, str] | tuple[str],
+    *,
     default: bool | Callable[[], bool] = False,
     **kwargs: Any,
 ) -> tuple[Option, Option]:
@@ -277,9 +280,8 @@ def parser(self) -> ArgumentParser:
 
             # Every option must have a group (except for hidden options)
             if option.group is None:
-                raise ValueError(
-                    f"Option {option.name} must either have a group or be hidden."
-                )
+                msg = f"Option {option.name} must either have a group or be hidden."
+                raise ValueError(msg)
 
             argument = groups[option.group.name].add_argument(
                 *option.flags, help=option.help, default=option.default, **option.kwargs
@@ -331,7 +333,8 @@ def namespace(self, **kwargs: Any) -> argparse.Namespace:
         # used in tests.
         for key, value in kwargs.items():
             if key not in args:
-                raise KeyError(f"{key} is not an option.")
+                msg = f"{key} is not an option."
+                raise KeyError(msg)
             args[key] = value
 
         return argparse.Namespace(**args)

nox/_options.py

@@ -19,16 +19,19 @@
 import itertools
 import os
 import sys
-from collections.abc import Iterable
-from typing import Any, Callable, Literal, Sequence
+from typing import TYPE_CHECKING, Any, Callable, Literal, Sequence
 
 import argcomplete
 
 from nox import _option_set
-from nox._option_set import NoxOptions
 from nox.tasks import discover_manifest, filter_manifest, load_nox_module
 from nox.virtualenv import ALL_VENVS
 
+if TYPE_CHECKING:
+    from collections.abc import Iterable
+
+    from nox._option_set import NoxOptions
+
 ReuseVenvType = Literal["no", "yes", "never", "always"]
 
 """All of Nox's configuration options."""
@@ -129,9 +132,8 @@ def _force_venv_backend_merge_func(
             command_args.force_venv_backend is not None
             and command_args.force_venv_backend != "none"
         ):
-            raise ValueError(
-                "You can not use `--no-venv` with a non-none `--force-venv-backend`"
-            )
+            msg = "You can not use `--no-venv` with a non-none `--force-venv-backend`"
+            raise ValueError(msg)
         return "none"
     return command_args.force_venv_backend or noxfile_args.force_venv_backend  # type: ignore[return-value]
 
@@ -191,7 +193,7 @@ def _default_list() -> list[str] | None:
     return _default_list
 
 
-def _color_finalizer(value: bool, args: argparse.Namespace) -> bool:
+def _color_finalizer(_value: bool, args: argparse.Namespace) -> bool:  # noqa: FBT001
     """Figures out the correct value for "color" based on the two color flags.
 
     Args:
@@ -224,7 +226,7 @@ def _force_pythons_finalizer(
     return value
 
 
-def _R_finalizer(value: bool, args: argparse.Namespace) -> bool:
+def _R_finalizer(value: bool, args: argparse.Namespace) -> bool:  # noqa: FBT001
     """Propagate -R to --reuse-existing-virtualenvs and --no-install and --reuse-venv=yes."""
     if value:
         args.reuse_venv = "yes"
@@ -233,7 +235,8 @@ def _R_finalizer(value: bool, args: argparse.Namespace) -> bool:
 
 
 def _reuse_existing_virtualenvs_finalizer(
-    value: bool, args: argparse.Namespace
+    value: bool,  # noqa: FBT001
+    args: argparse.Namespace,
 ) -> bool:
     """Propagate --reuse-existing-virtualenvs to --reuse-venv=yes."""
     if value:
@@ -242,7 +245,7 @@ def _reuse_existing_virtualenvs_finalizer(
 
 
 def _posargs_finalizer(
-    value: Sequence[Any], args: argparse.Namespace
+    value: Sequence[Any], _args: argparse.Namespace
 ) -> Sequence[Any] | list[Any]:
     """Removes the leading "--"s in the posargs array (if any) and asserts that
     remaining arguments came after a "--".
@@ -268,7 +271,9 @@ def _posargs_finalizer(
 
 
 def _python_completer(
-    prefix: str, parsed_args: argparse.Namespace, **kwargs: Any
+    prefix: str,  # noqa: ARG001
+    parsed_args: argparse.Namespace,
+    **kwargs: Any,
 ) -> Iterable[str]:
     module = load_nox_module(parsed_args)
     manifest = discover_manifest(module, parsed_args)
@@ -282,7 +287,9 @@ def _python_completer(
 
 
 def _session_completer(
-    prefix: str, parsed_args: argparse.Namespace, **kwargs: Any
+    prefix: str,  # noqa: ARG001
+    parsed_args: argparse.Namespace,
+    **kwargs: Any,
 ) -> Iterable[str]:
     parsed_args.list_sessions = True
     module = load_nox_module(parsed_args)
@@ -296,7 +303,9 @@ def _session_completer(
 
 
 def _tag_completer(
-    prefix: str, parsed_args: argparse.Namespace, **kwargs: Any
+    prefix: str,  # noqa: ARG001
+    parsed_args: argparse.Namespace,
+    **kwargs: Any,
 ) -> Iterable[str]:
     module = load_nox_module(parsed_args)
     manifest = discover_manifest(module, parsed_args)

nox/_parametrize.py

@@ -16,8 +16,10 @@
 
 import functools
 import itertools
-from collections.abc import Callable, Sequence
-from typing import Any, Iterable, Union
+from typing import TYPE_CHECKING, Any, Iterable, Union
+
+if TYPE_CHECKING:
+    from collections.abc import Callable, Sequence
 
 
 class Param:
@@ -73,9 +75,9 @@ def copy(self) -> Param:
 
     def update(self, other: Param) -> None:
         self.id = ", ".join([str(self), str(other)])
-        self.args = self.args + other.args
-        self.arg_names = self.arg_names + other.arg_names
-        self.tags = self.tags + other.tags
+        self.args += other.args
+        self.arg_names += other.arg_names
+        self.tags += other.tags
 
     def __eq__(self, other: object) -> bool:
         if isinstance(other, self.__class__):

nox/_resolver.py

@@ -28,6 +28,7 @@ class CycleError(ValueError):
 def lazy_stable_topo_sort(
     dependencies: Mapping[Node, Iterable[Node]],
     root: Node,
+    *,
     drop_root: bool = True,
 ) -> Iterator[Node]:
     """Returns the "lazy, stable" topological sort of a dependency graph.
@@ -118,7 +119,7 @@ def lazy_stable_topo_sort(
         ~nox._resolver.CycleError: If a dependency cycle is encountered.
     """
 
-    visited = {node: False for node in dependencies}
+    visited = dict.fromkeys(dependencies, False)
 
     def prepended_by_dependencies(
         node: Node,
@@ -191,7 +192,8 @@ def extend_walk(
             # Dependency cycle found.
             walk_list = list(walk)
             cycle = walk_list[walk_list.index(node) :] + [node]
-            raise CycleError("Nodes are in a dependency cycle", tuple(cycle))
+            msg = "Nodes are in a dependency cycle"
+            raise CycleError(msg, tuple(cycle))
         walk[node] = None
         return walk
 

nox/_version.py

@@ -61,7 +61,7 @@ def _parse_needs_version(source: str, filename: str = "<unknown>") -> str | None
 
 def _read_needs_version(filename: str) -> str | None:
     """Read ``nox.needs_version`` from the user's Noxfile."""
-    with open(filename) as io:
+    with open(filename, encoding="utf-8") as io:
         source = io.read()
 
     return _parse_needs_version(source, filename=filename)
@@ -81,9 +81,8 @@ def _check_nox_version_satisfies(needs_version: str) -> None:
         raise InvalidVersionSpecifier(message) from error
 
     if not specifiers.contains(version, prereleases=True):
-        raise VersionCheckFailed(
-            f"The Noxfile requires Nox {specifiers}, you have {version}"
-        )
+        msg = f"The Noxfile requires Nox {specifiers}, you have {version}"
+        raise VersionCheckFailed(msg)
 
 
 def check_nox_version(filename: str) -> None:

nox/command.py

@@ -20,14 +20,13 @@
 import subprocess
 import sys
 from collections.abc import Iterable, Mapping, Sequence
-from typing import Literal, overload
+from typing import TYPE_CHECKING, Literal, overload
 
 from nox.logger import logger
 from nox.popen import DEFAULT_INTERRUPT_TIMEOUT, DEFAULT_TERMINATE_TIMEOUT, popen
 
-TYPE_CHECKING = False
-
 if TYPE_CHECKING:
+    from collections.abc import Iterable, Mapping, Sequence
     from typing import IO
 
 ExternalType = Literal["error", True, False]
@@ -53,7 +52,8 @@ def which(program: str | os.PathLike[str], paths: Sequence[str] | None) -> str:
         return os.fspath(full_path)
 
     logger.error(f"Program {program} not found.")
-    raise CommandFailed(f"Program {program} not found")
+    msg = f"Program {program} not found"
+    raise CommandFailed(msg)
 
 
 def _clean_env(env: Mapping[str, str | None] | None = None) -> dict[str, str] | None:
@@ -162,7 +162,8 @@ def run(
                     f" at {cmd_path}. Pass external=True into run() to explicitly allow"
                     " this."
                 )
-                raise CommandFailed("External program disallowed.")
+                msg = "External program disallowed."
+                raise CommandFailed(msg)
             if external is False:
                 logger.warning(
                     f"Warning: {cmd} is not installed into the virtualenv, it is"
@@ -192,13 +193,14 @@ def run(
             if silent:
                 sys.stderr.write(output)
 
-            raise CommandFailed(f"Returned code {return_code}")
+            msg = f"Returned code {return_code}"
+            raise CommandFailed(msg)
 
         if output:
             logger.output(output)
 
-        return output if silent else True
-
     except KeyboardInterrupt:
         logger.error("Interrupted...")
         raise
+
+    return output if silent else True