inline-doc 0.1.0

Embed markdown/text files as documentation
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

use std::fs::read_to_string;

use quote::quote;
use syn::{parse_macro_input, LitStr};

#[proc_macro_attribute]
pub fn inline_doc(
    attr: proc_macro::TokenStream,
    input: proc_macro::TokenStream,
) -> proc_macro::TokenStream {
    let input: proc_macro2::TokenStream = input.into();

    let path = parse_macro_input!(attr as LitStr);
    let path = path.value();

    let md = read_to_string(&path).unwrap_or_else(|_| panic!("Could not find {path:?}"));
    let md = format!("\n\n{}\n\n\n", md.trim());

    quote! {
        #[doc = #md]
        #input
    }
    .into()
}