]> git.ipfire.org Git - thirdparty/Python/cpython.git/commit
DOCS: Suggest always calling exec with a globals argument and no locals argument...
authorHood Chatham <roberthoodchatham@gmail.com>
Mon, 20 May 2024 17:42:15 +0000 (13:42 -0400)
committerGitHub <noreply@github.com>
Mon, 20 May 2024 17:42:15 +0000 (17:42 +0000)
commit7e1a130b8ff1ed8b3a5f00fe0f06d3916b852216
tree052d45ada76df8eaec20875c6edfe192c7de9534
parent1195c164daab873ebf87ba8efe44fffdf47307ef
DOCS: Suggest always calling exec with a globals argument and no locals argument (GH-119235)

Many users think they want a locals argument for various reasons but they do not
understand that it makes code be treated as a class definition. They do not want
their code treated as a class definition and get surprised. The reason not
to pass locals specifically is that the following code raises a `NameError`:

```py
exec("""
def f():
    print("hi")

f()

def g():
    f()
g()
""", {}, {})
```

The reason not to leave out globals is as follows:

```py
def t():
    exec("""
def f():
    print("hi")

f()

def g():
    f()
g()
    """)
```
Doc/library/functions.rst