alba-core 0.1.0

Core domain model for Alba: beams, Beamfiles, evaluation, and the beam graph
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

//! Core domain model for beams and Beamfiles.
//!
//! `alba-core` takes the AST `alba-syntax` produces and evaluates it into
//! the typed [`Project`] model the execution engine schedules: resolving
//! `let` bindings and `{expr}` interpolation, checking the small type
//! system (strings and booleans), and running the built-in `env()`/`glob()`
//! functions. See [`render_template`] and [`eval_expr`] for the
//! load-time-vs-schedule-time rendering split between a beam's fields.
//!
//! Multi-file loading (`import "path" as alias`, namespaced beam ids) is
//! [`load_project`]'s job, which also validates the resulting dependency
//! graph (unknown `needs` targets, `needs`-cycles) via [`validate_graph`]
//! before returning it. [`execution_subgraph`] extracts the transitive
//! closure of a target beam, for whichever engine schedules and runs it.
//! [`git`] wraps the `git` CLI, the only place in the workspace that spawns it.

mod error;
mod eval;
mod files;
pub mod git;
mod graph;
mod loader;
mod model;

pub use error::CoreError;
pub use eval::{Scope, eval_expr, render_template, suggest};
pub use files::{expand_globs, outputs_satisfied};
pub use graph::{execution_subgraph, validate_graph};
pub use loader::{LoadError, SourceMap, load_project};
pub use model::{Beam, BeamId, ExecutorKind, Hook, OptionValue, Project, SourceId, Value};

#[doc(hidden)]
pub use eval::load_str;