use crate::parser::marker::CompletedMarker;
use crate::parser::Parser;
use crate::standard::VHDLStandard;
use crate::syntax::node_kind::NodeKind::*;
use crate::tokens::token_kind::Keyword as Kw;
use crate::tokens::TokenKind::*;
impl Parser {
pub(crate) fn component_declaration(&mut self) -> CompletedMarker {
self.node(ComponentDeclaration, |p| {
p.component_declaration_preamble();
p.opt_generic_clause();
p.opt_port_clause();
p.component_declaration_epilogue();
})
}
pub(crate) fn component_declaration_preamble(&mut self) {
self.node(ComponentDeclarationPreamble, |p| {
p.expect_token(Keyword(Kw::Component));
p.identifier();
p.opt_token(Keyword(Kw::Is));
});
}
pub(crate) fn component_declaration_epilogue(&mut self) {
self.node(ComponentDeclarationEpilogue, |p| {
p.expect_token(Keyword(Kw::End));
if p.standard().is_at_least(VHDLStandard::VHDL2019) {
p.opt_token(Keyword(Kw::Component));
} else {
p.expect_token(Keyword(Kw::Component));
}
p.opt_identifier();
p.expect_token(SemiColon);
});
}
}
#[cfg(test)]
mod tests {
use crate::parser::test_utils::{to_test_text, to_test_text_with_standard};
use crate::parser::{parse_syntax_with_standard, Parser};
use crate::standard::VHDLStandard;
#[test]
fn simple_components() {
insta::assert_snapshot!(to_test_text(
Parser::component_declaration,
"\
component foo
end component;
"
));
insta::assert_snapshot!(to_test_text(
Parser::component_declaration,
"\
component foo is
end component;
"
));
insta::assert_snapshot!(to_test_text(
Parser::component_declaration,
"\
component foo is
end component foo;
",
));
}
#[test]
fn components_with_generics() {
insta::assert_snapshot!(to_test_text(
Parser::component_declaration,
"\
component foo is
generic (
foo : natural
);
end component;
",
));
}
#[test]
fn components_with_port() {
insta::assert_snapshot!(to_test_text(
Parser::component_declaration,
"\
component foo is
port (
foo : natural
);
end component;
",
));
}
#[test]
fn component_end_without_keyword_vhdl2019() {
insta::assert_snapshot!(to_test_text_with_standard(
VHDLStandard::VHDL2019,
Parser::component_declaration,
"\
component foo is
end;
"
));
insta::assert_snapshot!(to_test_text_with_standard(
VHDLStandard::VHDL2019,
Parser::component_declaration,
"\
component foo is
end foo;
"
));
}
#[test]
fn component_end_without_keyword_is_error_before_vhdl2019() {
let (_, diagnostics) = parse_syntax_with_standard(
VHDLStandard::VHDL2008,
"component foo is\nend;\n".bytes(),
Parser::component_declaration,
);
assert!(
!diagnostics.is_empty(),
"expected a diagnostic for missing 'component' keyword under VHDL-2008"
);
}
#[test]
fn component_missing_end() {
assert_recovery_snapshot!(
"\
component fifo is
port (
clk : in std_logic;
data : out std_logic_vector(7 downto 0)
);",
Parser::component_declaration
);
}
#[test]
fn component_unclosed_port_list() {
assert_recovery_snapshot!(
"\
component fifo is
port (
clk : in std_logic;
data : out std_logic_vector(7 downto 0)
end component;",
Parser::component_declaration
);
}
}