asa 1.0.0

Advanced Subleq Assembler. Assembles 'sublang' to subleq
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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90

//! Parses a vector of tokens
mod labels;
mod literals;
mod macros;
mod other;

use log::LevelFilter;

use crate::parser::labels::*;
use crate::parser::literals::*;
use crate::parser::macros::*;
use crate::parser::other::*;
use crate::tokens::dump_tokens;
use crate::tokens::{Token, TokenVariant};

#[cfg(not(tarpaulin_include))]
fn debug_print_tokens(tokens: &[Token], message: &str) {
    if log::max_level() >= LevelFilter::Debug {
        log::debug!("{message}");
        for token in tokens {
            if let TokenVariant::Linebreak = token.variant {
                println!();
                continue;
            }
            print!("{token:?}  ");
        }
        println!();
    }
}

pub fn parse(mut tokens: Vec<Token>) -> Vec<Token> {
    char_and_hex_to_dec_and_check_scopes(&mut tokens);

    let tokens = grab_braced_label_definitions(tokens);
    let tokens = handle_assignments(&tokens);

    let (mut tokens, macros) = read_macros(&tokens);

    if log::max_level() >= LevelFilter::Debug {
        log::debug!("Found macros:");
        for i in &macros {
            println!("{:?}", i.1);
        }
        println!();
    }

    tokens = insert_macros(tokens, &macros, vec![]);

    debug_print_tokens(&tokens, "Inserted macros:");

    let tokens = convert_strings(tokens);
    let tokens = expand_mults(&tokens);
    let tokens = expand_derefs(&tokens);

    debug_print_tokens(&tokens, "Derefs and Literals:");

    if log::max_level() >= LevelFilter::Debug {
        dump_tokens(&tokens).unwrap_or_else(|e| log::warn!("Failed to dump tokens. {e}"));
    }

    let mut tokens = fix_instructions_and_collapse_label_definitions(&tokens);
    // From this point forwards, memory addresses are fixed.
    if log::max_level() >= LevelFilter::Debug {
        log::debug!("Fixed");
        for statement in &tokens {
            println!("{statement:?}");
        }
        println!();
    }

    let scoped_label_table = assign_addresses_to_labels(&tokens);

    if log::max_level() >= LevelFilter::Debug {
        log::debug!("Label Table");

        println!("{scoped_label_table:?}");
        println!();
    }
    resolve_labels_and_relatives(&mut tokens, &scoped_label_table);

    if log::max_level() >= LevelFilter::Debug {
        log::debug!("Resolved Labels");

        for statement in &tokens {
            println!("{statement:?}");
        }
    }

    tokens
}