ghul.compiler 0.2.143

ghūl compiler

Compiler for the ghūl programming language

Latest compiler .NET tool package

ghul.compiler

Latest release

Release

Continuous delivery status

Host and target

The compiler is hosted on .NET and targets .NET

Getting started

Template ghūl application project

If you only want to use the compiler to build an application, as opposed to contributing to the development of the compiler itself, then take a look at the ghūl console template repository

Build time dependencies for the compiler itself

• Linux (native, WSL2, or in a container)
• The .NET 6.0 SDK
• Bash

See the template application README for detailed instructions on setting up your build environment

Optional dependencies

• Visual Studio Code will give you rich language support via the ghūl VSCode language extension.

Runtime dependencies for ghūl applications

• .NET 6.0

Building applications with ghūl

The hello-world project shows a small example ghūl program, with VSCode config and an example GitHub build workflow

To build the compiler from Visual Studio Code

• Build the compiler: <Ctrl>+<Shift>+B
• Run all the integration tests: <Ctrl>+<Shift>+P | Tasks: Run task | Run all integration tests

To build and test the compiler from the command line

• Build the compiler: `./build/build.sh
• Run all unit tests: dotnet test unit-tests
• Run all integration tests: ./integration-tests/test.sh
• Run a specific integration test: ./integration-tests/test.sh test-case-folder-name
• Capture a failed integration test's output as its new expected output: ./integration-tests/capture.sh test-case-folder-name
• Bootstrap the compiler: ./build/bootstrap.sh
• Start an interactive shell in the development container: ./build/dev.sh

Gotchas

This is an incomplete compiler for an experimental programming language. The CI/CD pipeline ensures that a released build will bootstrap and pass the test suite, but nevertheless some features are missing or buggy.