Skip to content

gh-74929: PEP 667 general docs update #119201

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.

Sign up for GitHub

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

Merged
merged 20 commits into from
May 21, 2024
Merged

gh-74929: PEP 667 general docs update #119201

Changes from 1 commit
Commits
Show all changes
20 commits
Select commit Hold shift + click to select a range
6ecb4b3
gh-74929: PEP 667 general docs update
ncoghlan May 20, 2024
fa4172b
pdb's interact still uses a new namespace
ncoghlan May 20, 2024
9ba869b
Cleanup Sphinx lint errors
ncoghlan May 20, 2024
40d0a81
Improve What's New wording
ncoghlan May 20, 2024
b95890d
Define 'optimised scope' term, review f_locals
ncoghlan May 20, 2024
a87f1d7
Move What's New entry to correct section, add credits
ncoghlan May 20, 2024
6e3f1d1
Add porting notes
ncoghlan May 20, 2024
ebcf2d0
Simplify locals() versionchanged notes
ncoghlan May 20, 2024
2a15a62
Merge branch 'main' into gh-74929-pep-667-general-docs-update
ncoghlan May 20, 2024
1e73460
Use newly defined term in pdb docs
ncoghlan May 20, 2024
a867005
Revert extraneous whitespace change
ncoghlan May 20, 2024
70f1db9
Merge remote-tracking branch 'origin/main' into gh-74929-pep-667-gene…
ncoghlan May 21, 2024
c5cb001
Replace the 'mapping namespace' phrase
ncoghlan May 21, 2024
d0fa5e1
Review comments
ncoghlan May 21, 2024
e109eee
Use US spelling for 'optimized'
ncoghlan May 21, 2024
672458f
Clarify that most optimizations are universal
ncoghlan May 21, 2024
270dfac
Fix code.py wording in docs, not just docstring
ncoghlan May 21, 2024
e0ba6c7
exec quirk affects classes, too
ncoghlan May 21, 2024
1187f62
Be consistent about 'top level'
ncoghlan May 21, 2024
9f86cf5
Avoid touching unrelated files
ncoghlan May 21, 2024
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
Prev Previous commit
Next Next commit
pdb's interact still uses a new namespace
  • Loading branch information
@ncoghlan
ncoghlan committed May 20, 2024
commit fa4172b84bd7bf7bc36e39cd26161cc66764172d
16 changes: 9 additions & 7 deletions Doc/library/pdb.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -584,11 +584,18 @@ can be overridden by the local file.

.. pdbcommand:: interact

Start an interactive interpreter (using the :mod:`code` module) whose global
and local namespaces correspond to the global and local namespaces in the
Start an interactive interpreter (using the :mod:`code` module) in a new
global namespace initialised from the local and global namespaces for the
current scope. Use ``exit()`` or ``quit()`` to exit the interpreter and
return to the debugger.

.. note::

As ``interact`` creates a new dedicated namespace for code execution,
assignments to variables will not affect the original namespaces.
However, modifications to any referenced mutable objects will be reflected
in the original namespaces as usual.

.. versionadded:: 3.2

.. versionchanged:: 3.13
Expand All @@ -599,11 +606,6 @@ can be overridden by the local file.
:pdbcmd:`interact` directs its output to the debugger's
output channel rather than :data:`sys.stderr`.

.. versionchanged:: 3.13
The implementation of :pep:`667` means that name assignments made via the
interactive console will directly affect the active scope, even when
running inside a function, generator, or coroutine.

.. _debugger-aliases:

.. pdbcommand:: alias [name [command]]
Expand Down