Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

PEP-654: warn that leaf_generator recycles tracebacks #2109

Merged
merged 2 commits into from
Oct 16, 2021
Merged
Changes from 1 commit
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
8 changes: 7 additions & 1 deletion pep-0654.rst
Original file line number Diff line number Diff line change
Expand Up @@ -469,7 +469,13 @@ recursively, as follows:
else:
# exc is a leaf exception and its traceback
# is the concatenation of the traceback
# segments in tbs
# segments in tbs.

# Note: the traceback segments are shallow-copied
# into tbs so they can be shared by multiple leaf
# exceptions. Make a deep copy if your use case
# requires that.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Huh, this is actually ambiguous (I hadn't realized this before): the singly-linked list of Traceback objects is mutable (you could set any item's tb_next and mutate the chain) and in addition the tbs list is reused by each iteration through the generator.

I'm not particularly worried about people mutating the Traceback objects, but somehow your comment appears to refer to them. To describe the reuse of tbs, maybe reformulate the note like this?

Note: the list returned (tbs) is reused by each iteration through the generator.
Make a copy of your use case holds on to it beyond the current iteration.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ah I see, yes. I am a bit concerned also about people concatenating the tb chunks of tbs to make it look like one traceback.


yield exc, tbs
tbs.pop()

Expand Down