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
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="ghul.project" Version="10.7.1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="ghul.project" Version="10.7.1" />
                    
Directory.Packages.props
<PackageReference Include="ghul.project" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add ghul.project --version 10.7.1
                    
#r "nuget: ghul.project, 10.7.1"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package ghul.project@10.7.1
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=ghul.project&version=10.7.1
                    
Install as a Cake Addin
#tool nuget:?package=ghul.project&version=10.7.1
                    
Install as a Cake Tool

ghul.project

CI License ghūl

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 one
  • kind — program
  • targets — ["dotnet"]
  • sources — ["src/**/*.ghul"]
  • compiler — whatever compiler is installed
  • options — the compiler's own defaults
  • dependencies — 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 kind or 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 git and a path, or with neither
  • a git dependency with neither a tag nor a branch

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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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
Loading failed