`generator.close()` never raises `GeneratorExit` · Issue #135110 · python/cpython · GitHub

Bug report

Bug description:

The doc of generator.close() says as shown below:

Raises a GeneratorExit at the point where the generator function was paused.

But generator.close() never raises GeneratorExit as shown below:

def func():
    yield 'Hello'
    yield 'World'

v = func()

print(v.close()) # None
print(v.close()) # None

def func():
    yield 'Hello'
    yield 'World'

v = func()

print(next(v)) # Hello

print(v.close()) # None
print(v.close()) # None

def func():
    yield 'Hello'
    yield 'World'

v = func()

print(next(v)) # Hello
print(next(v)) # World

print(v.close()) # None
print(v.close()) # None

def func():
    yield 'Hello'
    yield 'World'

v = func()

print(v.close()) # None

print(next(v)) # StopIteration

def func():
    yield 'Hello'
    yield 'World'

v = func()

print(next(v)) # Hello

print(v.close()) # None

print(next(v)) # StopIteration

CPython versions tested on:

3.13

Operating systems tested on:

Windows

Linked PRs

generator.close() sends the GeneratorExit to the yield inside the generator, not to caller of close. For example:

def a():
    try:
        yield "123"
    except GeneratorExit:
        print("gotcha!")

gen = a()
next(gen)
gen.close()  # gotcha!

Do you have any suggestions to make the documentation clearer?

I think it's also helpful to emphasize this sentence later in the paragraph:

If the generator function is already closed, or raises GeneratorExit (by not catching the exception), close() returns None.

gh-135110: Fix misleading `generator.close()` documentation (GH-135152)

pythongh-135110: Fix misleading `generator.close()` documentation (py…

[3.13] gh-135110: Fix misleading `generator.close()` documentation (G…

[3.14] gh-135110: Fix misleading `generator.close()` documentation (G…

pythongh-135110: Fix misleading `generator.close()` documentation (py…

`generator.close()` never raises `GeneratorExit` · Issue #135110 · python/cpython · GitHub

Repository navigation

generator.close() never raises GeneratorExit #135110

Bug report

Bug description:

CPython versions tested on:

Operating systems tested on:

Linked PRs

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

`generator.close()` never raises `GeneratorExit` · Issue #135110 · python/cpython · GitHub

Repository navigation

generator.close() never raises GeneratorExit #135110

Description

Bug report

Bug description:

CPython versions tested on:

Operating systems tested on:

Linked PRs

Activity

ZeroIntensity commented on Jun 4, 2025

ryan-duve commented on Jun 4, 2025

Metadata

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

Issue actions