Backtestspydanticrun-20261002-175417#13771

Issue #13771 Merged fix PR #13773 Run 2 Oct 2026 · run-20261002-175417 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: `self` becomes positional-only in `ValidateCallWrapper.__call__` (`def __call__(self, /, *args, **kwargs)`). This removes the name collision at its root, exactly as the issue proposes, so the two are equal on correctness for the reported bug. The difference is in the tests. Patch B adds one test: a function with a positional-or-keyword `self`, called as `func(self=1)`. It would fail before the fix and pass after, but it checks only the happy path. It does not use the keyword-only form from the issue, does not check that validation actually runs (no coercion or error case), and does not cover the async or deferred-build paths. Patch A's tests are broader. They cover the keyword-only `self` from the issue, confirm coercion (`'1'` becomes `1`), and confirm that `ValidationError` is raised on bad input, which shows validation really runs rather than being bypassed. They also mix `self` with another parameter, pass `self` positionally, and cover the async (`validate_return=True`) and `defer_build` paths through `_create_validators`. Patch A also applies the same positional-only change to `init_model_instance` and `call` in the deprecated `validate_arguments` decorator, with a test that covers `.validate(self=...)`. This adjacent fix is low-risk, since a positional-only `self` changes nothing for existing callers, and it does not obscure the main fix, so it is neutral. On the main criteria the patches are equal in correctness, and Patch A has meaningfully stronger, non-superficial tests, so 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

6m 38s

Wall-clock time in the container

Full test suite

No new failures

12,501 passed · 509 skipped · 13,010 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..cc064883 100644@@ -389,3 +389,15 @@ 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):+        foo(self='x')tests/test_validate_call.pyindex 3d86e451..ad4aa4e5 100644@@ -1339,3 +1339,37 @@ 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 foo(*, self: int) -> int:+        return self++    assert foo(self='1') == 1++    with pytest.raises(ValidationError):+        foo(self='x')++    @validate_call+    def bar(self: int, other: int = 0) -> int:+        return self + other++    assert bar(self='1', other='2') == 3+    assert bar('1') == 1+++def test_keyword_parameter_named_self_async() -> None:+    @validate_call(validate_return=True)+    async def foo(*, self: int) -> int:+        return self++    assert asyncio.run(foo(self='1')) == 1+++def test_keyword_parameter_named_self_defer_build() -> None:+    @validate_call(config={'defer_build': True})+    def foo(*, self: int) -> int:+        return self++    assert foo(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