Crate test_cdylib

test-cdylib is a library for dynamically linking to cdylib projects from test code. This allows testing for the existence of exported items.

Testing a cdylib project

A cdylib project can be tested like this:

#[test]
fn api_test() {
    let dylib_path = test_cdylib::build_current_project();

    // Or load the shared library using any other method of your choice.
    let dylib = dlopen::symbor::Library::open(&dylib_path).unwrap();

    // Test the api as necessary.
}

This will build the current project, if it is not already built, and return the path to the compiled library.

Testing a cdylib building library

Libraries that are meant to help create cdylib interfaces can be tested in two ways. First is to link to an example, e.g.

#[test]
fn api_gen_test() {
    let dylib_path = test_cdylib::build_example("example");

    // Or load the shared library using any other method of your choice.
    let dylib = dlopen::symbor::Library::open(&dylib_path).unwrap();

    // Test the api as necessary.
}

This will build the example and return the path to the compiled library.

The second way is to build a file as a cdylib, e.g.

#[test]
fn api_gen_test() {
    let dylib_path = test_cdylib::build_path("tests/cdylib/api_test.rs");

    // Or load the shared library using any other method of your choice.
    let dylib = dlopen::symbor::Library::open(&dylib_path).unwrap();

    // Test the api as necessary.
}

This will build the given file as a cdylib project, and return the path to the compiled library. All dependencies and dev-dependencies are available. Note that this will cause all dependencies to be rebuilt, which can slow down testing significantly.

Multiple tests with the same library

Multiple tests can link to the same library by using once_cell to contain the path to the library, e.g.

use std::path::PathBuf;
use once_cell::sync::Lazy;
static LIB_PATH: Lazy<PathBuf> = Lazy::new(|| test_cdylib::build_current_project());

The same can be done for both build_example and build_path.

Functions

build_current_project	Builds the current project as a cdylib and returns the path to the compiled object.
build_example	Builds the given example as a cdylib and returns the path to the compiled object.
build_file	Builds the given file as a cdylib and returns the path to the compiled object.