rawdumper

Rawdumper is a library based on adamlibrary designed to convert hexadecimal code into binary by directly dumping the hexadecimal code in Python, and to analyze hexadecimal data, offering search and reversing support.

This is a library first, CLI second: importing rawdumper never parses argv or touches stdin. The command-line interface is a thin, optional layer on top.

Install

pip install -e .

Library usage

import rawdumper

data = open("file.bin", "rb").read()

# Render a hex dump as text
print(rawdumper.dump(data, width=16))

# Search for a byte pattern
offsets = rawdumper.find(data, b"needle")
print(rawdumper.contains(data, b"needle"))

# Shannon entropy (bits per byte)
print(rawdumper.entropy(data))

# Restore a hex dump back to binary
text = rawdumper.dump(data, squeeze=False)
restored = rawdumper.restore(text)
assert restored == data

Every function in the public API (rawdumper.dump, rawdumper.find, rawdumper.entropy, rawdumper.restore, etc.) is a plain function that takes bytes in and returns a value — no global state, no CLI side effects.

Optional CLI

Installing this package also registers a rawdumper console script, and the package can be run directly as a module:

rawdumper file.bin
python -m rawdumper file.bin --width 8 --find "Wolf" --stats
python -m rawdumper --reverse dump.hex -o restored.bin

CLI flags:

What's C-backed and why

Package layout

rawdumper/
├── __init__.py    # public API surface (dump, find, entropy, restore, ...)
├── core.py        # dump/format logic
├── search.py      # pattern search
├── stats.py        # entropy
├── reverse.py     # hex-to-binary restore
└── __main__.py    # optional CLI, only runs via `python -m rawdumper` or the console script