Crate proc_easy

Making proc-macro easy.

Modules

examples

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

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.

Enums

ReferenceExpr

Expression that may be a constant or a reference to member field. Often used pattern is having attribute that refer to a field or constant expression.

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.