ghul.compiler 0.8.1

The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org. Prefix Reserved
dotnet tool install --global ghul.compiler --version 0.8.1
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest # if you are setting up this repo
dotnet tool install --local ghul.compiler --version 0.8.1
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=ghul.compiler&version=0.8.1
nuke :add-package ghul.compiler --version 0.8.1

ghūl compiler

CI/CD NuGet version (ghul.targets) Release Release Date Issues License ghūl

This package contains the ghūl programming language compiler packaged as a .NET tool

ghūl logo icon small

Prerequisites

The compiler requires the .NET 8.0 SDK

Target

The compiler produces standard .NET assemblies and packages targeting .NET 8.0

Getting the compiler

There are a few different ways to get the compiler - you might not need to use this package directly.

Use a ghūl .NET project template

If you initialize your project using one of the ghūl .NET project templates, the template will add the compiler to your project folder as a local .NET tool - just run dotnet tool restore to restore it.

Clone the ghūl GitHub repository template

If you create a new GitHub repo from the ghūl repository template, then the compiler will be pre-configured as a local .NET tool in your project folder - run dotnet tool restore to restore it.

Use the ghūl development container image

The compiler is pre-installed globally in the ghūl development container

Install the compiler as a local or global .NET tool

If none of the above options suits, you can manually install the compiler from this package - see below for details.

Using the compiler

Project file

The compiler expects to be driven by MSBuild using a .ghulproj project file. See the ghūl test package for a real-world example, or use one of the project templates to get started.

Source files

You'll need some ghūl source files. By convention ghūl source files have the extension .ghul, and the standard MSBuild targets will include **/*.ghul when building.

Building and running

Once you have a project file and some ghūl source files, you can use the normal .NET SDK commands to build, pack, and run your project:

dotnet build
dotnet pack
dotnet run

Runtime dependencies for ghūl applications

Applications written in ghūl require the .NET 8.0 runtime

Development environment

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

Manual compiler install

Local tool install

To install the compiler locally in your project folder:

dotnet new tool-manifest # if you don't already have a tool manifest file
dotnet tool install ghul.compiler # install the latest release of the compiler locally
dotnet ghul-compiler # run the compiler

A local tool install means you get a predictable compiler version on every build, provided you check in the tool manifest. It also means you can easily use different versions of the compiler for different projects on the same machine.

Global tool install

To install the compiler globally for the current user:

dotnet tool install --global ghul.compiler # install the latest release of the compiler globally
ghul-compiler # run the compiler

Gotchas

The ghūl language is sufficiently expressive and the compiler is stable enough for the compiler itself to be written in ghūl. However, this is an incomplete compiler for an experimental programming language: there will be compiler bugs!

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last updated
0.8.1 42 2/21/2024
0.8.0 34 2/21/2024
0.7.13 54 2/21/2024
0.7.12 72 2/21/2024
0.7.11 101 2/20/2024
0.7.10 70 2/20/2024
0.7.9 93 2/19/2024
0.7.8 91 2/17/2024
0.7.7 61 2/16/2024
0.7.6 81 2/15/2024
0.7.5 110 2/14/2024
0.7.4 148 2/13/2024
0.7.3 144 2/13/2024
0.7.2 122 2/9/2024
0.7.1 126 2/8/2024
0.7.0 187 2/7/2024
0.6.21 148 2/7/2024
0.6.20 123 2/6/2024
0.6.19 134 2/6/2024
0.6.18 152 2/6/2024
0.6.17 171 2/6/2024
0.6.16 143 2/4/2024
0.6.15 135 2/2/2024
0.6.14 129 2/1/2024
0.6.13 276 1/29/2024
0.6.12 204 1/29/2024
0.6.11 204 1/29/2024
0.6.10 143 1/29/2024
0.6.9 116 1/26/2024
0.6.8 118 1/25/2024
0.6.7 231 1/23/2024
0.6.6 181 1/22/2024
0.6.5 230 1/19/2024
0.6.4 148 1/19/2024
0.6.3 248 1/16/2024
0.6.2 472 12/6/2023
0.6.1 535 12/6/2023
0.6.0 453 12/6/2023
0.5.31 911 3/15/2023
0.5.30 818 3/14/2023
0.5.28 781 3/14/2023
0.5.27 731 3/14/2023
0.5.26 683 3/14/2023
0.5.25 642 3/14/2023
0.5.24 674 3/14/2023
0.5.23 766 3/14/2023
0.5.21 766 3/10/2023
0.5.19 771 3/10/2023
0.5.17 804 3/10/2023
0.5.15 1,038 3/7/2022
0.5.14 1,016 2/27/2022
0.5.13 753 2/27/2022
0.5.12 985 2/27/2022
0.5.11 912 2/13/2022
0.5.10 739 1/12/2022
0.5.9 751 1/5/2022
0.5.8 647 1/5/2022
0.5.7 652 1/4/2022
0.5.6 620 1/3/2022
0.5.5 909 1/3/2022
0.5.4 873 1/3/2022
0.5.3 800 1/3/2022
0.5.2 757 12/31/2021
0.5.1 676 12/31/2021
0.5.0 687 12/29/2021
0.4.1 869 12/26/2021
0.4.0 679 12/26/2021
0.3.4 881 12/22/2021
0.3.3 818 12/21/2021
0.3.2 812 12/21/2021
0.2.166 717 12/21/2021
0.2.165 757 12/21/2021
0.2.164 768 12/20/2021
0.2.163 755 12/18/2021
0.2.161 797 12/17/2021
0.2.160 632 12/17/2021
0.2.159 691 12/17/2021
0.2.158 743 12/15/2021
0.2.157 685 12/14/2021
0.2.154 1,065 12/8/2021
0.2.153 905 12/7/2021
0.2.152 697 12/6/2021
0.2.151 714 12/6/2021
0.2.150 910 12/6/2021
0.2.149 1,074 12/6/2021
0.2.148 815 12/5/2021
0.2.147 805 12/5/2021
0.2.146 685 12/5/2021
0.2.145 568 12/5/2021
0.2.144 665 12/5/2021
0.2.143 745 12/5/2021
0.2.142 754 12/5/2021
0.2.141 1,237 12/4/2021
0.2.140 799 12/4/2021
0.2.139 782 12/1/2021
0.2.137 735 11/18/2021
0.2.136 807 10/27/2021
0.2.135 736 10/27/2021
0.2.135-alpha.1 179 10/27/2021
0.2.134 858 2/7/2021
0.2.133 806 2/3/2021
0.2.132 899 1/31/2021
0.2.131 773 1/30/2021
0.2.130 865 1/30/2021
0.2.129 877 1/28/2021
0.2.128 813 1/27/2021
0.2.127 750 1/27/2021
0.2.126 666 1/25/2021
0.2.125 858 1/24/2021
0.2.124 823 1/23/2021
0.2.123 842 1/23/2021
0.2.122 1,000 1/21/2021
0.2.121 910 1/20/2021
0.2.120 931 1/20/2021
0.2.119 915 1/20/2021
0.2.118 1,050 1/20/2021
0.2.117 958 1/19/2021
0.2.116 898 1/17/2021
0.2.115 1,069 1/16/2021
0.2.114 929 1/15/2021
0.2.113 844 1/14/2021
0.2.112 964 1/13/2021
0.2.111 982 1/10/2021
0.2.110 1,039 1/9/2021
0.2.109 781 1/8/2021
0.2.108 920 1/8/2021
0.2.107 907 1/7/2021
0.2.106 1,038 1/6/2021
0.2.105 1,001 1/3/2021
0.2.104 1,071 1/2/2021