interoptopus_csharp 0.16.0-alpha.15

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

use crate::RustLibrary;
use crate::config::{HeaderConfig, SearchPathConfig};
use crate::dispatch::Dispatch;
use crate::pipeline::RustLibraryConfig;
use interoptopus::inventory::RustInventory;
use interoptopus_backends::template::TemplateEngine;

/// Builder for configuring and constructing a [`RustLibrary`].
#[derive(Default)]
pub struct RustLibraryBuilder {
    inventory: RustInventory,
    config: RustLibraryConfig,
}

impl RustLibraryBuilder {
    pub(crate) fn new(inventory: RustInventory) -> Self {
        Self { inventory, ..Self::default() }
    }

    /// Sets the dispatch strategy that routes items to output files.
    #[must_use]
    pub fn dispatch(mut self, dispatch: Dispatch) -> Self {
        self.config.output_master.dispatch = dispatch;
        self
    }

    /// Sets the native library name used in `[DllImport("...")]` declarations.
    #[must_use]
    pub fn dll_name(mut self, dll_name: impl AsRef<str>) -> Self {
        self.config.meta_info.dll_name = dll_name.as_ref().to_string();
        self
    }

    /// Configures the generation of the file header.
    #[must_use]
    pub fn header_config(mut self, header_config: HeaderConfig) -> Self {
        self.config.output_header = header_config;
        self
    }

    /// What DLL loading policies to emit.
    #[must_use]
    pub fn search_path_config(mut self, search_path: SearchPathConfig) -> Self {
        self.config.output_search_path = search_path;
        self
    }

    /// Allows users to specify custom templates for code generation.
    ///
    /// Currently not exposed as we'd implicitly stabilize a huge template definition
    /// surface.
    fn templates(mut self, templates: TemplateEngine) -> Self {
        self.config.output_master.templates = templates;
        self
    }

    /// Builds the configured [`RustLibrary`], ready for [`process`](RustLibrary::process).
    #[must_use]
    pub fn build(self) -> RustLibrary {
        RustLibrary::with_config(self.inventory, self.config)
    }
}