dlrkit 0.1.3

dlrkit provides an API for interacting with the dynamic linker and loading libraries at runtime such as .so files and .dll files. Useful for executing code from external libraries using the C ABI.
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

use std::sync::OnceLock;

const LIBRARY_PATH: &str = {
    if cfg!(target_os = "windows") {
        "target\\debug\\deps\\example_lib.dll"
    } else if cfg!(any(target_os = "macos", target_os = "ios")) {
        "target/debug/deps/libexample_lib.dylib"
    } else {
        "target/debug/deps/libexample_lib.so"
    }
};

static LIB: OnceLock<dlrkit::Dl> = OnceLock::new();

static ADD: OnceLock<dlrkit::Sym<AddSignature>> = OnceLock::new();

type AddSignature = fn(left: u64, right: u64) -> u64;

fn main() {
    do_add();
}

fn do_add() {
    let add = ADD.get_or_init(|| load_add());

    eprintln!("add result: {}", add(67, 2));
}

fn load_add() -> dlrkit::Sym<'static, AddSignature> {
    let lib = LIB.get_or_init(|| load_library());

    unsafe { lib.sym("add").unwrap() }
}

fn load_library() -> dlrkit::Dl {
    unsafe { dlrkit::Dl::open(Some(LIBRARY_PATH)).unwrap() }
}