bpp

README

B++

A B++ parser, interpreter, and compiler written in Go! Check the docs for more information on the B++ language and how it works, and the programming guide on how to import and use this library, with your code!

Installation

To install or update B++, do

go get -u github.com/Nv7-Github/bpp

Usage

To run a file, do

bpp run <filename>

For example, to run the kin example, do

bpp run examples/kin.bpp

B++ programs support arguments. To pass arguments, use --args with comma-seperated values. For example:

bpp run --args arg1,arg2,arg3 <filename>

You can time how long it takes to run a B++ program, using --time or -t. For example:

bpp run -t <filename>

Converting Go Programs

It can be hard to write B++ code, so you can convert Go code to B++! Lets say you have a file called factorial.go:

package main

func factorial(num int) int {
  result := 1
  if num >= 1 {
    result = factorial(num - 1) * num
  }
  return result
}

func main() {
  print(factorial(10))
}

Well, you can just do

bpp convert factorial.go

To convert it to B++ code, saved in the file factorial.bpp!

You can also use the -o parameter to specify the output file, like:

bpp convert factorial.go -o coolprogram.bpp

To save the B++ code to a file called coolprogram.bpp!

Compiling Programs

bpp also supports compiling B++ programs into a native, extremely high-performance executable! You can use --time or -t with this too.

⚠ Arrays are not supported!

To compile a program, just do

bpp build <filename>

You can also use -o or --output to specify the output file. For example, to compile the kin example, do:

bpp build -o kin examples/kin.bpp

This will produce LLVM IR. To convert it into an executable, use an LLVM compiler, like

bpp build <filename> -cc clang

Multiple Files

For both build and run, you can pass multiple files. These can be used with an IMPORT statement. To pass multiple files, do

bpp run main.bpp file1.bpp file2.bpp

You can also use directories, like:

bpp build .

⚠ If you are using more than one file, there must be a file called main.bpp, which will be run.