Backtestspydanticrun-20261005-183002#13771

Issue #13771 Merged fix PR #13773 Run 5 Oct 2026 · run-20261005-183002 pydantic/pydantic

validate_call cannot call a function with a keyword parameter named self

Better

Our patch was judged better than the merged fix.

In this judgment, Patch A = our agent, Patch B = the merged fix.

Both patches make the same core fix: `ValidateCallWrapper.__call__` becomes `def __call__(self, /, *args, **kwargs)`. That removes the keyword collision at its root, so on correctness of the reported issue they are equal.

Patch A also applies the same positional-only change to `ValidatedFunction.init_model_instance` and `ValidatedFunction.call` in the deprecated decorator. That code path has the identical collision, because the wrapper forwards `*args, **kwargs` into these methods. The change is the same minimal, low-risk signature tweak, so it adds little risk and does not obscure the main fix.

On tests, Patch A is clearly stronger:
- It covers a keyword-only `self`, including string coercion.
- It checks that a validation error reports `loc == ('self',)`.
- It covers a positional-or-keyword `self` called both positionally and by keyword.
- It covers `**kwargs` receiving a `self` key.
- It covers an async function with return validation.
- It covers the deprecated `validate_arguments`, including `.validate()`.

All of these would fail before the change. Patch B adds one minimal test, `func(self=1) == 1`, which would also fail before the fix. It does not check validation or coercion, and it carries a placeholder docstring `"""<link>"""` that is leftover noise.

The core fix is equivalent, but Patch A has much more thorough tests and consistently fixes the parallel bug in the deprecated decorator, so Patch A is the better patch.

The judge saw only the two patches, labelled A and B in random order, with issue links and version numbers removed. The reasoning above is shown verbatim.

Solve

7m 30s

Wall-clock time in the container

Full test suite

No new failures

12,500 passed · 509 skipped · 13,009 total

Contamination audit

Clean

No sign the agent saw the real fix

Patch size

52vs 12 merged

Changed lines, ours vs merged

Initial Checks

  • I confirm that I'm using Pydantic V2

Description

ValidateCallWrapper.__call__ is declared as def __call__(self, *args, **kwargs), so the instance is bound to the name self. A decorated function with a keyword parameter literally named self can then never be called with it: f(self=1) raises TypeError: ValidateCallWrapper.__call__() got multiple values for argument 'self' before validation runs. The wrapped function itself is fine with that name; it is only the wrapper's signature that collides. Same in 2.12.5, 2.13.5 and pydantic/_internal/_validate_call.py on main.

Making self positional-only in __call__ (def __call__(self, /, *args, **kwargs)) removes the collision without changing anything else. Can send the PR.

Example Code

import pydantic.version
from pydantic import validate_call


@validate_call
def f(*, self: int) -> int:
    return self


try:
    print("f(self=1) ->", f(self=1))
except TypeError as e:
    print("f(self=1) -> TypeError:", e)
print(pydantic.version.version_info())
f(self=1) -> TypeError: ValidateCallWrapper.__call__() got multiple values for argument 'self'

Python, Pydantic & OS Version

             pydantic version: 2.13.5
        pydantic-core version: 2.46.5
          pydantic-core build: profile=release pgo=false
               python version: 3.12.13 (main, May 10 2026, 19:20:41) [Clang 22.1.3 ]
                     platform: macOS-26.5.2-arm64-arm-64bit
             related packages: typing_extensions-4.16.0
                       commit: unknown

The two patches

Our patch+49 −3
pydantic/_internal/_validate_call.pyindex 1559d070..10f12cc8 100644@@ -130,7 +130,7 @@ class ValidateCallWrapper:          self.__pydantic_complete__ = True -    def __call__(self, *args: Any, **kwargs: Any) -> Any:+    def __call__(self, /, *args: Any, **kwargs: Any) -> Any:         if not self.__pydantic_complete__:             self._create_validators() pydantic/deprecated/decorator.pyindex b8dc224f..7c2e17f8 100644@@ -142,11 +142,11 @@ class ValidatedFunction:          self.create_model(fields, takes_args, takes_kwargs, config) -    def init_model_instance(self, *args: Any, **kwargs: Any) -> BaseModel:+    def init_model_instance(self, /, *args: Any, **kwargs: Any) -> BaseModel:         values = self.build_values(args, kwargs)         return self.model(**values) -    def call(self, *args: Any, **kwargs: Any) -> Any:+    def call(self, /, *args: Any, **kwargs: Any) -> Any:         m = self.init_model_instance(*args, **kwargs)         return self.execute(m) tests/test_deprecated_validate_arguments.pyindex 4fa70b37..07b050d9 100644@@ -389,3 +389,16 @@ def test_validate_by_name():     assert foo(a=10, d=1) == 11     assert foo(b=10, c=1) == 11     assert foo(a=10, c=1) == 11+++def test_keyword_parameter_named_self():+    @validate_arguments+    def foo(*, self: int):+        return self++    assert foo(self='1') == 1+    assert foo.validate(self='2').self == 2++    with pytest.raises(ValidationError) as exc_info:+        foo(self='a')+    assert exc_info.value.errors(include_url=False)[0]['loc'] == ('self',)tests/test_validate_call.pyindex 3d86e451..5c7abcfa 100644@@ -1339,3 +1339,36 @@ def test_pickle_validate_call_with_basemodel() -> None:      assert unpickled == {1: _PickleTestModel(number=1.0)}     assert unpickled[1].number == 1.0+++def test_keyword_parameter_named_self() -> None:+    @validate_call+    def f(*, self: int) -> int:+        return self++    assert f(self='1') == 1++    with pytest.raises(ValidationError) as exc_info:+        f(self='a')+    assert exc_info.value.errors(include_url=False)[0]['loc'] == ('self',)++    @validate_call+    def g(self: int, other: int) -> tuple[int, int]:+        return self, other++    assert g(self='1', other='2') == (1, 2)+    assert g(1, other=2) == (1, 2)++    @validate_call+    def h(**kwargs: int) -> dict[str, int]:+        return kwargs++    assert h(self='1') == {'self': 1}+++def test_keyword_parameter_named_self_async() -> None:+    @validate_call(validate_return=True)+    async def f(*, self: int) -> int:+        return self++    assert asyncio.run(f(self='1')) == 1 
Merged fix · PR #13773+11 −1
pydantic/_internal/_validate_call.pyindex 1559d0705..10f12cc80 100644@@ -130,7 +130,7 @@ class ValidateCallWrapper:          self.__pydantic_complete__ = True -    def __call__(self, *args: Any, **kwargs: Any) -> Any:+    def __call__(self, /, *args: Any, **kwargs: Any) -> Any:         if not self.__pydantic_complete__:             self._create_validators() tests/test_validate_call.pyindex 3d86e4517..6d97b1e80 100644@@ -1339,3 +1339,13 @@ def test_pickle_validate_call_with_basemodel() -> None:      assert unpickled == {1: _PickleTestModel(number=1.0)}     assert unpickled[1].number == 1.0+++def test_validate_call_self_parameter() -> None:+    """https://github.com/pydantic/pydantic/issues/13771"""++    @validate_call+    def func(self: int):+        return self++    assert func(self=1) == 1