windows_gen 0.24.0

Code gen support for the windows crate
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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118

use crate::*;

pub fn gen_method_constraints(params: &[MethodParam], gen: &Gen) -> TokenStream {
    let mut tokens = TokenStream::with_capacity();

    for (position, param) in params.iter().enumerate() {
        if param.is_convertible() {
            let name = format_token!("Param{}", position);
            let into = gen_name(&param.signature.kind, gen);
            tokens.combine(&quote! { #name: ::windows::runtime::IntoParam<'a, #into>, });
        }
    }

    if !tokens.is_empty() {
        quote! { 'a, #tokens }
    } else {
        TokenStream::new()
    }
}

pub fn gen_win32_param(param: &MethodParam, gen: &Gen) -> TokenStream {
    gen_sig_with_const(&param.signature, gen, !param.param.flags().output())
}

pub fn gen_sig(sig: &Signature, gen: &Gen) -> TokenStream {
    gen_sig_with_const(sig, gen, sig.is_const)
}

fn gen_sig_with_const(sig: &Signature, gen: &Gen, is_const: bool) -> TokenStream {
    let mut tokens = TokenStream::with_capacity();

    for _ in 0..sig.pointers {
        if is_const {
            tokens.combine(&quote! { *const });
        } else {
            tokens.combine(&quote! { *mut });
        }
    }

    let kind = gen_name(&sig.kind, gen);

    if sig.kind.is_nullable() {
        tokens.combine(&quote! {
            ::std::option::Option<#kind>
        });
    } else {
        tokens.combine(&kind)
    }

    tokens
}

pub fn gen_abi_sig(sig: &Signature, gen: &Gen) -> TokenStream {
    let mut tokens = TokenStream::with_capacity();

    for _ in 0..sig.pointers {
        if sig.is_const {
            tokens.combine(&quote! { *const });
        } else {
            tokens.combine(&quote! { *mut });
        }
    }

    tokens.combine(&gen_abi_type_name(&sig.kind, gen));
    tokens
}

pub fn interface_method_features(def: &TypeDef, sig: &MethodSignature, gen: &Gen) -> TokenStream {
    if gen.root.is_empty() {
        return TokenStream::new();
    }

    let mut features = sig.method_features();
    features.insert(def.namespace());
    gen.gen_cfg(&features)
}

// TODO: should have option to return "not" version to avoid calculating method_features multiple times
pub fn method_features(sig: &MethodSignature, gen: &Gen) -> TokenStream {
    if gen.root.is_empty() {
        return TokenStream::new();
    }

    gen.gen_cfg(&sig.method_features())
}

// TODO: wasteful - don't do this
pub fn not_method_features(sig: &MethodSignature, gen: &Gen) -> TokenStream {
    if gen.root.is_empty() {
        return TokenStream::new();
    }

    gen.gen_cfg_not(&sig.method_features())
}

pub fn signature_features(sig: &Signature, gen: &Gen) -> TokenStream {
    if gen.root.is_empty() {
        return TokenStream::new();
    }

    let mut features = std::collections::BTreeSet::new();
    let mut keys = std::collections::HashSet::new();
    sig.kind.method_features(&mut features, &mut keys);

    gen.gen_cfg(&features)
}

pub fn struct_features(def: &TypeDef, gen: &Gen) -> TokenStream {
    if gen.root.is_empty() {
        return TokenStream::new();
    }

    let mut features = std::collections::BTreeSet::new();
    let mut keys = std::collections::HashSet::new();
    def.struct_features(&mut features, &mut keys);

    gen.gen_cfg(&features)
}