mypy-strict-kwargs

Enforce using keyword arguments where possible.

For example, if we have a function which takes two regular argument, there are three ways to call it. With this plugin, mypy will only accept the form where keyword arguments are used.

"""Showcase errors when calling a function without naming the arguments."""


def add(a: int, b: int) -> int:
    """Add two numbers."""
    return a + b


add(a=1, b=2)  # With this plugin, ``mypy`` will only accept this form
add(1, 2)  # type: ignore[call-arg]
add(1, b=2)  # type: ignore[call-arg]

Why?

In the same spirit as a formatter - think black or ruff format - this lets you stop spending time discussing whether a particular function call should use keyword arguments.
Sometimes positional arguments are best at first, and then more and more are added and code becomes unclear, without anyone stopping to refactor to keyword arguments.
The type checker gives better errors when keyword arguments are used. For example, with positional arguments, you may see, Argument 5 to "add" has incompatible type "str"; expected "int". This requires that you count the arguments to see which one is wrong. With named arguments, you get Argument "e" to "add" has incompatible type "str"; expected "int".

Installation

pip install mypy-strict-kwargs

This is tested on Python 3.11+.

Configure mypy to use the plugin

Add the plugin to your mypy configuration file:

pyproject.toml:

[tool.mypy]

plugins = [
    "mypy_strict_kwargs",
]

mypy.ini or .mypy.ini:

[mypy]
plugins = mypy_strict_kwargs

setup.cfg:

[mypy]
plugins = mypy_strict_kwargs

Ignoring functions

You can ignore functions by adding configuration to your mypy configuration file.

pyproject.toml:

[tool.mypy_strict_kwargs]
ignore_names = ["main.func", "builtins.str"]

mypy.ini, .mypy.ini, or setup.cfg:

[mypy_strict_kwargs]
ignore_names = main.func, builtins.str

This is useful especially for builtins which can look strange with keyword arguments. For example, str(object=1) is not idiomatic.

To find the name of a function to ignore, set the following configuration:

pyproject.toml:

[tool.mypy_strict_kwargs]
debug = true

mypy.ini, .mypy.ini, or setup.cfg:

[mypy_strict_kwargs]
debug = true

Then run mypy and look for the debug output.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mypy_strict_kwargs-2026.8.19.tar.gz (49.7 kB view details)

Uploaded Aug 19, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

mypy_strict_kwargs-2026.8.19-py3-none-any.whl (23.8 kB view details)

Uploaded Aug 19, 2026 Python 3

File details

Details for the file mypy_strict_kwargs-2026.8.19.tar.gz.

File metadata

Download URL: mypy_strict_kwargs-2026.8.19.tar.gz
Upload date: Aug 19, 2026
Size: 49.7 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for mypy_strict_kwargs-2026.8.19.tar.gz
Algorithm	Hash digest
SHA256	`5a745aaa57aa5f4f735ed558930f704137bdadc5b4a775bfe7e6629b39e651b6`
MD5	`2e1455e605e8a0334608764df189e4ef`
BLAKE2b-256	`f060365ad9c1090ec3cecb740ed3d4e3167067a6d1e0fdf7972c031524d22b64`

See more details on using hashes here.

Provenance

The following attestation bundles were made for mypy_strict_kwargs-2026.8.19.tar.gz:

Publisher: release.yml on adamtheturtle/mypy-strict-kwargs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: mypy_strict_kwargs-2026.8.19.tar.gz
- Subject digest: 5a745aaa57aa5f4f735ed558930f704137bdadc5b4a775bfe7e6629b39e651b6
- Sigstore transparency entry: 2520467145
- Sigstore integration time: Aug 19, 2026
Source repository:
- Permalink: adamtheturtle/mypy-strict-kwargs@f69a5e37e318e6739963f848afb071b3f454a0a6
- Branch / Tag: refs/heads/main
- Owner: https://github.com/adamtheturtle
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@f69a5e37e318e6739963f848afb071b3f454a0a6
- Trigger Event: workflow_dispatch

File details

Details for the file mypy_strict_kwargs-2026.8.19-py3-none-any.whl.

File metadata

Download URL: mypy_strict_kwargs-2026.8.19-py3-none-any.whl
Upload date: Aug 19, 2026
Size: 23.8 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for mypy_strict_kwargs-2026.8.19-py3-none-any.whl
Algorithm	Hash digest
SHA256	`8a917e613b34309a87f09bedd2d54075ccead3ed6405d7e00bc344be885749d0`
MD5	`7eb6c5603d0e11a0bfad46f906234125`
BLAKE2b-256	`11ad4ebe41547642c2e7fba715d1ac6d3b96a9da85f8ca838a43e461d805576f`

See more details on using hashes here.

Provenance

The following attestation bundles were made for mypy_strict_kwargs-2026.8.19-py3-none-any.whl:

Publisher: release.yml on adamtheturtle/mypy-strict-kwargs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: mypy_strict_kwargs-2026.8.19-py3-none-any.whl
- Subject digest: 8a917e613b34309a87f09bedd2d54075ccead3ed6405d7e00bc344be885749d0
- Sigstore transparency entry: 2520467832
- Sigstore integration time: Aug 19, 2026
Source repository:
- Permalink: adamtheturtle/mypy-strict-kwargs@f69a5e37e318e6739963f848afb071b3f454a0a6
- Branch / Tag: refs/heads/main
- Owner: https://github.com/adamtheturtle
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@f69a5e37e318e6739963f848afb071b3f454a0a6
- Trigger Event: workflow_dispatch