membrowse

1.2.5 verified Fri May 01 auth: no python

Memory footprint analysis tools for embedded firmware. Current version 1.2.5 parses GCC, IAR, and LLD map files, supports Rust symbol attribution by crate, and integrates with GitHub Actions for overlimit builds. Release cadence is irregular, about 1-2 months.

pip install membrowse

Common errors

error ModuleNotFoundError: No module named 'membrowse' ↓

cause Package not installed in current Python environment.

fix

Run pip install membrowse

error membrowse: error: unrecognized arguments: --overlimit ↓

cause Overlimit feature added in v1.2.3; older version does not support --overlimit.

fix

Upgrade to v1.2.5: pip install --upgrade membrowse

Warnings

gotcha membrowse v1.2.x requires map files from specific toolchains (GCC, IAR, LLD). Older versions may not support LLD or newer IAR formats. ↓

fix Upgrade to v1.2.5 for LLD support and newer IAR map format.

gotcha The CLI is the primary interface; importing membrowse directly without calling main() may not do anything useful. ↓

fix Use the CLI or call `from membrowse import main; main([...])`.

Imports

main
wrong
```
import membrowse
```
correct
```
from membrowse import main
```
membrowse is primarily a CLI tool; the main function is exposed for scripting.

Quickstart

membrowse is a CLI tool; use `membrowse --help` after install, or import main for scripting.

from membrowse import main
import os
# The CLI is typically invoked directly, but for programmatic use:
# main(['--help'])
# Example: analyze a map file (adjust path)
# main(['analyze', 'path/to/firmware.map'])