SIGN IN SIGN UP

[3.12] DOCS: Suggest always calling exec with a globals argument and no locals argument (GH-119235) (#119240)

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()
    """)
```
(cherry picked from commit 7e1a130b8ff1ed8b3a5f00fe0f06d3916b852216)

Co-authored-by: Hood Chatham <roberthoodchatham@gmail.com>
M
Miss Islington (bot) committed
a50f0651eeba115f82455a9e48178764bace35eb
Parent: 541b89e
Committed by GitHub <noreply@github.com> on 5/20/2024, 6:11:36 PM