ihexsrec - Python package for Intel Hex and Motorola SREC files
A lightweight Python library for reading, writing, and converting between Intel HEX and Motorola S-Record files. It also provides an in-memory representation of binary data (MemoryImage) that can be modified and exported in multiple formats.
Features
- Parse Intel HEX (.hex) and Motorola SREC (.srec) files
- Convert between HEX ↔ SREC
- Modify memory data in-place (insert, delete, overwrite)
- Export to binary (.bin) format
- Preserve and modify entry points (linear or segmented)
- No external dependencies, pure Python 3
- MIT licensed
Installation
pip install ihexsrec
Quick Example
from ihexsrec import IHEXSREC
# Load from an Intel HEX file
doc = IHEXSREC.load("firmware.hex")
# Modify bytes
doc.write(0x1000, b"\x01\x02\x03\x04")
# Convert to SREC and save
doc.save_as_srec("firmware.srec")
# Export a raw binary region
data = doc.to_bin(start=0x1000, end=0x2000)
with open("firmware.bin", "wb") as f:
f.write(data)
API Overview
Core Classes
- MemoryImage: Sparse in-memory representation of addressable bytes
- IntelHexCodec: Intel HEX parser and encoder
- SrecCodec: Motorola SREC parser and encoder
- IHEXSREC: High-level facade providing load/save/convert helpers
Common Methods (IHEXSREC)
| Method | Description |
|---|---|
load(path_or_lines) |
Load Intel HEX or Motorola SREC automatically and return an IHEXSREC instance. |
to_intel_hex(record_size=16) |
Convert the in-memory image to Intel HEX lines. |
to_srec(record_size=16, addr_width=None, header="ihexsrec") |
Convert the in-memory image to Motorola SREC lines. |
save_as_hex(path, record_size=16) |
Save the current image as an Intel HEX file. |
save_as_srec(path, record_size=16, addr_width=None, header="ihexsrec") |
Save the current image as a Motorola SREC file. |
to_bin(start=None, end=None, fill=0xFF) |
Export a raw binary slice of the image as bytes. |
save_as_bin(path, start=None, end=None, fill=0xFF) |
Save the current image (or a region) to a binary file. |
write(addr, data) |
Overwrite bytes starting at a specific address. |
insert(addr, data, shift_entry=False) |
Insert bytes and shift subsequent addresses upward. |
delete(addr, length, shift_entry=False) |
Delete a range of bytes and shift subsequent bytes downward. |
set_entry_linear(addr) |
Set or clear the linear entry point (e.g., 32-bit start address). |
set_entry_segmented(cs, ip) |
Set the segmented entry point (CS:IP pair). |
first_address() |
Return the lowest address present in memory, or None if empty. |
last_address() |
Return the highest address present in memory, or None if empty. |
occupied_ranges() |
Return a list of contiguous occupied address ranges as (start, end_inclusive) tuples. |
gap_ranges(within=None) |
Return a list of address gaps as (start, end_inclusive) tuples, optionally within a given window. |
fill_gaps(fill, within=None) |
Fill all detected gaps with a given one-byte value (e.g. 0xFF). |
move(to, start=None, until=None, overwrite=True, shift_entry=True) |
Move a window of bytes—or the entire image—to a new base address. |
convert(input_lines_or_path, to, **kwargs) |
Convert directly from HEX→SREC or SREC→HEX in one step. |
License
MIT License © 2025 Ioannis D. (devcoons)
1 maintainer
Metadata
1 maintainer
Release files for ihexsrec 0.1.9
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ihexsrec-0.1.9.tar.gz | 23.0 kB | Without provenance | Details for ihexsrec-0.1.9.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ihexsrec-0.1.9-py3-none-any.whl | Python 3 | none | any | Details for ihexsrec-0.1.9-py3-none-any.whl |
Total release size: 34.6 kB
Release files / ihexsrec-0.1.9.tar.gz
| Download URL | ihexsrec-0.1.9.tar.gz |
|---|---|
| Size | 23.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b674e2ef8c9eaf05c9acf7d6bae7fc3ab134b637835e0ea35142e30984720d8a
|
|
BLAKE2b-256 checksum How to use checksums |
c4afc35675cf044e4b7ca62421bda116ca3b0b29a60399221b5a0bf3b4e07cc5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.24
|
Release files / ihexsrec-0.1.9-py3-none-any.whl
| Download URL | ihexsrec-0.1.9-py3-none-any.whl |
|---|---|
| Size | 11.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ea7e6e2dde01e98dc49288d340cc9611de321d146d139419af4fe88bf3aec538
|
|
BLAKE2b-256 checksum How to use checksums |
20de90440ea35c7b64e642211bb110874f05a2ed6aa9643405e82240372ed057
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.24
|
Security for ihexsrec 0.1.9
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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
