sourcegen-cli 0.4.0

In-place Rust source generator CLI utility.
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
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

use proc_macro2::{Ident, Span, TokenStream, TokenTree};

pub(crate) const MAGIC_COMMENT_IDENT: &str = "__SOURCEGEN_MAGIC_COMMENT__";

/// Token used to generate plain Rust comments in the output. Used as a marker in front of the
/// string literal to generate a plain comment. Usage:
///
/// ```rust
/// use sourcegen_cli::tokens::PlainComment;
/// let _output = quote::quote! {
///     #PlainComment "GeneratedComment"
///     struct Test;
/// };
/// ```
///
/// Generated output will contain a plain comment:
/// ```
/// // Generated comment
/// struct Test;
/// ```
pub struct PlainComment;

impl quote::ToTokens for PlainComment {
    fn to_tokens(&self, tokens: &mut TokenStream) {
        tokens.extend(std::iter::once(TokenTree::Ident(Ident::new(
            MAGIC_COMMENT_IDENT,
            Span::call_site(),
        ))));
    }
}

pub(crate) const MAGIC_NEWLINE_IDENT: &str = "__SOURCEGEN_MAGIC_NEWLINE__";

/// Token used to generate a newline in the output. Used as a marker. Usage:
///
/// ```rust
/// use sourcegen_cli::tokens::NewLine;
/// let _output = quote::quote! {
///     struct Frist;
///     #NewLine
///     struct Second;
/// };
/// ```
///
/// Generated output will contain a plain comment:
/// ```
/// struct First;
///
/// struct Second;
/// ```
pub struct NewLine;

impl quote::ToTokens for NewLine {
    fn to_tokens(&self, tokens: &mut TokenStream) {
        tokens.extend(std::iter::once(TokenTree::Ident(Ident::new(
            MAGIC_NEWLINE_IDENT,
            Span::call_site(),
        ))));
    }
}