A compiled systems programming language written in Go using the LLVM framework
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples updated readme Feb 10, 2016
lib Fix typing of ftell. Mar 9, 2016
src
tests iterator panic Mar 14, 2016
tools libs + tools Feb 10, 2016
.gitignore
.travis.yml
CONTRIBUTING.md libs + tools Feb 10, 2016
LICENSE corrected the date in the license Jan 5, 2016
Makefile
README.md formatting Feb 10, 2016

README.md

Ark Build Status license

Ark is a systems programming language focused on being practical and pragmatic. We want a language that is simple, easy to write, yet powerful enough to create readable, performant and concise code for any problem

On the right is a gif of an example program ark-gl written in Ark using OpenGL and GLFW.

Index

Getting Involved

Check out the contributing guide, there's a lot of information there to give you ideas of how you can help out.

Example

Ark is still a work in progress, this code sample reflects what Ark can do currently, though the way you write the following will likely change in the near future.

More examples can be found here.

// binding to printf
[c] func printf(fmt: ^u8, ...);

pub func main(argc: int, argv: ^^u8) -> int {
    // accessed via the C module
    C::printf(c"Running %s\n", ^argv);

    // mutable i, type inferred
    mut i := 0;

    for i < 5 {
        C::printf(c"%d\n", i);

        i += 1;
    }
    return 0;
}

Installing

Installing Ark is simple, you'll need a few dependencies before you get started:

Dependencies

Building

Once you have your dependencies setup, building ark from scratch is done by running the following commands:

$ git clone https://github.com/ark-lang/go-llvm.git $GOPATH/src/github.com/ark-lang/go-llvm
$ cd $GOPATH/src/github.com/ark-lang/go-llvm
$ ./build.sh
$ go get github.com/ark-lang/ark/...

The ark binary will be built in $GOPATH/bin. To use the compiler, make sure $GOPATH/bin is in your $PATH.

Compiling Ark code

Currently the module system Ark uses is a work in progress. As of writing this, each ark file represents a module. A module has a child-module "C" which contains all of the C functions and other bindings you may write.

Given the following project structure:

src/
  - entities/
    - entity.ark
    - player.ark
  - main.ark

To compile this, you would pass through the file which contains the main entry point (main function) to your program, which is conventionally named "main.ark".

Since our main file is in another folder, we need to set the src folder as an include directory so that the compiler doesn't think it's a module. We use the -I flag for this:

ark build -I src src/main.ark --loglevel=debug

This should compile your code, and produce an executable called "main", which you can then run.

For more information on the module system and how it works, refer to the "Modules and Dependencies" section in the Ark reference.

For more information on program flags, refer to the "Program Input", section in the Ark reference.