skip to navigation
skip to content

ppci 0.5.4

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

The ppci (pure python compiler infrastructure) project is a compiler written entirely in python. It contains language front-ends as well as machine code generation functionality. With this library you can generate (working!) machine code within python!

The project contains the following:

  • A Compiler, an assembler, a linker and a build system
  • Language front-ends: Brainfuck, c3
  • Backends: 6500, arm, avr, msp430, risc-v, stm8, x86_64, xtensa


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


Api example to compile c3 code:

>>> import io
>>> from ppci.api import c3c, link
>>> source_file = io.StringIO("""
... module main;
... function void print(string txt) {
... }
... function void main() {
...  print("Hello world");
... }""")
>>> obj = c3c([source_file], [], 'arm')
>>> obj = link([obj])

Example how to assemble some assembly code:

>>> 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

Example of the low level api usage:

>>> from ppci.arch.x86_64 import instructions, registers
>>> i = instructions.Pop(registers.rbx)
>>> i.encode()


Documentation can be found here:

File Type Py Version Uploaded on Size
ppci-0.5.4-py3-none-any.whl (md5) Python Wheel 3.6 2017-08-26 393KB
ppci-0.5.4.tar.gz (md5) Source 2017-08-26 354KB