Skip to main content

Library for loading and manipulating hex files.

Project description

hexfile
=======

This is a simple library for parsing hex files. Currently only intel hex files are supported.

Installation
------------
You can use the included setup.py or use your pip to install it from PyPI

Usage
-----
To create a HexFile object use hexfile.load:

```python
import hexfile

f = hexfile.load('memory.hex')
```

The `HexFile` object is composed of one or more memory segments, which may be discontinuous. You can access the contents of the hex file as though it were an array of bytes:

```python
print f.size # Total number of bytes in the hexfile (NOT the total span of all addresses)

byte = f[16] # Returns the byte at address 16 (as an int)

bytes = f[256:512] # Returns 256 bytes as a list

print f.segments # Display all the segments in the hex file

```

The `HexFile` object also supports iteration, but rather than iterating over byte values as if it were a list, it includes the byte addresses, as if it were enumerated. This is because the file might be discontinuous, so addresses are frequently needed during iteration.

```
for addr, data in f:
print '0x%08x : 0x%02x' % (addr, data) # Print every byte in the hex file and its 32-bit address
```

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hexfile-0.1.1.tar.gz (2.9 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page