attribute-derive

基本类似于clap的属性宏

use attribute_derive::Attribute;
use syn::Type;

#[derive(Attribute)]
#[attribute(ident = collection)]
#[attribute(error(missing_field = "`{field}` was not specified"))]
struct CollectionAttribute {
    // Options are optional by default (will be set to None if not specified)
    authority: Option<String>,
    name: String,
    // Any type implementing default can be flagged as default
    // This will be set to Vec::default() when not specified
    #[attribute(optional)]
    views: Vec<Type>,
    // Booleans can be used without assigning a value, i.e., as a flag.
    // If omitted they are set to false
    some_flag: bool,
}

能够解析如下属性

#[collection(authority="Some String", name = r#"Another string"#, views = [Option, ()])]

局限性

在语法解析方面存在一些局限性，将在未来的版本中解决。

• 顶层字面量（意味着类似 #[attr(42, 3.14, "hi")]
• 函数式参数（类似 #[attr(view(a = "test"))]
• 其他语法，可能类似 key: value

解析方法

解析结构化派生 Attribute 有多种方式。

对于辅助属性有

• Attribute::from_attributes 接收一个 IntoIterator<Item = &'a syn::Attribute（例如，一个 &Vec<syn::Attribute>）。对于 derive 宏非常有用。
• Attribute::remove_attributes 接收一个 &mut Vec<syn::Attribute>，不仅解析 Attribute，还会移除匹配的项。对于 proc 宏的辅助属性非常有用，其中辅助属性需要被移除。