oak-jasmin 0.0.11

Jasmin Java assembler parser with support for Java bytecode assembly and class file generation.
Documentation
#![doc = include_str!("readme.md")]
/// Jasmin token types.
pub mod token_type;

use crate::{language::JasminLanguage, lexer::token_type::JasminTokenType};
use oak_core::{Lexer, LexerCache, LexerState, OakError, TextEdit, lexer::LexOutput, source::Source};

pub(crate) type State<'a, S> = LexerState<'a, S, JasminLanguage>;

/// Jasmin lexer.
#[derive(Clone)]
pub struct JasminLexer<'config> {
    config: &'config JasminLanguage,
}

impl<'config> JasminLexer<'config> {
    /// Creates a new `JasminLexer` with the given configuration.
    pub fn new(config: &'config JasminLanguage) -> Self {
        Self { config }
    }

    /// Determines whether the given text is a keyword or an identifier.
    fn keyword_or_identifier(&self, text: &str) -> JasminTokenType {
        match text {
            ".class" => JasminTokenType::ClassKw,
            ".version" => JasminTokenType::VersionKw,
            ".method" => JasminTokenType::MethodKw,
            ".field" => JasminTokenType::FieldKw,
            ".string" => JasminTokenType::StringKw,
            ".source" => JasminTokenType::SourceFileKw,
            ".stack" => JasminTokenType::StackKw,
            ".locals" => JasminTokenType::LocalsKw,
            ".end" => JasminTokenType::EndKw,
            ".compiled" => JasminTokenType::CompiledKw,
            ".from" => JasminTokenType::FromKw,
            ".inner" => JasminTokenType::InnerClassKw,
            ".nest" => JasminTokenType::NestMembersKw,
            ".bootstrap" => JasminTokenType::BootstrapMethodKw,

            "public" => JasminTokenType::Public,
            "private" => JasminTokenType::Private,
            "protected" => JasminTokenType::Protected,
            "static" => JasminTokenType::Static,
            "super" => JasminTokenType::Super,
            "final" => JasminTokenType::Final,
            "abstract" => JasminTokenType::Abstract,
            "synchronized" => JasminTokenType::Synchronized,
            "native" => JasminTokenType::Native,
            "synthetic" => JasminTokenType::Synthetic,
            "deprecated" => JasminTokenType::Deprecated,
            "varargs" => JasminTokenType::Varargs,

            "aload_0" => JasminTokenType::ALoad0,
            "aload_1" => JasminTokenType::ALoad1,
            "aload_2" => JasminTokenType::ALoad2,
            "aload_3" => JasminTokenType::ALoad3,
            "iload_0" => JasminTokenType::ILoad0,
            "iload_1" => JasminTokenType::ILoad1,
            "iload_2" => JasminTokenType::ILoad2,
            "iload_3" => JasminTokenType::ILoad3,
            "ldc" => JasminTokenType::Ldc,
            "ldc_w" => JasminTokenType::LdcW,
            "ldc2_w" => JasminTokenType::Ldc2W,
            "invokespecial" => JasminTokenType::InvokeSpecial,
            "invokevirtual" => JasminTokenType::InvokeVirtual,
            "invokestatic" => JasminTokenType::InvokeStatic,
            "invokeinterface" => JasminTokenType::InvokeInterface,
            "invokedynamic" => JasminTokenType::InvokeDynamic,
            "getstatic" => JasminTokenType::GetStatic,
            "putstatic" => JasminTokenType::PutStatic,
            "getfield" => JasminTokenType::GetField,
            "putfield" => JasminTokenType::PutField,
            "return" => JasminTokenType::Return,
            "areturn" => JasminTokenType::AReturn,
            "ireturn" => JasminTokenType::IReturn,
            "pop" => JasminTokenType::Pop,
            "new" => JasminTokenType::New,

            _ => {
                // Check if it's a type descriptor
                if self.is_type_descriptor(text) { JasminTokenType::TypeDescriptor } else { JasminTokenType::IdentifierToken }
            }
        }
    }

    /// Checks if the given text is a type descriptor.
    fn is_type_descriptor(&self, text: &str) -> bool {
        if text.is_empty() {
            return false;
        }

        // Primitive types
        if matches!(text, "B" | "C" | "D" | "F" | "I" | "J" | "S" | "Z" | "V") {
            return true;
        }

        // Array types
        if text.starts_with('[') {
            return true;
        }

        // Object types
        if text.starts_with('L') && text.ends_with(';') {
            return true;
        }

        false
    }

    /// Skips whitespace characters.
    fn skip_whitespace<S: Source + ?Sized>(&self, state: &mut State<'_, S>) -> bool {
        let start_pos = state.get_position();
        let mut consumed = false;

        while let Some(ch) = state.peek() {
            if ch.is_whitespace() {
                consumed = true;
                state.advance(ch.len_utf8());
            }
            else {
                break;
            }
        }

        if consumed {
            state.add_token(JasminTokenType::Whitespace, start_pos, state.get_position());
            true
        }
        else {
            false
        }
    }

    /// Skips comments.
    fn skip_comment<S: Source + ?Sized>(&self, state: &mut State<'_, S>) -> bool {
        if let Some(ch) = state.peek() {
            if ch == ';' {
                let start_pos = state.get_position();
                // Skip to the end of the line
                while let Some(ch) = state.peek() {
                    state.advance(ch.len_utf8());
                    if ch == '\n' {
                        break;
                    }
                }
                state.add_token(JasminTokenType::Comment, start_pos, state.get_position());
                return true;
            }
        }
        false
    }

    /// Lexes a string literal.
    fn lex_string<S: Source + ?Sized>(&self, state: &mut State<'_, S>) -> bool {
        if let Some(ch) = state.peek() {
            if ch == '"' {
                let start_pos = state.get_position();
                state.advance(1); // Skip the starting quote

                while let Some(ch) = state.peek() {
                    if ch == '"' {
                        state.advance(1); // Skip the ending quote
                        break;
                    }
                    else if ch == '\\' {
                        state.advance(1); // Skip the escape character
                        if state.peek().is_some() {
                            state.advance(1); // Skip the escaped character
                        }
                    }
                    else {
                        state.advance(ch.len_utf8());
                    }
                }

                state.add_token(JasminTokenType::StringLiteral, start_pos, state.get_position());
                return true;
            }
        }
        false
    }

    /// Lexes a number literal.
    fn lex_number<S: Source + ?Sized>(&self, state: &mut State<'_, S>) -> bool {
        let start_pos = state.get_position();

        if let Some(first) = state.peek() {
            // Simplified logic: only handle numbers starting with a digit
            if !first.is_ascii_digit() {
                return false;
            }

            // Consume digits
            while let Some(ch) = state.peek() {
                if ch.is_ascii_digit() {
                    state.advance(ch.len_utf8());
                }
                else if ch == '.' {
                    // Floating point number
                    state.advance(1);
                    while let Some(ch) = state.peek() {
                        if ch.is_ascii_digit() {
                            state.advance(ch.len_utf8());
                        }
                        else {
                            break;
                        }
                    }
                    break;
                }
                else {
                    break;
                }
            }

            state.add_token(JasminTokenType::Number, start_pos, state.get_position());
            return true;
        }

        false
    }

    /// Lexes an identifier or keyword.
    fn lex_identifier_or_keyword<S: Source + ?Sized>(&self, state: &mut State<'_, S>) -> bool {
        let start = state.get_position();
        let first = match state.peek() {
            Some(ch) => ch,
            None => return false,
        };

        // Identifiers must start with an alphabetic character, underscore, or dot
        if !first.is_ascii_alphabetic() && first != '_' && first != '.' {
            return false;
        }

        // Consume the first character
        state.advance(first.len_utf8());

        // Consume subsequent characters
        while let Some(ch) = state.peek() {
            if ch.is_ascii_alphanumeric() || ch == '_' || ch == '/' || ch == '$' || ch == '<' || ch == '>' {
                state.advance(ch.len_utf8());
            }
            else {
                break;
            }
        }

        let end = state.get_position();
        let text = state.get_text_in(oak_core::Range { start, end });
        let kind = self.keyword_or_identifier(&text);
        state.add_token(kind, start, state.get_position());
        true
    }

    /// Lexes an operator or delimiter.
    fn lex_operator_or_delimiter<S: Source + ?Sized>(&self, state: &mut State<'_, S>) -> bool {
        let start = state.get_position();
        let ch = match state.peek() {
            Some(ch) => ch,
            None => return false,
        };

        let kind = match ch {
            '{' => JasminTokenType::LeftBrace,
            '}' => JasminTokenType::RightBrace,
            '(' => JasminTokenType::LeftParen,
            ')' => JasminTokenType::RightParen,
            '[' => JasminTokenType::LeftBracket,
            ']' => JasminTokenType::RightBracket,
            ':' => JasminTokenType::Colon,
            ';' => JasminTokenType::Semicolon,
            '.' => JasminTokenType::Dot,
            ',' => JasminTokenType::Comma,
            '/' => JasminTokenType::Slash,
            _ => return false,
        };

        state.advance(ch.len_utf8());
        state.add_token(kind, start, state.get_position());
        true
    }

    /// Main lexer run method.
    fn run<S: Source + ?Sized>(&self, state: &mut State<'_, S>) -> Result<(), OakError> {
        while state.not_at_end() {
            let safe_point = state.get_position();

            // Try various lexing rules
            if self.skip_whitespace(state) {
                continue;
            }

            if self.skip_comment(state) {
                continue;
            }

            if self.lex_string(state) {
                continue;
            }

            if self.lex_number(state) {
                continue;
            }

            if self.lex_identifier_or_keyword(state) {
                continue;
            }

            if self.lex_operator_or_delimiter(state) {
                continue;
            }

            // If no rule matches, skip current character and mark as error
            let start_pos = state.get_position();
            if let Some(ch) = state.peek() {
                state.advance(ch.len_utf8());
                state.add_token(JasminTokenType::Error, start_pos, state.get_position());
            }

            state.advance_if_dead_lock(safe_point);
        }

        Ok(())
    }
}

impl<'config> Lexer<JasminLanguage> for JasminLexer<'config> {
    fn lex<'a, S: Source + ?Sized>(&self, source: &S, _edits: &[TextEdit], cache: &'a mut impl LexerCache<JasminLanguage>) -> LexOutput<JasminLanguage> {
        let mut state = LexerState::new(source);
        let result = self.run(&mut state);
        if result.is_ok() {
            state.add_eof();
        }
        state.finish_with_cache(result, cache)
    }
}