yog-script-analyze 0.2.2

Yog Script (.ys, .yns) analyzed: its lexer, parser and syntax tree, names resolved, the class index model — what the build and the editors read a source with.
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
43
44
45
46
47
48
49
50
51
52
53
54
55
56

//! The System library's declarations (`system/*.ys`), read once and seen
//! by every source as its own types are, namespace `System`.

use yog_sync::LazyLock;

use crate::ast::Decl;

/// Every namespace of the library and of what a source reaches starts
/// here: `System`, `System.Yog` (Yog's objects), `System.Game` (the game's
/// classes, a `.yns`'s).
pub const ROOT: &str = "System";

/// The enum whose cases a source calls without its name (`Ok(v)`,
/// `Err(e)`), as Rust's prelude brings them.
pub const RESULT: &str = "Result";

/// The attribute that runs derive macros on a type: `[Derive(Clone)]`.
pub const DERIVE: &str = "Derive";

/// What a derive macro is given and its fields (`System.Meta`).
pub const ITEM: &str = "Item";
pub const FIELD: &str = "Field";

/// The attributes marking macros' methods (`System.Meta`).
pub const PROC_MACRO: &str = "ProcMacro";
pub const DERIVE_MACRO: &str = "DeriveMacro";

/// The attribute marking an attribute class as an attribute macro (`System`).
pub const MACRO: &str = "Macro";

/// An indexer's member name (`x[i]`): C#'s `IndexerName` default, the
/// CLR's `get_Item` / `set_Item` — what inheritance and the JVM call it.
pub const INDEXER: &str = "Item";

/// The bus's attributes (`System.Yog.Native`): a call, an event, a method provided.
pub const SERVICE: &str = "Service";
pub const EVENT: &str = "Event";
pub const PROVIDE: &str = "Provide";

/// The System library's sources, by file name.
const SOURCES: &[(&str, &str)] = &[
    ("System.ys", include_str!("system/System.ys")),
    ("System.Meta.ys", include_str!("system/System.Meta.ys")),
    (
        "System.Yog.Native.ys",
        include_str!("system/System.Yog.Native.ys"),
    ),
];

/// Every declaration of the library, parsed once.
pub static DECLS: LazyLock<Vec<Decl>> = LazyLock::new(|| {
    SOURCES
        .iter()
        .flat_map(|(name, src)| crate::parse(name, src).file.decls)
        .collect()
});