[gaborbernat]

simplint now checks every change in pre-commit and on pre-commit.ci, so the conventions Ruff cannot check are enforced before review: reST docstrings on the public API, Final on module constants and a fixed definition order. 🧹 The library's behavior does not change, and existing import paths and positional unpacking keep working. The code is changed so simplint 0.8.0 reports nothing, and the type-level changes a caller can notice are listed below.

Hook and configuration

The hook is pinned to simplint-pre-commit v0.8.0. Each hook also gets an explicit priority, the ordering key of prek: hooks with a lower number run first, hooks with the same number run together, and the numbers are chosen so that no two of them write the same file. Ruff lint runs before simplint and Ruff format after it, so simplint sees code Ruff has already fixed, and formatting has the last word. pre-commit ignores priority and runs hooks in file order.

Ruff's undocumented-* rules are off because they ask for a docstring on every name that looks public. simplint's undocumented-public-api (SMP903) asks only for the public API, and [tool.simplint] sets docstring-style = "rst" so the checks read the reStructuredText (reST) :param: and :returns: fields the package already uses.

Public names and signatures

No importable name is renamed or removed. The package __init__ now holds only imports and __all__, and it adds BuiltMetadata and FrontendArgs to its exports. pyproject_api.__main__ gained an __all__ listing main and main_parser, so a star import from it no longer brings in the module's imports.

Four signatures change. Frontend.create_args_from_folder and Frontend.metadata_from_built return the named tuples described below. SubprocessFrontend.send_cmd annotates its result as tuple[JsonValue, str, str] instead of tuple[Any, str, str], and BackendFailed.__reduce__ annotates its pickled state with JsonValue instead of Any. Runtime values are unchanged, but a caller that assigned a send_cmd result to a non-JSON type now needs a cast.

Result types

Two methods that returned bare tuples now return NamedTuple instances, which are tuples with named fields, so positional unpacking keeps working. create_args_from_folder returns FrontendArgs with the root, backend paths, backend module, backend object, requirements and reuse flag. metadata_from_built returns BuiltMetadata with the metadata directory, out and err.

Type annotations

Values that come from the backend's JSON use JsonValue, a recursive alias for JSON types, in place of Any, and parsed TOML values use a precise union. The private _send accepts only paths and config settings as keyword arguments, and its annotation says so.

Suppressions

Two findings keep their code and a simplint: ignore comment that gives the reason. main_parser stays in __all__ because the CLI parser is public API, and send_cmd keeps **kwargs: Any because it is the generic transport for any backend command, so its keyword arguments are not limited to the frontend's own types.

Module structure

Module constants that are never reassigned are marked Final, which type checkers enforce as no reassignment. The backend's run function is split into named helpers, one per step, and the API docs now describe CmdStatus, the fields of the result types and what metadata_from_built returns.