Backtestspydanticrun-20261009-110034#13771

Issue #13771 Merged fix PR #13773 Run 9 Oct 2026 · run-20261009-110034 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 apply the same root-cause fix: they make `self` positional-only in `ValidateCallWrapper.__call__`, which removes the name collision the issue describes. On correctness for the reported `validate_call` path they are equivalent. Patch A also applies the same positional-only change to `ValidatedFunction.init_model_instance` and `call` in the deprecated `validate_arguments` decorator, which has the same collision. That extra change is low-risk and consistent with the main fix, and is neutral on scope. The deciding difference is test quality. Patch B adds one minimal test: a positional-or-keyword `self` parameter called with `self=1`. It would fail before the fix, but it does not cover the keyword-only case from the issue, coercion, error locations, deferred builds, or async functions. Patch A's tests cover the issue's exact keyword-only reproduction and the positional-or-keyword form with both keyword and positional calls. They also check that validation still runs (`'1'` becomes `1`), that a ValidationError reports `loc == ('self',)`, the `defer_build=True` path through `_create_validators`, return validation, and an async function. All of these would fail before the change and pass after it. Patch A also tests the deprecated decorator path it changed. With equal correctness, Patch A's broader and more meaningful tests make it 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

6m 10s

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..bd94a8c8 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) -> int:+        return self++    assert foo(self='1') == 1+    assert foo.validate(self='2').self == 2++    with pytest.raises(ValidationError) as exc_info:+        foo(self='x')+    assert exc_info.value.errors(include_url=False)[0]['loc'] == ('self',)tests/test_validate_call.pyindex 3d86e451..4162cd58 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 kw_only(*, self: int) -> int:+        return self++    assert kw_only(self='1') == 1++    @validate_call+    def pos_or_kw(self: int) -> int:+        return self++    assert pos_or_kw(self='2') == 2+    assert pos_or_kw('3') == 3++    with pytest.raises(ValidationError) as exc_info:+        kw_only(self='x')+    assert exc_info.value.errors(include_url=False)[0]['loc'] == ('self',)++    @validate_call(config={'defer_build': True}, validate_return=True)+    def deferred(*, self: int) -> int:+        return self++    assert deferred(self='4') == 4+++def test_async_keyword_parameter_named_self() -> None:+    @validate_call(validate_return=True)+    async def f(*, self: int) -> int:+        return self++    assert asyncio.run(f(self='5')) == 5 
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