Metadata-Version: 2.2
Name: lief
Version: 0.17.1
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.8
Description-Content-Type: text/x-rst

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 an user-friendly API to access to 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, 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
================

.. code-block:: console

  $ pip install lief

.. code-block:: 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>`_
