interoptopus_csharp 0.16.0-alpha.20

The C# backend for Interoptopus.
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

/// Builds a `RustLibrary`, registers inventory items and a plugin, then processes.
///
/// ```ignore
/// test_csharp!(plugin, [function!(my_function), service!(MyService)]);
/// ```
macro_rules! test_model {
    ($plugin:expr, [$($item:expr),* $(,)?]) => {{
        let mut inventory = ::interoptopus::inventory::RustInventory::new();
        $(let _ = inventory.register($item);)*
        let inventory = inventory.validate();
        ::interoptopus_csharp::RustLibrary::builder(inventory)
            .with_extension($plugin)
            .build()
            .process()
    }};
}

/// Performs an 'output' test.
///
/// Parameter `$file` is the output file name to snapshot. Must match one of
///   - `"Interop.cs"` — items with `FileEmission::Default` or `FileEmission::CustomModule(_)`
///   - `"Interop.Common.cs"` — items with `FileEmission::Common`
///
/// The rest are inventory registration expressions (e.g., `function!(my_fn)`, `service!(MyService)`)
/// that populate the `RustInventory`.
///
/// # Example
///
/// ```ignore
/// test_output!("Interop.cs", [service!(MyService), function!(my_fn)]);
/// ```
macro_rules! test_output {
    ($file:expr, [$($item:expr),* $(,)?]) => {{
        use interoptopus_csharp::dispatch::Dispatch;
        use interoptopus_csharp::config::HeaderConfig;
        use interoptopus_csharp::output::Target;
        use interoptopus::lang::meta::FileEmission;
        let mut inventory = ::interoptopus::inventory::RustInventory::new();
        $(let _ = inventory.register($item);)*
        let inventory = inventory.validate();
        let multibuf = ::interoptopus_csharp::RustLibrary::builder(inventory)
            .dispatch(Dispatch::custom(|x, _| match x.emission {
                FileEmission::Common => Target::new("Interop.Common.cs", "My.Company.Common"),
                FileEmission::Default | FileEmission::CustomModule(_) => Target::new("Interop.cs", "My.Company"),
            }))
            .headers(HeaderConfig { emit_version: false })
            .build()
            .process()
            .unwrap();

        // In these tests we are only
        let output = multibuf.buffer($file).unwrap();

        insta::assert_snapshot!(output);
    }};
}

/// Creates an ad-hoc plugin that runs the given block in `post_model_all`.
///
/// The block has access to `inventory: &RustInventory` and `models: PostModelPass`.
///
/// ```ignore
/// let plugin = debug_plugin!(|inventory, models| {
///     dbg!(&models);
/// });
/// ```
macro_rules! debug_plugin {
    (|$inventory:ident, $models:ident| $body:expr) => {{
        struct __DebugPlugin;

        impl ::interoptopus_csharp::extensions::RustCodegenExtension for __DebugPlugin {
            fn post_model_all(
                &mut self,
                $inventory: &::interoptopus::inventory::RustInventory,
                $models: ::interoptopus_csharp::extensions::PostModelPass,
            ) -> Result<(), ::interoptopus_csharp::Error> {
                $body;
                Ok(())
            }
        }

        __DebugPlugin
    }};
}