profimp

name	profimp
description	Profile Python import time using profimp and open a waterfall HTML report. Use when investigating slow startup or wanting to identify which imports are most expensive.
compatibility	Requires profimp (available as a pixi dependency). macOS or Linux.
allowed-tools	Bash(profimp:*) Bash(open:*) Bash(xdg-open:*) Bash(python -m webbrowser:*)

Steps

1. Ask what to profile. Suggest common patterns for this repo:

   • import spatialdata
   • from spatialdata import SpatialData
   • from spatialdata_io import xenium

2. Run:

profimp --html "<import_stmt>" > /tmp/profimp.html

3. Open the report:
   • macOS: open /tmp/profimp.html
   • Linux: xdg-open /tmp/profimp.html
   • Either: python -m webbrowser /tmp/profimp.html

Notes

• The report is a waterfall chart showing every sub-import and its timing.
• To compare before/after: cp /tmp/profimp.html /tmp/profimp-before.html before re-running.
• pixi run python -m profimp also works if profimp is not on PATH.