runmap
Visualize Python function call trees with timing in the terminal
Run any script through runmap and see a tree of every function call, how long each took, and where the hot spots are
Getting Started
pip install runmap
python -m runmap script.py
python -m runmap script.py --min-ms 5 --depth 3
python -m runmap script.py --out run.trace
python -m runmap diff before.trace after.trace
Features
- Call tree view: shows the full function call hierarchy with per-node timing.
- Time bars: proportional block bars next to each node for quick visual scanning.
- Hot markers: flags functions whose self time exceeds 20% of total runtime.
- Depth and threshold filters:
--depthand--min-mstrim noise from large trees. - Trace files:
--outsaves a.traceJSON file for later comparison. - Diff mode:
runmap diff A.trace B.traceshows a delta table (faster/slower/new). - Sampling mode:
--sampleuses signal-based 100 Hz sampling instead ofsys.settrace(Unix only).
Requirements
- Python 3.10+
- rich >= 13.0
License
Release files for runmap 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| runmap-0.1.1.tar.gz | 14.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| runmap-0.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 26.7 kB
Release files / runmap-0.1.1.tar.gz
| Download URL | runmap-0.1.1.tar.gz |
|---|---|
| Size | 14.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
02fcd24140b661562520a3a23aa9401a3f5a97397cacaba3a149f4144dddbb99
|
|
BLAKE2b-256 checksum How to use checksums |
2538856c25f54e2fb2ba85f49d21e4328e1399f0dcbf96b8df8fd72b6a619b1c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 13, 2026.
Transparency logRelease files / runmap-0.1.1-py3-none-any.whl
| Download URL | runmap-0.1.1-py3-none-any.whl |
|---|---|
| Size | 12.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f75ed013003e2530f780496157d49d7081c6700d63ad23d622db30f46ef1e551
|
|
BLAKE2b-256 checksum How to use checksums |
3b94e811763dc88fe3ed1dc2ecf8f29666eff2fe8147ea42f0ea16aead439a10
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 13, 2026.
Transparency log