rustdoc_copy_macro 0.2.0

Macros for `rustdoc_copy`
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

//! Provider of [`SkipAttr`].

use quote::ToTokens;
use syn::parse::{Parse, ParseStream};

/// Item tokens after attributes.
///
/// This type is used for adjusting error report span. Normally, the tokens of
/// an item includes tokens of their attributes. However, we sometimes want to
/// exclude tokens of their attributes from error span. To achieve this, This
/// type reverts the parsed item to token stream, and skips attributes, and
/// re-parses rest token stream as item again.
pub struct SkipAttr {
    item: syn::Item,
}

impl SkipAttr {
    /// Reparse item and skip its attributes.
    pub fn reparse(item: &syn::Item) -> syn::Item {
        let tokens = item.to_token_stream();
        syn::parse2::<Self>(tokens).unwrap().item
    }
}

impl Parse for SkipAttr {
    fn parse(input: ParseStream) -> syn::Result<Self> {
        let _ = syn::Attribute::parse_outer(input);
        let item = syn::Item::parse(input)?;
        Ok(Self { item })
    }
}