libcsp-rust/libcsp-sys/README.md

1.6 KiB

Crates.io docs.rs

libcsp-sys

This crate provides FFI bindings for the libcsp library.

Generally, you probably do not want to use this library directly and instead use the libcsp Rust crate which provides a safe and ergonomic Rust API. You can find some more high-level information and examples in the main repository.

Compile-time configuration of the libcsp-rust library

The libcsp-rust library requires some compile-time configuration file to be included to work properly. You can see an example version of the file for the workspace here. The user has to provide the path to a directory containing this autoconfig.rs file using the CSP_CONFIG_DIR environmental variable.

It is recommended to read the main workspace README for more information to make the generation and specification of this auto-configuration file as conveniently and easy as possible.

Run unittests

Running unittests required the RUN_TESTS environmental variable to be set to 1. This is because the actual libcsp library might be built and linked in a separate crate, so the linker is not able to process -l csp when running the tests.

You can use

RUN_TESTS=1 cargo test

to run the unittests.