brendanzab / compiling-to-assembly-from-scratch

Source code for the book Compiling to Assembly from Scratch https://keleshev.com/compiling-to-assembly-from-scratch-the-book

Compiling to Assembly from Scratch

This repository contains source code from the book Compiling to Assembly from Scratch, including ports to other langauges (currently Python and OCaml).

Structure

• part-1 folder contains the baseline compiler from Part I of the book.
• part-2 folder contains the extended compiler from Part II of the book.
• contrib folder is for other versions of the compiler. Currently Python and OCaml ports are included and contributions are welcome.

Running the code

The book's compilers are wirtten in TypeScript, so you need to install the TypeScript compiler. TypeScript compiles to JavaScript, so you need Node to run it in a non-browser environment (however, it works in browser too).

Rasperry Pi

Install Node and TypeScript:

$ sudo apt-get install npm
$ sudo npm install -g typescript

Now you've got everything necessary to run the compiler's test suite. No emulation or cross-assembling necessary.

$ make CC=gcc RUN=''

x86-64 Linux

This assumes apt-get package manager.

Install TypeScript (and Node, as a dependency):

$ sudo apt-get install npm
$ sudo npm install -g typescript

Install GCC toolchain that targets 32-bit ARM:

$ sudo apt-get install gcc-arm-linux-gnueabihf

Install QEMU emulator:

$ sudo apt-get install qemu-user-static

Run baseline compiler's test suite:

$ make CC='arm-linux-gnueabihf-gcc -static' RUN='qemu-arm-static'

Contribution

You are welcome to contribute your version of the book's compiler. Make a pull request into the contrib directory.