Skip to content

gh-143535: Document dispatch behavior of singledispatchmethod #143592

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
priyanshu2282-cyber wants to merge 6 commits into
base: main
Choose a base branch
from
+5 −0
Open

gh-143535: Document dispatch behavior of singledispatchmethod #143592

Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
666a2a8
gh-143535: Document dispatch behavior of singledispatchmethod
priyanshu2282-cyber Jan 9, 2026
ea2fda1
gh-143535: Move singledispatchmethod note outside example block
priyanshu2282-cyber Jan 9, 2026
119a4b1
Merge branch 'main' into doc-singledispatchmethod-dispatch
priyanshu2282-cyber Jan 9, 2026
2834c45
gh-143535: Clarify dispatch semantics of singledispatchmethod
priyanshu2282-cyber Jan 9, 2026
57e6d20
Update Doc/library/functools.rst
priyanshu2282-cyber Jan 12, 2026
44f3295
Indentation fixes
priyanshu2282-cyber Jan 12, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions Doc/library/functools.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -718,6 +718,11 @@ The :mod:`functools` module defines the following functions:
The same pattern can be used for other similar decorators:
:deco:`staticmethod`, :deco:`~abc.abstractmethod`, and others.

For every ``singledispatchmethod`` method defined in a class, the value
dispatched on by that method is *always* the first argument passed for the call.
Therefore, dispatching to regular methods can only be sensibly performed by
calling such a method from instances of the class, and not from the class object.

.. versionadded:: 3.8

.. versionchanged:: 3.15
Expand Down
Loading