vhdl_syntax 0.2.0

VHDL parser for lossless concrete syntax trees
Documentation
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this file,
// You can obtain one at http://mozilla.org/MPL/2.0/.
//
// Copyright (c)  2025, Lukas Scheller lukasscheller@icloud.com

use crate::parser::marker::CompletedMarker;
use crate::parser::Parser;
use crate::syntax::node_kind::NodeKind::*;
use crate::tokens::token_kind::Keyword as Kw;
use crate::tokens::token_kind::TokenKind::*;

impl Parser {
    pub(crate) fn alias_declaration(&mut self) -> CompletedMarker {
        self.node(AliasDeclaration, |p| {
            p.expect_kw(Kw::Alias);
            p.alias_designator();
            if p.next_is(Colon) {
                p.node(AliasSubtype, |p| {
                    p.skip(); // Colon
                    p.subtype_indication();
                });
            }
            p.expect_token(Keyword(Kw::Is));
            p.name();
            if p.next_is(LeftSquare) {
                p.signature();
            }
            p.expect_token(SemiColon);
        })
    }

    pub(crate) fn alias_designator(&mut self) {
        self.expect_one_of_tokens([Identifier, StringLiteral, CharacterLiteral]);
    }
}

#[cfg(test)]
mod tests {
    use crate::parser::test_utils::*;
    use crate::parser::Parser;

    #[test]
    fn parse_simple_alias() {
        insta::assert_snapshot!(to_test_text(
            Parser::alias_declaration,
            "alias foo is name;",
        ));
    }

    #[test]
    fn parse_alias_with_subtype_indication() {
        insta::assert_snapshot!(to_test_text(
            Parser::alias_declaration,
            "alias foo : vector(0 to 1) is name;",
        ));
    }

    #[test]
    fn parse_alias_with_signature() {
        insta::assert_snapshot!(to_test_text(
            Parser::alias_declaration,
            "alias foo is name [return natural];",
        ));
    }

    #[test]
    fn parse_alias_with_operator_symbol() {
        insta::assert_snapshot!(to_test_text(
            Parser::alias_declaration,
            "alias \"and\" is name;",
        ));
    }

    #[test]
    fn parse_alias_with_character() {
        insta::assert_snapshot!(to_test_text(Parser::alias_declaration, "alias 'c' is 'b';",));
    }
}