Skip to content
Draft
Changes from all commits
Commits
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
28 changes: 11 additions & 17 deletions peps/pep-0671.rst
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ Discussions-To: https://mail.python.org/archives/list/python-ideas@python.org/th
Status: Draft
Type: Standards Track
Created: 24-Oct-2021
Python-Version: 3.12
Python-Version: 3.17
Post-History: `24-Oct-2021 <https://mail.python.org/archives/list/python-ideas@python.org/thread/KR2TMLPFR7NHDZCDOS6VTNWDKZQQJN3V/>`__,
`01-Dec-2021 <https://mail.python.org/archives/list/python-ideas@python.org/thread/UVOQEK7IRFSCBOH734T5GFJOEJXFCR6A/>`__

Expand Down Expand Up @@ -34,6 +34,7 @@ Currently-legal idioms for this include::
hi = len(a)

# Also well known: Use a unique custom sentinel object
# This could equivalently be sentinel("_USE_GLOBAL_DEFAULT")
_USE_GLOBAL_DEFAULT = object()
def connect(timeout=_USE_GLOBAL_DEFAULT):
if timeout is _USE_GLOBAL_DEFAULT:
Expand Down Expand Up @@ -70,13 +71,15 @@ scope in which the function was defined (as are early-bound defaults). This
allows the expression to refer to other arguments.

Multiple late-bound arguments are evaluated from left to right, and can refer
to previously-defined values. Order is defined by the function, regardless of
the order in which keyword arguments may be passed.
to previously-defined values. Order is defined by the function definition,
regardless of the order in which keyword arguments may be passed.

::

def prevref(word="foo", a=>len(word), b=>a//2): # Valid
def selfref(spam=>spam): # UnboundLocalError
def spaminate(sausage=>eggs + 1, eggs=>sausage - 1): # Confusing, don't do this
def frob(n=>len(items), items=[]): # See below
def spaminate(sausage=>eggs + 1, eggs=>sausage - 1): # Don't do this
def frob(n=>len(items), items=[]): # Don't do this (but see below)

Evaluation order is left-to-right; however, implementations MAY choose to do so
in two separate passes, first for all passed arguments and early-bound defaults,
Expand Down Expand Up @@ -130,18 +133,9 @@ cover the important distinction here (and the fact that they are similar).
Interaction with other proposals
================================

:pep:`661` attempts to solve one of the same problems as this does. It seeks to
improve the documentation of sentinel values in default arguments, where this
proposal seeks to remove the need for sentinels in many common cases. :pep:`661`
is able to improve documentation in arbitrarily complicated functions (it
cites ``traceback.print_exception`` as its primary motivation, which has two
arguments which must both-or-neither be specified); on the other hand, many
of the common cases would no longer need sentinels if the true default could
be defined by the function. Additionally, dedicated sentinel objects can be
used as dictionary lookup keys, where :pep:`671` does not apply.

A generic system for deferred evaluation has been proposed at times (not to be
confused with :pep:`563` and :pep:`649` which are specific to annotations).
A generic system for deferred evaluation has been proposed at times (in addition
to `function annotations <https://docs.python.org/3/reference/compound_stmts.html#annotations>`__
which can be evaluated lazily).
While it may seem, on the surface, that late-bound argument defaults are of a
similar nature, they are in fact unrelated and orthogonal ideas, and both could
be of value to the language. The acceptance or rejection of this proposal would
Expand Down
Loading