Standard Library

Modules & Context Notes

Modules (include)

include "path/to/file.aug" runs another file's top-level statements into the current scope, so its rituals and summons become available — the way to split a program across files. Paths resolve from the working directory, and a given file is included at most once (cycles are safe).

include "lib/hash.aug"        // defines ritual hash(...)
include "lib/store.aug"       // defines ritual store()
proclaim hash("hunter2")

Comments & context notes

// line comment - discarded
/* block
   comment - discarded */
/// context note - NOT discarded

A /// line is a context note. Its text is collected and injected into the oracle prompt for the statement that follows it, under a Context notes: heading. Use it to steer divinations.

/// prices are in BRL, round to 2 decimals
summon total = price * quantity