📦 RSFindLibs: Rust Dynamic Library Finder & Wrapper Generator

A handy Rust library for:

1. 🔍 Finding dynamic libraries at runtime.
2. 🛠️ Generates the boilerplate needed by libloading

🔍 Library Finder

The find function helps you locate a dynamic library (.so, .dylib, .dll) at runtime by searching in:

• 🏗️ System paths
• ⚙️ Environment-specific paths (e.g., $CONDA_PREFIX, LD_LIBRARY_PATH)
• 🔧 Custom-configured directories

Example

let libpath = rsfindlibs::find("fdb5", None).expect("Library not found");
println!("Library found at: {}", libpath);

🛠️ Macro for Generating Wrappers

The generate_library_wrapper! macro simplifies working with dynamic libraries by generating structs to load and call their functions seamlessly.

How It Works

1. Declare the library functions you want to use.
2. The macro generates a wrapper struct that loads the library and makes functions accessible like native Rust functions.

Example

use rsfindlibs::generate_library_wrapper;
use libloading::Library;

generate_library_wrapper! {
    FdbApiWrapper {
        fn fdb_new_handle(fdb: *mut *mut FdbHandle) -> c_int;
        fn fdb_initialise() -> c_int;
        fn fdb_flush(fdb: *mut FdbHandle) -> c_int;
    }
}

pub static FDBLIB: Lazy<Arc<FdbApiWrapper>> = Lazy::new(|| {
    let libpath = rsfindlibs::find("fdb5", None).expect("FDB5 library not found");
    let raw_lib = Library::new(&libpath).expect("Failed to load library");
    let fdblib_wrapper = FdbApiWrapper::load(raw_lib).map_err(|e| e.to_string()).expect("Failed to wrap FDB5 library");
    Arc::new(fdblib_wrapper)
});

🚀 Installation

Add the following to your Cargo.toml:

[dependencies]
rsfindlibs = "0.1"

📄 License

Apache 2.0