rocket_codegen 0.5.1

Procedural macros for the Rocket web framework.
Documentation
use proc_macro2::{Span, TokenStream};
use quote::{ToTokens, TokenStreamExt};

#[derive(Debug, Copy, Clone)]
pub struct StaticPath(pub Option<Span>, pub &'static str);

#[derive(Debug, Copy, Clone)]
pub struct StaticTokens(pub fn() -> TokenStream);

macro_rules! quote_static {
    ($($token:tt)*) => {
        $crate::exports::StaticTokens(|| quote!($($token)*))
    }
}

impl ToTokens for StaticTokens {
    fn to_tokens(&self, tokens: &mut TokenStream) {
        tokens.append_all((self.0)());
    }
}

impl StaticPath {
    pub fn respanned(mut self, span: Span) -> Self {
        self.0 = Some(span);
        self
    }
}

impl ToTokens for StaticPath {
    fn to_tokens(&self, tokens: &mut TokenStream) {
        let path: syn::Path = syn::parse_str(self.1).unwrap();
        if let Some(span) = self.0 {
            let new_tokens = path.into_token_stream()
                .into_iter()
                .map(|mut t| { t.set_span(span); t });

            tokens.append_all(new_tokens);
        } else {
            path.to_tokens(tokens)
        }
    }
}

macro_rules! define_exported_paths {
    ($($name:ident => $path:path),* $(,)?) => {
        $(
            #[allow(dead_code)]
            #[allow(non_upper_case_globals)]
            pub const $name: StaticPath = $crate::exports::StaticPath(None, stringify!($path));
        )*

        macro_rules! define {
            // Note: the `i` is to capture the input's span.
            $(($span:expr => $i:ident $name) => {
                #[allow(non_snake_case)]
                let $i = $crate::exports::StaticPath(Some($span), stringify!($path));
            };)*
        }
    };
}

define_exported_paths! {
    __req => __req,
    __status => __status,
    __catcher => __catcher,
    __data => __data,
    __error => __error,
    __trail => __trail,
    _request => ::rocket::request,
    _response => ::rocket::response,
    _route => ::rocket::route,
    _catcher => ::rocket::catcher,
    _sentinel => ::rocket::sentinel,
    _log => ::rocket::log,
    _form => ::rocket::form::prelude,
    _http => ::rocket::http,
    _uri => ::rocket::http::uri,
    _fmt => ::rocket::http::uri::fmt,
    _Option => ::std::option::Option,
    _Result => ::std::result::Result,
    _Some => ::std::option::Option::Some,
    _None => ::std::option::Option::None,
    _Ok => ::std::result::Result::Ok,
    _Err => ::std::result::Result::Err,
    _Box => ::std::boxed::Box,
    _Vec => ::std::vec::Vec,
    _Cow => ::std::borrow::Cow,
    BorrowMut => ::std::borrow::BorrowMut,
    Outcome => ::rocket::outcome::Outcome,
    FromForm => ::rocket::form::FromForm,
    FromRequest => ::rocket::request::FromRequest,
    FromData => ::rocket::data::FromData,
    FromSegments => ::rocket::request::FromSegments,
    FromParam => ::rocket::request::FromParam,
    Request => ::rocket::request::Request,
    Response => ::rocket::response::Response,
    Data => ::rocket::data::Data,
    StaticRouteInfo => ::rocket::StaticRouteInfo,
    StaticCatcherInfo => ::rocket::StaticCatcherInfo,
    Route => ::rocket::Route,
    Catcher => ::rocket::Catcher,
    SmallVec => ::rocket::http::private::SmallVec,
    Status => ::rocket::http::Status,
}

macro_rules! define_spanned_export {
    ($span:expr => $($name:ident),*) => ($(define!($span => $name $name);)*)
}

/// Convenience: returns a "mixed site" span located at `span`.
#[inline(always)]
pub fn mixed(span: Span) -> Span {
    Span::mixed_site().located_at(span)
}