sva-ast 0.3.0

The document model for a composition
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
34
35
36
37
38
39
40
41
42

// Concern: the document model for a composition | Non-concern: rendering or DSP (sva-engine), CLI wiring (sva-cli) | IO: (a Source) -> Graph or Vec<Refusal>

mod diag;
mod dir;
mod doc_comment;
mod expr;
mod filename;
mod graph;
mod ingest;
mod lexer;
mod parser;
mod print;
mod refusal;
mod skipped;
mod source;
mod tsv;

pub use diag::{ByteSpan, Diag, DiagCode};
pub use dir::Dir;
pub use doc_comment::{
    DocComment, MAX_TAG_CHARS, MAX_TAGS, is_plain_tag, parse as parse_doc_comment,
};
pub use expr::{Arg, BinOp, Binds, Expr, JOIN, Literal, SERIES, children, map_children};
pub use filename::{FileSpan, SpanUnit};
pub use graph::{Graph, VARIABLES, load, load_reaching, names_a_node, reads_of, resolve_ref_path};
pub use ingest::{Parsed, occurs_free, parse_file};
pub use lexer::ref_spans;
pub use parser::parse as parse_expr;
pub use print::render as render_expr;
pub use refusal::{Location, Refusal};
pub use skipped::{Skip, Skipped};
pub use source::{Composition, Listing, Source};
pub use tsv::Grid;

use std::path::Path;

/// No numeric evaluation happens here; that is `sva-engine`'s job.
pub fn parse_composition(dir: &Path) -> Result<Graph, Vec<Refusal>> {
    load(&Dir::at(dir))
}

pub const SOURCE_HASH: &str = env!("SVA_AST_SRC_HASH");