ghul.runtime 25.6.0

ghūl compiler runtime library

This package provides:

• internal types required by all ghūl applications
• support for the ghūl pipe operator and fluent methods on pipes, such as filter, map and reduce
• slice, which takes part of an array, list or string: xs |> slice(1..4). An array or a list is sliced without copying, so a later change to the source shows through
• function combinators, in Ghul and so in scope without a use: f >> g composes left to right and f << g right to left, keeping the multi-argument stage's own arity - add >> tag composes a two-argument add with a unary tag and calls it as tagged(4, 5); curry and uncurry reshape a two-argument function in either direction; memoize(f) answers from a cache of the results f has already computed, keyed on the whole argument tuple; and apply(f, x, y) calls a function of any arity with the arguments of the call itself
• retry(f, attempts) calls f, retrying the whole call up to the given number of times when it throws and throwing the last failure when every attempt does; the wrapped function keeps f's own arity
• Ghul.Coroutines, cooperative coroutines: asynchronous functions returning COROUTINE[T] or COROUTINE, which one coroutine awaits as it would call a function. pause() gives up the turn, sleep(milliseconds) gives it up until a deadline, run() resumes parked coroutines one at a time, CHANNEL[T] hands values between them, and MUTEX and SEMAPHORE guard what they share. All of it runs on one thread, on a default SCHEDULER unless one is named. A coroutine can also await a task or any other awaitable: run() waits for it and resumes the coroutine on its own thread. Where that thread cannot block, such an await is reported as an error
• MSBuild targets needed to build ghūl projects

Building a library or an executable

The targets follow the standard OutputType property:

• Library (the .NET SDK's default when the project does not set one) builds a library. It needs no entry() function.
• Exe or WinExe builds an executable, which needs an entry() function.

Other values are rejected. To choose directly, regardless of OutputType, set GhulLibrary to true or false.

<PropertyGroup>
  <OutputType>Library</OutputType>
</PropertyGroup>

The WebAssembly target

Under --target wasm the runtime is compiled from source together with ghul-core, which supplies the types .NET supplies on the other target. wasm-sources.rsp lists the files a wasm build compiles, one a line, to be passed to the compiler after ghul-core's sources. Within those files, @IF.dotnet() marks what is compiled only for .NET and @IF.wasm() what is compiled only for WebAssembly. What is not yet available on the wasm target is tracked on ghul-lang/ghul#3319.

wasm-tests/ holds programs that build for the wasm target from this checkout's sources and run under Node, each a ghul-cli project whose run.expected is what the same program prints on .NET. Run them with dotnet ghul-test --use-ghul-cli --ghul "dotnet ghul" --target wasm wasm-tests.

Issues

View open issues or raise a new one.