Libraries

Libraries add reusable names and language behavior to the active environment. Start with a standard library whose job matches your application, then follow its own guide sequence.

Import a vocabulary

import shell
let run_example = fn () -> i64 {
    return run printf "hello\n"
}
assert run_example() == 0

Import by name loads the corresponding installed engine image. Keep the image's dependencies available with it. Importing a library can add syntax as well as functions; explicit selectors help when vocabularies accept overlapping forms.

Choose a library

Reuse source files

include evaluates source in the current language context. An imported image restores a previously exported vocabulary. Choose source inclusion for source-level composition and images for a reusable packaged vocabulary; neither implies that arbitrary native resources can be persisted in an image.