include_tt 1.1.1

Macros for ultra-flexible injection of token trees, literals, or binary data into Rust code from external files during compilation.
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
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96

use include_tt::inject;
use std::fmt::Write;

macro_rules! test2_rules {
	[
		[a, b]

		$($tt:tt)*
	] => {
		println!("test2_rules: [a, b]");
		test2_rules! {
			$($tt)*
		}
	};
	[
		[c, d]

		$($tt:tt)*
	] => {
		println!("test2_rules: [c, d]");
		test2_rules! {
			$($tt)*
		}
	};

	[
		a, b

		$($tt:tt)*
	] => {
		println!("test2_rules: a, b");
		test2_rules! {
			$($tt)*
		}
	};

	[
		$($tt:tt)+
	] => {
		compile_error!(stringify!( $($tt)* ))
	};
	[] => []
}

fn main() {
    // Loading trees from a file and substituting them into a custom macro.
    inject! {
        #TRACK_FILES:
        test2_rules! {
            [ #tt("./examples/full.tt") ] // this file contains `a, b`.
            [ #tt { "./examples/full.tt" } ] // this file contains `a, b`.
        }
        test2_rules! {
            #tt ("./examples/full.tt") // this file contains `a, b`.
        }

        println!(
            concat!(
                "#",
                #str("./examples/full.tt"), // this file contains `a, b`.
                "#"
            )
        );
    }

    {
        // Loading a string from a file.
        let str = inject!(#str("./examples/full.tt")); // this file contains `a, b`.
        assert_eq!(str, "a, b");
    }

    {
        // Loading an array from a file.
        let array: &'static [u8; 4] = inject!(
            #array("./examples/full.tt") // this file contains `a, b`.
        );
        assert_eq!(array, b"a, b");
    }

    {
        // Embedding compiler trees from a file in an arbitrary place of other macros.
        let a = 10;
        let b = 20;

        let mut end_str = String::new();
        inject! {
            let _e = write!(
                &mut end_str,

                "arg1: {}, arg2: {}",
                #tt("./examples/full.tt") // this file contains `a, b`.
            );
        }
        assert_eq!(end_str, "arg1: 10, arg2: 20");
    }
}