ghul.compiler
0.6.5
See the version list below for details.
dotnet tool install --global ghul.compiler --version 0.6.5
dotnet new tool-manifest # if you are setting up this repo dotnet tool install --local ghul.compiler --version 0.6.5
#tool dotnet:?package=ghul.compiler&version=0.6.5
nuke :add-package ghul.compiler --version 0.6.5
ghūl compiler
This package contains the ghūl programming language compiler packaged as a .NET tool
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 targets package for
a minimal 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 | Versions 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. |
This package has no dependencies.
Version | Downloads | Last updated |
---|---|---|
0.8.45 | 84 | 4/17/2024 |
0.8.44 | 106 | 4/17/2024 |
0.8.43 | 127 | 4/15/2024 |
0.8.42 | 133 | 4/15/2024 |
0.8.41 | 117 | 4/13/2024 |
0.8.40 | 141 | 4/12/2024 |
0.8.39 | 138 | 4/11/2024 |
0.8.38 | 91 | 4/10/2024 |
0.8.37 | 138 | 4/10/2024 |
0.8.36 | 173 | 4/3/2024 |
0.8.35 | 154 | 4/1/2024 |
0.8.34 | 196 | 3/31/2024 |
0.8.33 | 273 | 3/31/2024 |
0.8.32 | 221 | 3/31/2024 |
0.8.31 | 204 | 3/30/2024 |
0.8.30 | 201 | 3/30/2024 |
0.8.29 | 196 | 3/30/2024 |
0.8.28 | 163 | 3/29/2024 |
0.8.27 | 248 | 3/26/2024 |
0.8.26 | 222 | 3/21/2024 |
0.8.25 | 250 | 3/19/2024 |
0.8.24 | 362 | 3/19/2024 |
0.8.23 | 229 | 3/18/2024 |
0.8.22 | 281 | 3/15/2024 |
0.8.21 | 211 | 3/14/2024 |
0.8.20 | 329 | 3/13/2024 |
0.8.19 | 351 | 3/13/2024 |
0.8.18 | 296 | 3/13/2024 |
0.8.17 | 341 | 3/12/2024 |
0.8.16 | 250 | 3/11/2024 |
0.8.15 | 285 | 3/11/2024 |
0.8.14 | 328 | 3/11/2024 |
0.8.13 | 348 | 3/10/2024 |
0.8.12 | 289 | 3/10/2024 |
0.8.11 | 209 | 3/4/2024 |
0.8.10 | 373 | 3/4/2024 |
0.8.9 | 384 | 3/2/2024 |
0.8.8 | 325 | 3/2/2024 |
0.8.7 | 346 | 3/2/2024 |
0.8.6 | 309 | 3/1/2024 |
0.8.5 | 396 | 3/1/2024 |
0.8.4 | 327 | 2/29/2024 |
0.8.3 | 421 | 2/27/2024 |
0.8.2 | 364 | 2/26/2024 |
0.8.1 | 328 | 2/21/2024 |
0.8.0 | 335 | 2/21/2024 |
0.7.13 | 369 | 2/21/2024 |
0.7.12 | 477 | 2/21/2024 |
0.7.11 | 340 | 2/20/2024 |
0.7.10 | 325 | 2/20/2024 |
0.7.9 | 511 | 2/19/2024 |
0.7.8 | 471 | 2/17/2024 |
0.7.7 | 320 | 2/16/2024 |
0.7.6 | 294 | 2/15/2024 |
0.7.5 | 439 | 2/14/2024 |
0.7.4 | 566 | 2/13/2024 |
0.7.3 | 517 | 2/13/2024 |
0.7.2 | 443 | 2/9/2024 |
0.7.1 | 352 | 2/8/2024 |
0.7.0 | 462 | 2/7/2024 |
0.6.21 | 462 | 2/7/2024 |
0.6.20 | 404 | 2/6/2024 |
0.6.19 | 589 | 2/6/2024 |
0.6.18 | 438 | 2/6/2024 |
0.6.17 | 524 | 2/6/2024 |
0.6.16 | 431 | 2/4/2024 |
0.6.15 | 454 | 2/2/2024 |
0.6.14 | 496 | 2/1/2024 |
0.6.13 | 635 | 1/29/2024 |
0.6.12 | 534 | 1/29/2024 |
0.6.11 | 527 | 1/29/2024 |
0.6.10 | 363 | 1/29/2024 |
0.6.9 | 405 | 1/26/2024 |
0.6.8 | 346 | 1/25/2024 |
0.6.7 | 515 | 1/23/2024 |
0.6.6 | 400 | 1/22/2024 |
0.6.5 | 482 | 1/19/2024 |
0.6.4 | 434 | 1/19/2024 |
0.6.3 | 445 | 1/16/2024 |
0.6.2 | 784 | 12/6/2023 |
0.6.1 | 896 | 12/6/2023 |
0.6.0 | 774 | 12/6/2023 |
0.5.31 | 1,124 | 3/15/2023 |
0.5.30 | 1,057 | 3/14/2023 |
0.5.28 | 1,018 | 3/14/2023 |
0.5.27 | 1,017 | 3/14/2023 |
0.5.26 | 930 | 3/14/2023 |
0.5.25 | 946 | 3/14/2023 |
0.5.24 | 1,074 | 3/14/2023 |
0.5.23 | 1,040 | 3/14/2023 |
0.5.21 | 1,069 | 3/10/2023 |
0.5.19 | 959 | 3/10/2023 |
0.5.17 | 1,169 | 3/10/2023 |
0.5.15 | 1,346 | 3/7/2022 |
0.5.14 | 1,291 | 2/27/2022 |
0.5.13 | 976 | 2/27/2022 |
0.5.12 | 1,251 | 2/27/2022 |
0.5.11 | 1,166 | 2/13/2022 |
0.5.10 | 952 | 1/12/2022 |
0.5.9 | 1,080 | 1/5/2022 |
0.5.8 | 855 | 1/5/2022 |
0.5.7 | 918 | 1/4/2022 |
0.5.6 | 875 | 1/3/2022 |
0.5.5 | 1,126 | 1/3/2022 |
0.5.4 | 1,062 | 1/3/2022 |
0.5.3 | 1,062 | 1/3/2022 |
0.5.2 | 1,095 | 12/31/2021 |
0.5.1 | 978 | 12/31/2021 |
0.5.0 | 914 | 12/29/2021 |
0.4.1 | 1,063 | 12/26/2021 |
0.4.0 | 1,013 | 12/26/2021 |
0.3.4 | 1,188 | 12/22/2021 |
0.3.3 | 1,094 | 12/21/2021 |
0.3.2 | 1,124 | 12/21/2021 |
0.2.166 | 990 | 12/21/2021 |
0.2.165 | 1,028 | 12/21/2021 |
0.2.164 | 986 | 12/20/2021 |
0.2.163 | 979 | 12/18/2021 |
0.2.161 | 1,005 | 12/17/2021 |
0.2.160 | 887 | 12/17/2021 |
0.2.159 | 992 | 12/17/2021 |
0.2.158 | 980 | 12/15/2021 |
0.2.157 | 910 | 12/14/2021 |
0.2.154 | 1,314 | 12/8/2021 |
0.2.153 | 1,119 | 12/7/2021 |
0.2.152 | 1,004 | 12/6/2021 |
0.2.151 | 957 | 12/6/2021 |
0.2.150 | 1,249 | 12/6/2021 |
0.2.149 | 1,309 | 12/6/2021 |
0.2.148 | 1,075 | 12/5/2021 |
0.2.147 | 1,030 | 12/5/2021 |
0.2.146 | 983 | 12/5/2021 |
0.2.145 | 686 | 12/5/2021 |
0.2.144 | 973 | 12/5/2021 |
0.2.143 | 890 | 12/5/2021 |
0.2.142 | 1,048 | 12/5/2021 |
0.2.141 | 1,471 | 12/4/2021 |
0.2.140 | 1,048 | 12/4/2021 |
0.2.139 | 1,054 | 12/1/2021 |
0.2.137 | 943 | 11/18/2021 |
0.2.136 | 1,079 | 10/27/2021 |
0.2.135 | 973 | 10/27/2021 |
0.2.135-alpha.1 | 185 | 10/27/2021 |
0.2.134 | 1,065 | 2/7/2021 |
0.2.133 | 1,077 | 2/3/2021 |
0.2.132 | 1,175 | 1/31/2021 |
0.2.131 | 1,023 | 1/30/2021 |
0.2.130 | 1,092 | 1/30/2021 |
0.2.129 | 1,183 | 1/28/2021 |
0.2.128 | 1,169 | 1/27/2021 |
0.2.127 | 1,143 | 1/27/2021 |
0.2.126 | 897 | 1/25/2021 |
0.2.125 | 1,197 | 1/24/2021 |
0.2.124 | 1,122 | 1/23/2021 |
0.2.123 | 1,098 | 1/23/2021 |
0.2.122 | 1,278 | 1/21/2021 |
0.2.121 | 1,207 | 1/20/2021 |
0.2.120 | 1,189 | 1/20/2021 |
0.2.119 | 1,188 | 1/20/2021 |
0.2.118 | 1,291 | 1/20/2021 |
0.2.117 | 1,194 | 1/19/2021 |
0.2.116 | 1,152 | 1/17/2021 |
0.2.115 | 1,536 | 1/16/2021 |
0.2.114 | 1,343 | 1/15/2021 |
0.2.113 | 1,139 | 1/14/2021 |
0.2.112 | 1,300 | 1/13/2021 |
0.2.111 | 1,363 | 1/10/2021 |
0.2.110 | 1,390 | 1/9/2021 |
0.2.109 | 1,085 | 1/8/2021 |
0.2.108 | 1,180 | 1/8/2021 |
0.2.107 | 1,306 | 1/7/2021 |
0.2.106 | 1,358 | 1/6/2021 |
0.2.105 | 1,321 | 1/3/2021 |
0.2.104 | 1,409 | 1/2/2021 |