Registry / data / mapfile-parser

mapfile-parser

library2.12.2pypypi✓ verified 84d ago

Map file parser library focused on decompilation projects. Supports GNU, mwld, and other map file formats. Current version: 2.12.1. Release cadence: frequent (multiple releases per month).

data

pip install mapfile-parser

github ↗package ↗

INSTALL

IMPORT

SIG · MAPFILE-PARSER

mapfile-parser

datapythonv2.12.2

Install

2.6s avg

Import

666ms

Disk

25MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2.12.2 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.698s · 27MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 2.6s · import 0.634s · 27MB

25MB installed

● package 25MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

MapFile

✓ from mapfile_parser import MapFile

SymbolTypes

✓ from mapfile_parser import SymbolTypes

Basic parsing of a map file and iterating over symbols.

from mapfile_parser import MapFile # Parse a map file (e.g., GNU .map or mwld .map) mf = MapFile() mf.readMapFile('path/to/mapfile.map') print(mf) # Access symbols for segment in mf.segments: for section in segment.sections: for symbol in section.symbols: if symbol.name and 'NON_MATCHING' not in symbol.name: print(symbol.name, hex(symbol.vram))

Debug

Known issues

gotchaWhen using GNU mapfiles, the library may automatically infer ROM addresses for sections/segments even if not explicitly present. This can lead to incorrect addresses if the mapfile is incomplete. Always verify against original binary.

fix

Manually check the inferred addresses by dumping the parsed sections.

affects: >=2.9.3

gotchaStatic symbols are inferred by default, which may cause false positives or missing symbols. The inference can be controlled via options.

fix

Use `MapFile(read_statics=False)` to disable static inference, or adjust via the `SymbolTypes` enum.

affects: >=2.11.0

breakingIn version 2.12.0, a CLI script `mapfile_parser` is installed via pip entry point. This may conflict with existing scripts named 'mapfile_parser' in the user's PATH.

fix

Rename any conflicting scripts or use `python3 -m mapfile_parser` instead of the bare command.

affects: >=2.12.0

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'mapfile_parser'

The package is installed under the name 'mapfile-parser', but Python expects 'mapfile_parser'.

fix

Install the library: pip install mapfile-parser

AttributeError: 'MapFile' object has no attribute 'readMapFile'

Older versions used a different method name; the API may have changed.

fix

Check the installed version: pip show mapfile-parser. For >=2.9.0, use `MapFile.readMapFile(path)`. For older versions, refer to documentation.

Upgrade

Version history

2.12.2latest on PyPI · released May 30, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/Decompollaborate/mapfile_parser ↗

packagehttps://pypi.org/project/mapfile-parser/ ↗