# objutils

**Repository Path**: sgnes/objutils

## Basic Information

- **Project Name**: objutils
- **Description**: Create/manipulate object-files like ELF, IEEE695, SRecord, IHex.
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-02-02
- **Last Updated**: 2024-11-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

pyObjUtils
==========

[![Codacy Badge](https://api.codacy.com/project/badge/grade/a19c06fc898f4f87b680694956302dab)](https://www.codacy.com/app/cpu12-gems/objutils)
[![Code Climate](https://codeclimate.com/github/christoph2/objutils/badges/gpa.svg)](https://codeclimate.com/github/christoph2/objutils)
[![Code Issues](https://www.quantifiedcode.com/api/v1/project/07640eef722642e58a5d914bdc1e7784/badge.svg)](https://www.quantifiedcode.com/app/project/07640eef722642e58a5d914bdc1e7784)
[![Coverage Status](https://coveralls.io/repos/github/christoph2/objutils/badge.svg?branch=master)](https://coveralls.io/github/christoph2/objutils?branch=master)
[![Build Status](https://travis-ci.org/christoph2/objutils.svg)](https://travis-ci.org/christoph2/objutils)
[![Build status](https://ci.appveyor.com/api/projects/status/owpi324b6wbwocq9?svg=true)](https://ci.appveyor.com/project/christoph2/objutils)
[![GPL License](http://img.shields.io/badge/license-GPL-blue.svg)](http://opensource.org/licenses/GPL-2.0)

### Welcome to objutils!
obutils is a Python library to process/parse 
object files (ELF, IEEE695, S19, iHex, Tektronix...)

you really like readelf, objdump, and objcopy, don't you?

to help you handle this daunting task.
especially embedded systems developers are often in need to do
strange things with object files...

### Features at a glance

- Write programs faster than you sreen-scrape readelf/objdump.
- Create and process ..., like Intel hex, Motorola srec, 
  Texas Instruments Text (MSP430), and some historical (text) formats.
- Decent AAABI (Arm Architecture Application Binary Interface) support.


### Basic Examples


First of all, you need to import the library (of cause...)
 
``` python
>>> import objutils
```

Ok, let's start with the obligatory hello world:

``` python
>>> builder.addSection("Hello, world")
>>> builder.image
Section(address = 0X00000000, length = 12, data = 'Hello, world')

```

Let's have a look what we've just created:

```python

>>> image = builder.image # Create a shortcut.
>>> image.hexdump()

Section #0000
-------------
00000000  48 65 6c 6c 6f 2c 20 77 6f 72 6c 64 21           |Hello, world!   |
---------------
       13 bytes
---------------
```


You may ask, what about addresses?


For a list of supported codecs run the following command: