Crate proc_easy

Making proc-macro easy.

Macros

easy_attribute

Defines attribute structure. First field is a attribute name. It must be EasyToken implementation that will be used to for EasyPeek implementation. In case of errors, attribute name and span will be used.

easy_attribute_group

Defines attribute group as enum where each variant is attribute type.

easy_attributes

Defines struct and implement EasyAttributes for it. Each field’s type must implement EasyAttributeField.

easy_flags

Defines flags and attribute group and fields for them. Flags can be parsed independently. They can be parsed inside attribute that can contain only one flag. They can be parsed inside attribute that accepts a list of flags if provided.

easy_parse

Defines structure or enum and implements Parse for it Also implements EasyPeek for structs if first field is prefixed with @. That field’s type must implement EasyPeek itself. Implements EasyPeek for all enums. First field in enum variant must implement EasyPeek. Or if there’s no fields in enum variant - it does not participate in parsing.

easy_token

Produces type with specified name that implement EasyToken and can be parsed from the name ident.

Structs

Braced

Parses inner type braced. Implements EasyPeek and peeks opening brace.

Bracketed

Parses inner type bracketed. Implements EasyPeek and peeks opening bracket.

Parenthesized

Parses inner type parenthesized. Implements EasyPeek and peeks opening parenthesis.

Traits

EasyAttribute

Trait for parsable attributes. Attributes should be peekable to choose which attribute to parse.

EasyAttributeField

Trait for types that can be used as fields in easy attributes structures. Fields can parsed and extended when encountered again in parsing stream. If field is never encountered - default value will be used. If attribute type or group have no default wrap it into Option.

EasyAttributeGroup

Trait that should be implemented for enums of where each variant is an attribute. It is also auto-implemented for all bare attributes. This trait is used to implement EasyAttributeField for various types.

EasyAttributes

Collection of attributes that can be parsed from array of attributes. Can be easily applied to field’s or type’s attributes vector.

EasyPeek

Provides interface for peeking tokens before parsing. When implemented for complex structures, peeks first token.

EasyToken

Peekable, parsable token.