celsium

Crates.iocelsium
lib.rscelsium
version0.1.5
sourcesrc
created_at2024-03-17 10:49:08.038218
updated_at2024-04-01 10:36:16.177825
descriptionA library for building interpreters
homepagehttps://github.com/MarcisAn/celsium
repositoryhttps://github.com/MarcisAn/celsium
max_upload_size
id1176379
size37,670
Mārcis (MarcisAn)

documentation

README

A rust library for building interpreters with WASM support

Basic usage

use celsium::block::Block;
use celsium::module::Module;
use celsium::{CelsiumProgram, BINOP, BUILTIN_TYPES};

fn main() {
    let mut celsium = CelsiumProgram::new();
    let mut main_module = Module::new("main", &mut celsium);

    let mut main_block = Block::new();
    {
        main_block.load_const(BUILTIN_TYPES::MAGIC_INT, "1");
        main_block.load_const(BUILTIN_TYPES::MAGIC_INT, "2");
        main_block.binop(BINOP::ADD);
        main_block.call_print_function(true);
    }
    //println!("{:?}", main_block.bytecode);
    main_module.add_main_block(main_block);

    celsium.add_module(&main_module);

    celsium.run_program();
}

If statements

let mut celsium = CelsiumProgram::new();
let mut main_module = Module::new("main", &mut celsium);
let mut main_block = Block::new();
{
    main_block.load_const(BUILTIN_TYPES::BOOL, "1");
    let mut if_block = Block::new();
    {
        if_block.load_const(BUILTIN_TYPES::STRING, "executed if block");
        if_block.call_print_function(true);
    }
    main_block.define_if_block(if_block);
    main_module.add_main_block(main_block);

    celsium.add_module(&main_module);

    celsium.run_program();
}

If Else statements

let mut celsium = CelsiumProgram::new();
let mut main_module = Module::new("main", &mut celsium);
let mut main_block = Block::new();
{
    main_block.load_const(BUILTIN_TYPES::BOOL, "1");
    let mut if_block = Block::new();
    {
        if_block.load_const(BUILTIN_TYPES::STRING, "executed if block");
        if_block.call_print_function(true);
    }
    let mut else_block = Block::new();
    {
        else_block.load_const(BUILTIN_TYPES::STRING, "executed else block");
        else_block.call_print_function(true);
    }
    main_block.define_if_else_block(if_block, else_block);
    main_module.add_main_block(main_block);

    celsium.add_module(&main_module);

    celsium.run_program();
}

Define functions

use celsium::block::Block;
use celsium::module::Module;
use celsium::{CelsiumProgram, BINOP, BUILTIN_TYPES};

fn main() {
    let mut celsium = CelsiumProgram::new();
    let mut main_module = Module::new("main", &mut celsium);

    let mut main_block = Block::new();

    let mut fn_block = Block::new();
        fn_block.load_const(BUILTIN_TYPES::STRING, "aaa");
        fn_block.call_print_function(true);

        main_module.define_function(
            fn_block,
            VISIBILITY::PRIVATE,
            FunctionSignature {
                name: "testfunction".to_owned(),
                return_type: FUNCTION_RETURN_TYPE::NONE,
                args: vec![],
            },
        );

    main_block.call_function("testfunction");
    //println!("{:?}", main_block.bytecode);
    main_module.add_main_block(main_block);

    celsium.add_module(&main_module);

    celsium.run_program();
}

Variables

use celsium::block::Block;
use celsium::module::Module;
use celsium::{CelsiumProgram, BINOP, BUILTIN_TYPES};

fn main() {
    let mut celsium = CelsiumProgram::new(false);
    let mut main_module = Module::new("main", &mut celsium);
    let mut main_block = Block::new();
    {
        main_block.load_const(BUILTIN_TYPES::MAGIC_INT, "2");
        main_block.define_variable(BUILTIN_TYPES::MAGIC_INT, VISIBILITY::PRIVATE,   "test_var");
        //variable is defined
        main_block.load_variable("test_var");
        main_block.call_print_function(true);
        //variable is printed
    }
    main_module.add_main_block(main_block);
    celsium.add_module(&main_module);
    celsium.run_program();
}

Simple loops

use celsium::block::Block;
use celsium::module::Module;
use celsium::{CelsiumProgram, BINOP, BUILTIN_TYPES};

fn main() {
    let mut celsium = CelsiumProgram::new(false);
        let mut main_module = Module::new("main", &mut celsium);
        let mut main_block = Block::new();

        let mut loop_block = Block::new();
        {
            loop_block.load_const(BUILTIN_TYPES::STRING, "I'm printing many times");
            loop_block.call_print_function(true);
        }
        let mut loop_count_block = Block::new();
        {
            loop_count_block.load_const(BUILTIN_TYPES::MAGIC_INT, "3");
            loop_count_block.load_const(BUILTIN_TYPES::MAGIC_INT, "3");
            loop_count_block.binop(BINOP::ADD);
        }

        main_block.define_simple_loop(loop_block, loop_count_block);
}

While loops

use celsium::block::Block;
use celsium::module::Module;
use celsium::{CelsiumProgram, BINOP, BUILTIN_TYPES};

fn main() {
    let mut main_module = Module::new("main", &mut celsium);
    let mut main_block = Block::new();

    let mut conditional_block = Block::new();
    {
        conditional_block.load_const(BUILTIN_TYPES::MAGIC_INT, "1");
        conditional_block.load_const(BUILTIN_TYPES::MAGIC_INT, "1");
        conditional_block.binop(BINOP::EQ);
    }
    let mut loop_block = Block::new();
    {
        loop_block.load_const(BUILTIN_TYPES::MAGIC_INT, "20");
        loop_block.call_print_function(true);
    }
    main_block.define_while_loop(loop_block, conditional_block);


    main_module.add_main_block(main_block);
    celsium.add_module(&main_module);
    celsium.run_program();
}
Commit count: 25

cargo fmt