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

// Take a look at the license at the top of the repository in the LICENSE file.

mod attribute_parser;
mod composite_template_derive;
mod util;

use proc_macro::TokenStream;
use proc_macro_error::proc_macro_error;
use syn::{parse_macro_input, DeriveInput};

/// Derive macro for using a composite template in a widget.
///
/// The `template` attribute specifies where the template should be loaded
/// from;  it can be a `file`, a `resource`, or a `string`.
///
/// The `template_child` attribute is used to mark all internal widgets
/// we need to have programmatic access to.
///
/// # Example
///
/// Specify that `MyWidget` is using a composite template and load the
/// template file the `composite_template.ui` file.
///
/// ```compile_fail
/// use gtk::prelude::*;
/// use gtk::CompositeTemplate;
///
/// #[derive(Debug, Default, CompositeTemplate)]
/// #[template(file = "composite_template.ui")]
/// struct MyWidget {
///     #[template_child]
///     pub label: TemplateChild<gtk::Label>,
/// }
/// ```
///
/// Then, in the `ObjectSubclass` implementation you will need to call
/// `bind_template` in the `class_init` function, and `init_template` in
/// `instance_init` function.
///
///
/// ```compile_fail
/// #[glib::object_subclass]
/// impl ObjectSubclass for MyWidget {
///        const NAME: &'static str = "MyWidget";
///        type Type = super::MyWidget;
///        type ParentType = gtk::Widget;
///
///        fn class_init(klass: &mut Self::Class) {
///            Self::bind_template(klass);
///        }
///
///        fn instance_init(obj: &glib::subclass::InitializingObject<Self>) {
///            obj.init_template();
///        }
///    }
/// ```
#[proc_macro_derive(CompositeTemplate, attributes(template, template_child))]
#[proc_macro_error]
pub fn composite_template_derive(input: TokenStream) -> TokenStream {
    let input = parse_macro_input!(input as DeriveInput);
    let gen = composite_template_derive::impl_composite_template(&input);
    gen.into()
}