alive developer documentation

This section documents the implementation of the alive language and copilot. It is relevant to everyone who is looking to modify, improve or extend alive with new modules, language or interpreter features.

If you are looking for the language reference for users, head over to the reference section of the documentation.

modules

• base: Base definitions for extensions.
• base.match: Pattern capturing for Op argument parsing.
• builtin: Builtin Builtins and Ops.
• init: alive public API.
• invoke: Builtins for invoking Ops and FnDefs.
• parsing: Lpeg Grammar for parsing alive code.
• stream: Stream interface and implementations.
• version: alive source code version information.

classes

• AST: AST Node Interface.
• Builtin: Builtin / Special Form evaluation Strategy (builtin).
• FnDef: user-function definition (fndef).
• Input: Update scheduling policy for Op arguments.
• Op: Persistent expression Operator.
• Cell: S-Expression Cell, implements the AST interface.
• Copilot: File watcher and CLI entrypoint.
• Error: Language error and traceback.
• Logger: Logger implementation.
• Module: Per-file execution context.
• Registry: Tag Registry.
• Result: Result of evaluating an expression.
• Scope: Mapping from syms to Results.
• Stream: base Stream interface.
• EventStream: Stream of momentary events.
• IOStream: Stream of external side-effects.
• ValueStream: Continuous stream of values.
• Tag: Identity provider for Cells and Builtins.

topics

• extensions.md