Skip to main content

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: --depth and --min-ms trim noise from large trees.
  • Trace files: --out saves a .trace JSON file for later comparison.
  • Diff mode: runmap diff A.trace B.trace shows a delta table (faster/slower/new).
  • Sampling mode: --sample uses signal-based 100 Hz sampling instead of sys.settrace (Unix only).

Requirements

  • Python 3.10+
  • rich >= 13.0

License

MIT

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)

Source distribution for runmap 0.1.1
File Size Uploaded
runmap-0.1.1.tar.gz 14.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for runmap 0.1.1
File Interpreter ABI Platform
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 log

Release 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

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page