strict-kwargs 2026.5.16

Enforce using keyword arguments where possible.

strict-kwargs

Fast enforcement of keyword arguments at call sites, without mypy or ty plugins.

Companion to mypy-strict-kwargs for teams that type-check with ty (or want a fast standalone linter).

Example

def add(a: int, b: int) -> int:
    return a + b

add(a=1, b=2)  # OK
add(1, 2)  # strict-kwargs error: too many positional arguments

Install

From PyPI (after the first release):

pip install strict-kwargs
# or
uv tool install strict-kwargs

From source:

cargo install --path .
# or
pip install .

Usage

strict-kwargs .                 # check a directory
strict-kwargs src/foo.py        # check a file
strict-kwargs --project-root .  # explicit project root for config

With ty:

ty check
strict-kwargs .

Exit codes: 0 = clean, 1 = violations found, 2 = internal error.

Configuration

In pyproject.toml:

[tool.strict_kwargs]
ignore_names = ["main.func", "builtins.str"]
debug = false

Legacy mypy configuration sections are also supported for migration:

• mypy.ini / .mypy.ini → [mypy_strict_kwargs]
• setup.cfg → [mypy_strict_kwargs]

The same ignore_names entries as mypy-strict-kwargs work (fully-qualified names like package.module.func).

Limitations

This tool uses static analysis (Ruff's Python parser), not a type checker. It resolves many calls within a project but will not catch every case mypy's plugin handles (dynamic callables, complex overloads, etc.).

License

MIT