GeezerVison is showing github.com — gh-135490: Add warning about arguments that conflict with pdb by SnoopJ · Pull Request #135520 · python/cpython
Conversation
SnoopJ
commented
Jun 14, 2025
•
edited by github-actions
Bot
Loading
Uh oh!
There was an error while loading. Please reload this page.
Closes #135490.
This changeset adds a warning to the pdb docs explaining that target program arguments that overlap with pdb arguments must be separated from the rest of the command line by -- to prevent confusion on the part of argparse.
Should only be merged if a fix for that issue does not materialize, although the pdb target.py -- -m XYZ case is likely to apply even if there is a fix for the the repeated -m case.
Screenshot

📚 Documentation preview 📚: https://cpython-previews--135520.org.readthedocs.build/
Sorry, something went wrong.
Uh oh!
There was an error while loading. Please reload this page.
|
|
restarting preserves pdb's state (such as breakpoints) and in most cases is more
|
|
|
useful than quitting the debugger upon program's exit.
|
|
|
|
|
|
.. warning::
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think this should be a note, not a warning. Warnings are typically reserved for security problems and things along those lines.
Sorry, something went wrong.
Uh oh!
There was an error while loading. Please reload this page.
|
I agree that this should be be a warning. However, let's hold it off until I figure out what we should do about the actual behavior, because -m might just work and we don't need to use it as an example to confuse users. -p does not start a script so it won't take any extra arguments and everything might just magically work.
|
SnoopJ reacted with thumbs up emoji
Sorry, something went wrong.
Uh oh!
There was an error while loading. Please reload this page.
|
This PR is stale because it has been open for 30 days with no activity.
|
Sorry, something went wrong.
Uh oh!
There was an error while loading. Please reload this page.
|
This PR is stale because it has been open for 90 days with no activity.
|
Sorry, something went wrong.
Uh oh!
There was an error while loading. Please reload this page.
|
The originating issue is no longer present in Python 3.14 or 3.15, so only users of pdb as in Python 3.13 are affected. Closing.
|
Sorry, something went wrong.
Uh oh!
There was an error while loading. Please reload this page.
Reviewers
gaogaotiantian
Awaiting requested review from gaogaotiantian
gaogaotiantian is a code owner
Uh oh!
There was an error while loading. Please reload this page.
Assignees
No one assigned
Milestone
No milestone
Development
Successfully merging this pull request may close these issues.
pdb consumes arguments greedily
Uh oh!
There was an error while loading. Please reload this page.
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
|