Skip to content

gh-151213: Document asyncio debugging tools#151392

Open
johnslavik wants to merge 11 commits into
python:mainfrom
johnslavik:gh-151213-document-asyncio-debugging-tools
Open

gh-151213: Document asyncio debugging tools#151392
johnslavik wants to merge 11 commits into
python:mainfrom
johnslavik:gh-151213-document-asyncio-debugging-tools

Conversation

@johnslavik

@johnslavik johnslavik commented Jun 12, 2026

Copy link
Copy Markdown
Member

@bedevere-app bedevere-app Bot added docs Documentation in the Doc dir skip news labels Jun 12, 2026
@github-project-automation github-project-automation Bot moved this to Todo in Docs PRs Jun 12, 2026
@read-the-docs-community

read-the-docs-community Bot commented Jun 12, 2026

Copy link
Copy Markdown

Documentation build overview

📚 cpython-previews | 🛠️ Build #33132778 | 📁 Comparing 23e19e8 against main (c375992)

  🔍 Preview build  

8 files changed · + 1 added · ± 7 modified

+ Added

± Modified

@johnslavik johnslavik added needs backport to 3.14 bugs and security fixes needs backport to 3.15 pre-release feature fixes, bugs and security fixes labels Jun 12, 2026
…asyncio-tools

- Rewrite What's New intro to lead with developer problem/value rather
  than "Added a new command-line interface"
- Drop the misleading "remote debugging support" cross-reference from
  both asyncio-tools.rst and What's New; PYTHON_DISABLE_REMOTE_DEBUG
  does not affect RemoteUnwinder-based task introspection
- Document cycle detection under the pstree option in asyncio-tools.rst
  (previously only mentioned in What's New)
@johnslavik

Copy link
Copy Markdown
Member Author

I cut off remote debugging reference for now.

The What's New text was already correct; only asyncio-tools.rst
needed changes.
- Add one-sentence value summary to the module intro
- Document all seven columns of the ps table output
- Note that ps does not perform cycle detection
- Add motivation sentences to both ps and pstree option descriptions
- Document cycle detection behavior under pstree
@johnslavik johnslavik requested a review from pablogsal June 14, 2026 04:32
@johnslavik johnslavik marked this pull request as ready for review June 14, 2026 04:38
@johnslavik johnslavik changed the title gh-151213: Document asyncio introspection tools gh-151213: Document asyncio debugging tools 🍌 Jun 14, 2026
@kumaraditya303

Copy link
Copy Markdown
Contributor

Please don't use emojis for PR titles.

Comment thread Doc/library/asyncio-tools.rst Outdated
Comment thread Doc/library/asyncio-tools.rst
@johnslavik johnslavik changed the title gh-151213: Document asyncio debugging tools 🍌 gh-151213: Document asyncio debugging tools Jun 14, 2026
Co-authored-by: Stan Ulbrych <stan@python.org>

The :mod:`!asyncio` module can be invoked as a script via ``python -m
asyncio`` to inspect the task graph of another running Python process without
modifying it or restarting it. The :mod:`!asyncio.tools` submodule implements

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

the submodule is not documented, I'd prefer to keep that private for now

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

In that case, it may be better to document it as private, as currently it is technically public per PEP 387.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

awaiting review docs Documentation in the Doc dir needs backport to 3.14 bugs and security fixes needs backport to 3.15 pre-release feature fixes, bugs and security fixes skip news

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

3 participants