https://github.com/python/cpython/commit/c865ab3781e92ccc56b1729b2b751ac2769f50a0
commit: c865ab3781e92ccc56b1729b2b751ac2769f50a0
branch: main
author: Joshua Ward <[email protected]>
committer: JelleZijlstra <[email protected]>
date: 2025-12-13T08:07:53-08:00
summary:
gh-142568: Fix eval() docs to use 'source' parameter name (#142644)
files:
M Doc/library/functions.rst
diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index 601745a75780fc..9cfbb5a482e974 100644
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -606,16 +606,16 @@ are always available. They are listed here in
alphabetical order.
This function executes arbitrary code. Calling it with
user-supplied input may lead to security vulnerabilities.
- The *expression* argument is parsed and evaluated as a Python expression
+ The *source* argument is parsed and evaluated as a Python expression
(technically speaking, a condition list) using the *globals* and *locals*
mappings as global and local namespace. If the *globals* dictionary is
present and does not contain a value for the key ``__builtins__``, a
reference to the dictionary of the built-in module :mod:`builtins` is
- inserted under that key before *expression* is parsed. That way you can
+ inserted under that key before *source* is parsed. That way you can
control what builtins are available to the executed code by inserting your
own ``__builtins__`` dictionary into *globals* before passing it to
:func:`eval`. If the *locals* mapping is omitted it defaults to the
- *globals* dictionary. If both mappings are omitted, the expression is
+ *globals* dictionary. If both mappings are omitted, the source is
executed with the *globals* and *locals* in the environment where
:func:`eval` is called. Note, *eval()* will only have access to the
:term:`nested scopes <nested scope>` (non-locals) in the enclosing
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]
