Emela Standard Library

The Emela standard library, distributed as a Pome (spec 0032).

• Source path: github.com/emela-lang/stdlib
• Import root: std (declared by [pome].module in Pome.toml; without it the root would default to the source-path leaf stdlib)

A Pome is Emela's unit of distribution: one or more modules supplied as a Git repository, identified by its source path and versioned by v-prefixed semver git tags. There is no central registry — a Pome is fetched straight from the repository its source path names.

Layout

Modules live under src/, one file per module. Pome.toml at the root declares the Pome's identity.

stdlib/
  Pome.toml
  src/
    clock.emel
    int.emel
    io.emel
    list.emel
    option.emel
    ord.emel

Use as a dependency

From inside your own Pome:

emela pome add github:emela-lang/stdlib   # fetch, pin in Pome.lock, audit capabilities
emela build src/main.emel                 # dependencies are on the import path automatically

Once it is a dependency, the modules are addressed under the import root std, so src/io.emel (module io) is used as:

import std.io.print   -- callable as print, io.print, or std.io.print

emela pome add records the dependency in your Pome.toml under its canonical source path and pins the resolved tag + commit + content hash in Pome.lock. Because a Pome's required capabilities are computable from source (spec 0025), it also prints the capability set this library requires before committing.

Modules

• std.clock — monotonic time (now). Requires the clock capability.
• std.int — integer helpers (abs, signum, is_even, is_odd, pow, gcs).
• std.io — standard output / error (print, eprint). Requires the io capability.
• std.list — the List<T> type and operations (length, is_empty, head, tail, prepend, reverse, append, map, filter, fold, contains).
• std.option — helpers over the prelude Option<T> type.
• std.ord — ordering helpers (min, max, clamp).

Side effects enter only through platform functions (extern fn), resolved by the selected backend's runtime. A stdlib module wraps them so app code never names a backend directly (see src/io.emel, src/clock.emel).

Publishing

Publishing is just tagging — there is no central publish step:

git tag v0.1.0 && git push origin v0.1.0

Consumers can then depend on github.com/emela-lang/stdlib with a version requirement such as ^0.1.

Local development

To resolve a dependency against a local checkout or mirror (offline development, CI), set EMELA_POME_REPLACE="github.com/emela-lang/stdlib=/path/to/stdlib"; EMELA_POME_CACHE redirects the fetch cache.