Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/windelbouwman/ppci

A compiler for ARM, X86, MSP430, xtensa and more implemented in pure Python
https://github.com/windelbouwman/ppci

arm assembler c-compiler c-preprocessor compiler m68k msp430 python riscv webassembly x86-64 xtensa

Last synced: 2 months ago
JSON representation

A compiler for ARM, X86, MSP430, xtensa and more implemented in pure Python

Awesome Lists containing this project

README 

        

Introduction

============



The PPCI (Pure Python Compiler Infrastructure) project is a compiler

written entirely in the `Python `_ programming

language. It contains front-ends for various programming languages as

well as machine code generation functionality. With this library you can

generate (working!) machine code using Python (and thus very easy to

explore, extend, etc.)!



The project contains:



- Language frontends for C, Python, Pascal, Basic and Brainfuck

- Code generation for several architectures: 6500, arm, avr, m68k, microblaze, msp430, openrisc, risc-v, stm8, x86_64, xtensa

- Command line utilities, such as ppci-cc, ppci-ld and ppci-opt

- WebAssembly, JVM, OCaml support

- Support for ELF, EXE, S-record and hexfile formats

- An intermediate representation (IR) which can be serialized in json

- The project can be used as a library so you can script the compilation process



Installation

------------



Since the compiler is a python package, you can install it with pip:



.. code:: bash



    $ pip install ppci



Usage

-----



An example of commandline usage:



.. code:: bash



    $ cd examples/linux64/hello-make

    $ ppci-cc -c -O1 -o hello.o hello.c

    ...

    $ ppci-ld --entry main --layout linux64.ld hello.o -o hello

    ...

    $ ./hello

    Hello, World!



API example to compile C code:



.. code-block:: python



    >>> import io

    >>> from ppci.api import cc, link

    >>> source_file = io.StringIO("""

    ...  int printf(char* fmt) { }

    ...  

    ...  void main() {

    ...     printf("Hello world!\n");

    ...  }

    ... """)

    >>> obj = cc(source_file, 'arm')

    >>> obj = link([obj])



Example how to assemble some assembly code:



.. code-block:: python



    >>> import io

    >>> from ppci.api import asm

    >>> source_file = io.StringIO("""section code

    ... pop rbx

    ... push r10

    ... mov rdi, 42""")

    >>> obj = asm(source_file, 'x86_64')

    >>> obj.get_section('code').data

    bytearray(b'[ARH\xbf*\x00\x00\x00\x00\x00\x00\x00')



Example of the low level api usage:



.. code-block:: python



    >>> from ppci.arch.x86_64 import instructions, registers

    >>> i = instructions.Pop(registers.rbx)

    >>> i.encode()

    b'['



Functionality

-------------



- `Command line utilities `_:

    - `ppci-cc `_

    - `ppci-ld `_

    - and many more.

- Can be used with tools like make or other build tools.

- `Language support `_:

    - `C `_

    - Pascal

    - Python

    - Basic

    - Brainfuck

    - `C3 `_

      (PPCI's own systems language, intended to address some pitfalls of C)

- CPU support:

    - 6500, arm, avr, m68k, microblaze, msp430, openrisc, risc-v, stm8, x86_64, xtensa

- Support for:

    - `WebAssembly `_

    - JVM

    - OCaml bytecode

    - LLVM IR

    - DWARF debugging format

- `File formats `_:

    - ELF files

    - COFF PE (EXE) files

    - hex files

    - S-record files

- Uses well known human-readable and machine-processable formats like JSON and XML as

  its tools' formats.



Documentation

-------------



Documentation can be found here:



- https://ppci.readthedocs.io/



.. warning::



    **This project is in alpha state and not ready for production use!**



You can try out PPCI at godbolt.org, a site which offers Web access to

various compilers: https://godbolt.org/g/eooaPP



|gitter|_

|appveyor|_

|codecov|_

|docstate|_

|travis|_

|codacygrade|_

|codacycoverage|_

|downloads|_

|conda|_



.. |codecov| image:: https://codecov.io/bb/windel/ppci/branch/default/graph/badge.svg

.. _codecov: https://codecov.io/bb/windel/ppci/branch/default



.. |appveyor| image:: https://ci.appveyor.com/api/projects/status/h0h5huliflrac65o?svg=true

.. _appveyor: https://ci.appveyor.com/project/WindelBouwman/ppci-786



.. |docstate| image:: https://readthedocs.org/projects/ppci/badge/?version=latest

.. _docstate: https://ppci.readthedocs.io/en/latest



.. |travis| image:: https://travis-ci.org/windelbouwman/ppci.svg?branch=master

.. _travis: https://travis-ci.org/windelbouwman/ppci



.. |codacygrade| image:: https://api.codacy.com/project/badge/Grade/a178be14a54243be81c27172031dc82c

.. _codacygrade: https://www.codacy.com/app/windel-bouwman/ppci-mirror



.. |codacycoverage| image:: https://api.codacy.com/project/badge/Coverage/a178be14a54243be81c27172031dc82c

.. _codacycoverage: https://www.codacy.com/app/windel-bouwman/ppci-mirror



.. |downloads| image:: https://anaconda.org/conda-forge/ppci/badges/downloads.svg

.. _downloads: https://anaconda.org/conda-forge/ppci



.. |conda| image:: https://anaconda.org/conda-forge/ppci/badges/version.svg

.. _conda: https://anaconda.org/conda-forge/ppci



.. |gitter| image:: https://badges.gitter.im/ppci-chat/Lobby.svg

.. _gitter: https://gitter.im/ppci-chat/Lobby