configtpl 0.1.0

A configuration library which uses Jinja + YAML to render the configuration values.
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

use std::sync::{LazyLock, Mutex};

use crate::{
    config_builder::ConfigBuilder,
    shared_lib::ffi::{types::{
            collections::ArrayStringKV, lib_types, std_types::ConstCharPtr
        }, utils::strings::{cchar_const_deallocate, cchar_to_string}}, types::config_param::ConfigParam
};

/// cbindgen:ignore
static CFG_BUILDERS: LazyLock<Mutex<Vec<Option<ConfigBuilder>>>> = LazyLock::new(|| {
    Mutex::new(Vec::new())
});

/// Creates a new instance of configuration builder
#[unsafe(no_mangle)]
pub extern "C" fn configtpl_configbuilder_new() -> lib_types::CfgBuilderHandle {
    let builder = ConfigBuilder::new();
    let mut envs = CFG_BUILDERS.lock().unwrap();
    envs.push(Some(builder));
    (envs.len() - 1) as lib_types::CfgBuilderHandle
}

#[unsafe(no_mangle)]
pub extern "C" fn configtpl_configbuilder_build_from_files(env_handle: lib_types::CfgBuilderHandle, paths: ConstCharPtr,
                                              overrides: *const ArrayStringKV,
                                              ctx: *const ArrayStringKV) -> *const lib_types::BuildResult {
    let cfg_builders = CFG_BUILDERS.lock().unwrap();
    let cfg_builder = match cfg_builders.get(env_handle as usize) {
        Some(e) => match e {
            Some(e2) => Some(e2),
            None => None,
        },
        None => None,
    };
    let cfg_builder = match cfg_builder {
        Some(b) => b,
        None => return lib_types::BuildResult::new_error_invalid_handle().into(),
    };

    let overrides: Option<ConfigParam> = if overrides.is_null() {
        None
    } else {
        let overrides: ConfigParam = overrides.into();
        Some(overrides)
    };
    let ctx: Option<ConfigParam> = if ctx.is_null() {
        None
    } else {
        let ctx: ConfigParam = ctx.into();
        Some(ctx)
    };


    match cfg_builder.build_from_files(&cchar_to_string(paths), &overrides, &ctx) {
        Ok(v) => v.into(),
        Err(e) => lib_types::BuildResult::new_error_building(&e).into(),
    }

}

/// Deallocates memory of configuration builder result
#[unsafe(no_mangle)]
pub extern "C" fn configtpl_configbuilder_result_free(r: *mut lib_types::BuildResult) {
    if r.is_null() {
        return
    }

    let r_box = unsafe { Box::from_raw(r) };
    if r_box.error_msg.is_aligned() {
        cchar_const_deallocate(r_box.error_msg);
    }
    if r_box.output.data.is_aligned() {
        for i in 0..r_box.output.len {
            let data = unsafe { *r_box.output.data.offset(i as isize) };
            cchar_const_deallocate(data[0]);
            cchar_const_deallocate(data[1]);
        }

    }
}

/// Deallocates memory of configuration builder instance
#[unsafe(no_mangle)]
pub extern "C" fn configtpl_configbuilder_free(env_handle: lib_types::CfgBuilderHandle) {
    let mut envs = CFG_BUILDERS.lock().unwrap();
    envs[env_handle as usize] = None;
}