README.md

Spl

Simple programming language

Quick start

Bootstrapping

This compiler is self-hosted and needs to be bootstrapped.

$ make bootstrap

Compiling

Compiling is as simple as it gets, pass the file of source code that you want to be compiled.

$ ./spl <program>

And that's it.

Options

There are a number of configurable options that you can pass to the compiler. To view those, run the compiler without any arguments.

$ ./spl
Usage; ./spl [OPTIONS]

OPTIONS:
  <filename>      - path to file
  run             - run program directly
  no-com          - do not compile target executable
  debug-output    - write debug information
  enable-warnings - enable basic warnings
  disable-dce     - disable dead code elimination
  disable-colors  - disable colored text output
  verbose         - enable verbose output
  verbose-asm     - enable verbose assembly code
  version         - print spl version id
  help            - show help menu

Examples

Hello, World:

include "lib/common.spl"

fn main -> none {
  printf("Hello, World\n", null);
}

Program that counts from 0 to 9:

fn main -> none {
  let i = 0;
  let count = 10;
  while < i count {
    print i;
    store64 @i + 1 i;
  }
}

You can find more examples in the examples directory, or you could read the compiler source code to get familiar with the language.