Trait SingleAttributeParser

Source

pub(crate) trait SingleAttributeParser<S: Stage>: 'static {
    const PATH: &[Symbol];
    const ATTRIBUTE_ORDER: AttributeOrder;
    const ON_DUPLICATE: OnDuplicate<S>;
    const ALLOWED_TARGETS: AllowedTargets;
    const TEMPLATE: AttributeTemplate;

    // Required method
    fn convert(
        cx: &mut AcceptContext<'_, '_, S>,
        args: &ArgParser<'_>,
    ) -> Option<AttributeKind>;
}

Expand description

Alternative to AttributeParser that automatically handles state management. A slightly simpler and more restricted way to convert attributes. Assumes that an attribute can only appear a single time on an item, and errors when it sees more.

Single<T> where T: SingleAttributeParser implements AttributeParser.

SingleAttributeParser can only convert attributes one-to-one, and cannot combine multiple attributes together like is necessary for #[stable()] and #[unstable()] for example.

Required Associated Constants§

Source

const PATH: &[Symbol]

The single path of the attribute this parser accepts.

If you need the parser to accept more than one path, use AttributeParser instead

Source

const ATTRIBUTE_ORDER: AttributeOrder

Configures the precedence of attributes with the same PATH on a syntax node.

Source

const ON_DUPLICATE: OnDuplicate<S>

Configures what to do when when the same attribute is applied more than once on the same syntax node.

ATTRIBUTE_ORDER specified which one is assumed to be correct, and this specified whether to, for example, warn or error on the other one.

Source

const ALLOWED_TARGETS: AllowedTargets

Source

const TEMPLATE: AttributeTemplate

The template this attribute parser should implement. Used for diagnostics.

Required Methods§

Source

fn convert( cx: &mut AcceptContext<'_, '_, S>, args: &ArgParser<'_>, ) -> Option<AttributeKind>

Converts a single syntactical attribute to a single semantic attribute, or AttributeKind

Dyn Compatibility§

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

SingleAttributeParser

Trait SingleAttributeParser Copy item path

Required Associated Constants§

const PATH: &[Symbol]

const ATTRIBUTE_ORDER: AttributeOrder

const ON_DUPLICATE: OnDuplicate<S>

const ALLOWED_TARGETS: AllowedTargets

const TEMPLATE: AttributeTemplate

Required Methods§

fn convert( cx: &mut AcceptContext<'_, '_, S>, args: &ArgParser<'_>, ) -> Option<AttributeKind>

Dyn Compatibility§

Implementors§

impl<S: Stage> SingleAttributeParser<S> for CoverageParser

const PATH: &[Symbol]

const ATTRIBUTE_ORDER: AttributeOrder = AttributeOrder::KeepOutermost

const ON_DUPLICATE: OnDuplicate<S> = OnDuplicate::Error

const ALLOWED_TARGETS: AllowedTargets

const TEMPLATE: AttributeTemplate

impl<S: Stage> SingleAttributeParser<S> for ExportNameParser

const PATH: &[Symbol]

const ATTRIBUTE_ORDER: AttributeOrder = AttributeOrder::KeepInnermost

const ON_DUPLICATE: OnDuplicate<S> = OnDuplicate::WarnButFutureError

const ALLOWED_TARGETS: AllowedTargets

const TEMPLATE: AttributeTemplate

impl<S: Stage> SingleAttributeParser<S> for OptimizeParser

const PATH: &[Symbol]

const ATTRIBUTE_ORDER: AttributeOrder = AttributeOrder::KeepOutermost

const ON_DUPLICATE: OnDuplicate<S> = OnDuplicate::WarnButFutureError

const ALLOWED_TARGETS: AllowedTargets

const TEMPLATE: AttributeTemplate

impl<S: Stage> SingleAttributeParser<S> for SanitizeParser

const PATH: &[Symbol]

const ALLOWED_TARGETS: AllowedTargets

const TEMPLATE: AttributeTemplate

const ATTRIBUTE_ORDER: AttributeOrder = AttributeOrder::KeepOutermost

const ON_DUPLICATE: OnDuplicate<S> = OnDuplicate::Error

impl<S: Stage> SingleAttributeParser<S> for CrateNameParser

const PATH: &[Symbol]

const ATTRIBUTE_ORDER: AttributeOrder = AttributeOrder::KeepOutermost

const ON_DUPLICATE: OnDuplicate<S> = OnDuplicate::WarnButFutureError

const TEMPLATE: AttributeTemplate

const ALLOWED_TARGETS: AllowedTargets

impl<S: Stage> SingleAttributeParser<S> for DeprecationParser

const PATH: &[Symbol]

const ATTRIBUTE_ORDER: AttributeOrder = AttributeOrder::KeepInnermost

const ON_DUPLICATE: OnDuplicate<S> = OnDuplicate::Error

const ALLOWED_TARGETS: AllowedTargets

const TEMPLATE: AttributeTemplate

impl<S: Stage> SingleAttributeParser<S> for DummyParser

const PATH: &[Symbol]

const ATTRIBUTE_ORDER: AttributeOrder = AttributeOrder::KeepInnermost

const ON_DUPLICATE: OnDuplicate<S> = OnDuplicate::Ignore

const ALLOWED_TARGETS: AllowedTargets

const TEMPLATE: AttributeTemplate

impl<S: Stage> SingleAttributeParser<S> for InlineParser

const PATH: &'static [Symbol]

const ATTRIBUTE_ORDER: AttributeOrder = AttributeOrder::KeepOutermost

const ON_DUPLICATE: OnDuplicate<S> = OnDuplicate::WarnButFutureError

const ALLOWED_TARGETS: AllowedTargets

const TEMPLATE: AttributeTemplate

impl<S: Stage> SingleAttributeParser<S> for RustcForceInlineParser

const PATH: &'static [Symbol]

const ATTRIBUTE_ORDER: AttributeOrder = AttributeOrder::KeepOutermost

const ON_DUPLICATE: OnDuplicate<S> = OnDuplicate::WarnButFutureError

const ALLOWED_TARGETS: AllowedTargets

const TEMPLATE: AttributeTemplate

impl<S: Stage> SingleAttributeParser<S> for LinkNameParser

const PATH: &[Symbol]

const ATTRIBUTE_ORDER: AttributeOrder = AttributeOrder::KeepInnermost

const ON_DUPLICATE: OnDuplicate<S> = OnDuplicate::WarnButFutureError

const ALLOWED_TARGETS: AllowedTargets

const TEMPLATE: AttributeTemplate

impl<S: Stage> SingleAttributeParser<S> for LinkOrdinalParser

const PATH: &[Symbol]

const ATTRIBUTE_ORDER: AttributeOrder = AttributeOrder::KeepOutermost

const ON_DUPLICATE: OnDuplicate<S> = OnDuplicate::Error

const ALLOWED_TARGETS: AllowedTargets

const TEMPLATE: AttributeTemplate

impl<S: Stage> SingleAttributeParser<S> for LinkSectionParser

const PATH: &[Symbol]

Trait SingleAttributeParser