everscale-asm-macros 0.0.9

Macros for Rust implementation of TVM Assembler
Documentation
use std::cell::RefCell;
use std::fs::File;
use std::io::Read;
use std::path::Path;

use everscale_asm::Code;
use everscale_types::boc::Boc;
use proc_macro::TokenStream;
use quote::quote;
use quote::ToTokens;
use syn::punctuated::Punctuated;

#[proc_macro]
pub fn tvmasm(input: TokenStream) -> TokenStream {
    let input = syn::parse_macro_input!(input with Punctuated::<syn::LitStr, syn::Token![,]>::parse_terminated);
    compile_inline(&input)
        .unwrap_or_else(to_compile_errors)
        .into()
}

#[proc_macro]
pub fn include_tvmasm(input: TokenStream) -> TokenStream {
    let input = syn::parse_macro_input!(input as syn::LitStr);
    compile_file(&input)
        .unwrap_or_else(to_compile_errors)
        .into()
}

fn compile_inline(
    input: &Punctuated<syn::LitStr, syn::Token![,]>,
) -> Result<proc_macro2::TokenStream, Vec<syn::Error>> {
    let ctxt = Ctxt::default();

    let source = Source::new(input.iter());
    let code = Code::parse(&source.text);

    let print_asm_errors = |errors| {
        visit_asm_errors(errors, |e| {
            let span = source.find_lit_by_span(e.span());
            match span {
                None => ctxt.error_spanned_by(input, e),
                Some(s) => ctxt.error_spanned_by(s, e),
            }
        })
    };

    let compiled = if !code.parser_errors().is_empty() {
        for error in code.parser_errors() {
            let span = error.span().and_then(|span| source.find_lit_by_span(span));
            match span {
                None => ctxt.error_spanned_by(input, error),
                Some(s) => ctxt.error_spanned_by(s, error),
            }
        }

        print_asm_errors(&code.check());
        ctxt.check()?;

        Vec::new()
    } else {
        let code = code.try_into_valid().unwrap();
        match code.assemble() {
            Ok(code) => Boc::encode(code),
            Err(asm_error) => {
                print_asm_errors(&[asm_error]);
                ctxt.check()?;
                Vec::new()
            }
        }
    };

    Ok(quote!( &[#(#compiled),*] ))
}

fn compile_file(input: &syn::LitStr) -> Result<proc_macro2::TokenStream, Vec<syn::Error>> {
    let root = std::env::var("CARGO_MANIFEST_DIR").unwrap_or_else(|_| ".".into());
    let full_path = Path::new(&root).join("src/").join(input.value());
    if full_path.file_name().is_none() {
        return Err(vec![syn::Error::new_spanned(
            input.into_token_stream(),
            "scheme attribute should point to a file",
        )]);
    }

    let source = match read_file(&full_path) {
        Ok(data) => data,
        Err(e) => {
            return Err(vec![syn::Error::new_spanned(
                input.into_token_stream(),
                format!("error opening {:?}: {e:?}", full_path),
            )])
        }
    };

    let ctxt = Ctxt::default();
    let code = Code::parse(&source);

    let print_asm_errors = |errors| visit_asm_errors(errors, |e| ctxt.error_spanned_by(input, e));

    let compiled = if !code.parser_errors().is_empty() {
        for error in code.parser_errors() {
            ctxt.error_spanned_by(input, error);
        }

        print_asm_errors(&code.check());
        ctxt.check()?;

        Vec::new()
    } else {
        let code = code.try_into_valid().unwrap();
        match code.assemble() {
            Ok(code) => Boc::encode(code),
            Err(asm_error) => {
                print_asm_errors(&[asm_error]);
                ctxt.check()?;
                Vec::new()
            }
        }
    };

    Ok(quote!( &[#(#compiled),*] ))
}

struct Source<'a> {
    text: String,
    parts: Vec<(&'a syn::LitStr, usize)>,
}

impl<'a> Source<'a> {
    fn new<I: Iterator<Item = &'a syn::LitStr>>(input: I) -> Self {
        let mut text = String::new();
        let mut parts = Vec::new();

        for part in input {
            let part_text = part.value();
            let part_len = part_text.len() + 1;

            text.reserve(part_len);
            text.push_str(&part_text);
            text.push('\n');

            parts.push((part, part_len));
        }

        Self { text, parts }
    }

    fn find_lit_by_span(&self, span: everscale_asm::Span) -> Option<&syn::LitStr> {
        let mut offset = 0;
        for (part, part_len) in &self.parts {
            offset += part_len;
            if span.start < offset {
                return Some(part);
            }
        }

        None
    }
}

#[derive(Default)]
struct Ctxt {
    errors: RefCell<Vec<syn::Error>>,
}

impl Ctxt {
    pub fn error_spanned_by<T, M>(&self, object: T, message: M)
    where
        T: ToTokens,
        M: std::fmt::Display,
    {
        self.errors
            .borrow_mut()
            .push(syn::Error::new_spanned(object.into_token_stream(), message));
    }

    pub fn check(self) -> Result<(), Vec<syn::Error>> {
        let errors = std::mem::take(&mut *self.errors.borrow_mut());
        match errors.len() {
            0 => Ok(()),
            _ => Err(errors),
        }
    }
}

fn visit_asm_errors<F>(errors: &[everscale_asm::AsmError], mut f: F)
where
    F: FnMut(&everscale_asm::AsmError),
{
    fn visit_asm_errors_impl<F>(errors: &[everscale_asm::AsmError], f: &mut F)
    where
        F: FnMut(&everscale_asm::AsmError),
    {
        for error in errors {
            match error {
                everscale_asm::AsmError::Multiple(errors) => visit_asm_errors_impl(errors, f),
                everscale_asm::AsmError::ArgTypeMismatch {
                    found: everscale_asm::ArgType::Invalid,
                    ..
                } => continue,
                _ => f(error),
            }
        }
    }
    visit_asm_errors_impl(errors, &mut f)
}

fn to_compile_errors(errors: Vec<syn::Error>) -> proc_macro2::TokenStream {
    let compile_errors = errors.iter().map(syn::Error::to_compile_error);
    quote!(#(#compile_errors)*)
}

fn read_file<P: AsRef<Path>>(path: P) -> std::io::Result<String> {
    let mut file = File::open(path.as_ref())?;
    let mut string = String::new();
    file.read_to_string(&mut string)?;
    Ok(string)
}