yog-script-analyze 0.2.4

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

//! `local` — a local of the patched method.

use crate::ast::{Local, Point};
use crate::parser::{PResult, Parser};
use crate::source::token::Punct;
use crate::words::{Role, Word, r#mut, uses};

pub static WORD: Word = Word {
    text: "local",
    doc: "A local of the patched method, by name (the class index keeps the game's local names) or by \
          type and order (`#1`): `uses local i64 start` reads it, `mut local` writes it back; inside a \
          method, `local f32 speed = speed * 2;` changes it (`@ModifyVariable`).",
    reserved: false,
    roles: &[Role::Point { parse }],
};

fn parse(p: &mut Parser) -> PResult<Point> {
    let local = declared(p, false)?;
    p.need(Punct::Eq)?;
    let value = p.expr()?;
    p.end()?;
    Ok(Point::Local { local, value })
}

/// `local Type name (#n)?` (after `mut` when `write`).
fn declared(p: &mut Parser, write: bool) -> PResult<Local> {
    p.need_word(&WORD)?;
    let ty = p.ty()?;
    let name = p.name("a local's name")?;
    let ordinal = if p.eat(Punct::Hash) { Some(p.int("the local's place among its type")?) } else { None };
    Ok(Local { write, ty, name, ordinal })
}

/// `uses local …, mut local …`, or none.
pub(crate) fn uses(p: &mut Parser) -> PResult<Vec<Local>> {
    if !p.eat_word(&uses::WORD) {
        return Ok(Vec::new());
    }
    let mut out = Vec::new();
    loop {
        let write = p.eat_word(&r#mut::WORD);
        out.push(declared(p, write)?);
        if !p.eat(Punct::Comma) {
            return Ok(out);
        }
    }
}