Skip to content
/ atv Public

atv(async task viewer): a toolkit for experimenting with Python 3.14 asyncio ps/pstree features.

License

Notifications You must be signed in to change notification settings

jrfk/atv

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

atv 🌱

PyPI Python versions GitHub Actions License

image

atv(async task viewer) is a CLI for exploring Python asyncio processes with a Textual UI. It starts by listing Python processes running locally, and we plan to integrate execution of asyncio ps / pstree and call-graph visualization.

Setup

cd atv
uv sync

uv sync installs the specified dependencies (textual, psutil) into your local environment.

Usage

uv run atv

Shortcuts:

  • R – Refresh the process list (the table shows PID / Process / File / Command Line)
  • Q – Exit
  • Enter / P – Run python -m asyncio ps for the selected PID and display the result in the right pane

Using uvx

Once released, you'll be able to launch it with a one-liner.

uvx atv

If you want to test uvx behavior during local development, run the following in the project root.

uvx --from . atv

Roadmap

  • View that periodically runs python -m asyncio ps for the selected process
  • Visualization for asyncio pstree / format_call_graph
  • Snapshot capture and diff comparison
  • Integration with the FastAPI demo (retrieve task information via the API)

License

This project is licensed under the MIT License. See LICENSE for details.

About

atv(async task viewer): a toolkit for experimenting with Python 3.14 asyncio ps/pstree features.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages