webidl-rs

Rust 中用于 WebIDL 的解析器。

文档

示例

词法分析

use webidl::*;

let lexer = Lexer::new("/* Example taken from emscripten site */\n\
                        enum EnumClass_EnumWithinClass {\n\
                            \"EnumClass::e_val\"\n\
                        };");
assert_eq!(lexer.collect::<Vec<_>>(),
           vec![Ok((41, Token::Enum, 45)),
                Ok((46, Token::Identifier("EnumClass_EnumWithinClass".to_string()), 71)),
                Ok((72, Token::LeftBrace, 73)),
                Ok((74, Token::StringLiteral("EnumClass::e_val".to_string()), 92)),
                Ok((93, Token::RightBrace, 94)),
                Ok((94, Token::Semicolon, 95))]);

解析

use webidl::*;
use webidl::ast::*;

let result = parse_string("[Attribute] interface Node { };");

assert_eq!(result,
           Ok(vec![Definition::Interface(Interface::NonPartial(NonPartialInterface {
                extended_attributes: vec![
                    Box::new(ExtendedAttribute::NoArguments(
                        Other::Identifier("Attribute".to_string())))],
                inherits: None,
                members: vec![],
                name: "Node".to_string()
           }))]));

格式化打印 AST

示例的访问者实现可以在这里找到 here。以下是如何使用它的示例

use webidl::ast::*;
use webidl::visitor::*;

let ast = vec![Definition::Interface(Interface::NonPartial(NonPartialInterface {
                extended_attributes: vec![
                    Box::new(ExtendedAttribute::NoArguments(
                        Other::Identifier("Attribute".to_string())))],
                inherits: None,
                members: vec![InterfaceMember::Attribute(Attribute::Regular(RegularAttribute {
                             extended_attributes: vec![],
                             inherits: false,
                             name: "attr".to_string(),
                             read_only: true,
                             type_: Box::new(Type {
                                 extended_attributes: vec![],
                                 kind: TypeKind::SignedLong,
                                 nullable: true
                             })
                         }))],
                name: "Node".to_string()
          }))];
let mut visitor = PrettyPrintVisitor::new();
visitor.visit(&ast);
assert_eq!(visitor.get_output(),
           "[Attribute]\ninterface Node {\n    readonly attribute long? attr;\n};\n\n");

一致性

解析器在 WebIDL 语法 方面是一致的，除了三点

• 由于扩展属性在解析时没有语义意义，因此不支持扩展属性，如语法所述。相反，支持有限的形式（如 表格 中所示）。此解析器在解析形式为 A=B 的扩展属性时提供更多灵活性。规范指出 A 和 B 必须是标识符，但此解析器接受 B 作为任何令牌。如果您希望解析任何扩展属性（基本上是任何令牌序列），请考虑查看 #8 以帮助解决此问题。
• 此解析器支持不再包含在官方规范中的旧 implements 关键字。这是为了向后兼容。
• 此解析器支持不再包含在官方规范中的旧 legacycaller 关键字。这是为了向后兼容。