Skip to content
Go to file


Failed to load latest commit information.
Latest commit message
Commit time

Write a C Compiler!

This is a set of C test programs to help you write your own compiler. They were written to accompany this tutorial.


test all

./ /path/to/your/compiler

test specific stages

To test stage 1 and stage 3,

./ /path/to/your/compiler 1 3

To test from stage 1 to stage 6,

./ /path/to/your/compiler `seq 1 6`

In order to use this script, your compiler needs to follow this spec:

  1. It can be invoked from the command line, taking only a C source file as an argument, e.g.: ./YOUR_COMPILER /path/to/program.c

  2. When passed program.c, it generates executable program in the same directory.

  3. It doesn’t generate assembly or an executable if parsing fails (this is what the test script checks for invalid test programs).

The script doesn’t check whether your compiler outputs sensible error messages, but you can use the invalid test programs to test that manually.


Additional test cases welcome! You can also file issues here, either about the test suite itself or about the content of the tutorial.