ghul.project
10.7.1
Prefix Reserved
dotnet add package ghul.project --version 10.7.1
NuGet\Install-Package ghul.project -Version 10.7.1
<PackageReference Include="ghul.project" Version="10.7.1" />
<PackageVersion Include="ghul.project" Version="10.7.1" />
<PackageReference Include="ghul.project" />
paket add ghul.project --version 10.7.1
#r "nuget: ghul.project, 10.7.1"
#:package ghul.project@10.7.1
#addin nuget:?package=ghul.project&version=10.7.1
#tool nuget:?package=ghul.project&version=10.7.1
ghul.project
Reads and checks a ghūl project's manifest — the ghul-project.json in a
project's root directory that says what the project is called, where its
sources are and what it depends on. Nothing here builds anything yet; this is
the model and the reader that later commands are written against.
using it
use Ghul.Project.MANIFEST_LOCATION
use Ghul.Project.MANIFEST_READER
let path = MANIFEST_LOCATION.find_in("/path/to/project")
if path? then
let outcome = MANIFEST_READER.read(IO.File.read_all_text(path!), path!)
case outcome
when manifest: ReadOutcome.OK then
write_line(manifest.name)
when ReadOutcome.PROBLEMS then
for problem in manifest.problems do
write_line("ghul: {problem.describe()}")
od
esac
fi
The reader takes text and the path it came from, and touches no file and no
network itself. MANIFEST_LOCATION.find_in looks in one directory and does not
search upwards: a project is what its own root says it is.
what a manifest says
{
"name": "example-app",
"version": "0.1.0",
"kind": "program",
"targets": ["wasm", "dotnet"],
"sources": ["src/**/*.ghul"],
"compiler": "64.5.38",
"options": {
"underscore-access": "private",
"global-namespace": false,
"default-use": ["Collections", "IO.Std.write_line"],
"define": [],
"suppress": [],
"warn-as-error": []
},
"dependencies": {
"ghul-runtime": { "git": "https://github.com/ghul-lang/ghul-runtime", "tag": "v31.0.1" },
"parsing": { "git": "https://example.com/libs.git", "branch": "main", "directory": "parsing" },
"scratch": { "path": "../scratch" }
}
}
Only name is required. What the rest default to when the manifest leaves them
out:
version— nothing; a manifest does not need onekind—programtargets—["dotnet"]sources—["src/**/*.ghul"]compiler— whatever compiler is installedoptions— the compiler's own defaultsdependencies— nothing
Comments and a trailing comma are allowed, since a manifest is written by hand.
what it checks
Every problem in a manifest is reported, not only the first, and each one names the key it is about:
- a missing
name, or one that is not lowercase letters, digits and-; a library's name also has to start with a letter, where a program's may start with a digit - a key that is not one the manifest may carry, at any level: the top level,
inside
options, inside a dependency, or inside a git dependency, so a misspelling is not silently ignored - a
kindor a target that is not one of the two - a member or option whose value is of the wrong shape
- a dependency with both a
gitand apath, or with neither - a git dependency with neither a
tagnor abranch
A manifest with any of those in it is not a manifest, so reading one returns the problems rather than a model that is partly made up.
what is not here yet
The lockfile, a git dependency at a branch rather than a tag, and dependencies for the dotnet target are the tasks that follow. See ghul-lang/ghul#3211.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- ghul.runtime (>= 42.0.0)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on ghul.project:
| Package | Downloads |
|---|---|
|
ghul.repl.host
Hosts a ghūl REPL session on this machine: compiles each cell with an installed ghul.compiler, kept running as a compile server with a fallback to starting it per cell, loads the result into a load context of the session's own, and runs it. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 10.7.1 | 0 | 11/19/2026 |
| 10.7.0 | 62 | 11/17/2026 |
| 10.6.1 | 90 | 11/16/2026 |
| 10.6.0 | 88 | 11/16/2026 |
| 10.5.0 | 104 | 11/16/2026 |
| 10.4.4 | 103 | 11/14/2026 |
| 10.4.3 | 98 | 11/14/2026 |
| 10.4.2 | 107 | 11/13/2026 |
| 10.4.1 | 105 | 11/13/2026 |
| 10.4.0 | 99 | 11/13/2026 |
| 10.3.3 | 94 | 11/13/2026 |
| 10.3.2 | 107 | 11/13/2026 |
| 10.3.1 | 99 | 11/12/2026 |
| 10.3.0 | 100 | 11/12/2026 |
| 10.2.0 | 105 | 11/12/2026 |
| 10.1.1 | 104 | 11/11/2026 |
| 10.1.0 | 100 | 11/11/2026 |
| 10.0.0 | 105 | 11/11/2026 |
| 9.8.0 | 103 | 11/11/2026 |
| 9.7.1 | 105 | 11/11/2026 |