Metadata-Version: 2.2
Name: lief
Version: 2.0.0
Summary: Library to instrument executable formats
Keywords: parser,elf,pe,macho,reverse-engineering
Author-Email: Romain Thomas <contact@lief.re>
License: Apache License 2.0
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: C++
Classifier: Topic :: Software Development :: Libraries
Project-URL: homepage, https://lief-project.github.io/
Project-URL: documentation, https://lief-project.github.io/doc/latest/
Project-URL: repository, https://github.com/lief-project/LIEF
Project-URL: changelog, https://lief-project.github.io/doc/latest/changelog.html
Project-URL: Funding, https://github.com/sponsors/lief-project
Project-URL: Tracker, https://github.com/lief-project/LIEF/issues
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# About

The purpose of this project is to provide a cross-platform library that can parse, modify and
abstract ELF, PE and MachO formats.

Main features:

> - **Parsing**: LIEF can parse ELF, PE, MachO, OAT, DEX, VDEX, ART and provides a user-friendly API to access format internals.
> - **Modify**: LIEF enables to modify some parts of these formats
> - **Abstract**: Three formats have common features like sections, symbols, entry point... LIEF factors them.
> - **API**: LIEF can be used in C++, Python and Rust

LIEF Extended:

> - DWARF/PDB Support
> - Objective-C Metadata
> - dyld shared cache

Checkout: <https://lief.re/doc/latest/extended/intro.html> for the details

# Getting Started

```console
$ pip install lief
```

```python
import lief

elf = lief.ELF.parse("/bin/ls")
for section in elf.sections:
    print(section.name, len(section.content))

pe = lief.PE.parse("cmd.exe")
for imp in pe.imports:
    print(imp.name)

fat = lief.MachO.parse("/bin/dyld")
for macho in fat:
    for sym in macho.symbols:
        print(sym)
```

# Documentation

- [Main documentation](https://lief.re/doc/latest/index.html)
- [API](https://lief.re/doc/latest/api/python/index.html)

# Contact

- **Mail**: contact at lief.re
- **Discord**: [LIEF](https://discord.gg/jGQtyAYChJ)

# Authors

Romain Thomas [@rh0main](https://x.com/rh0main)

______________________________________________________________________

LIEF is provided under the [Apache 2.0 license](https://github.com/lief-project/LIEF/blob/0.15.1/LICENSE)
