2024-06-01 19:55:10 +02:00
|
|
|
[](https://crates.io/crates/libcsp-sys)
|
|
|
|
|
[](https://docs.rs/libcsp-sys)
|
|
|
|
|
|
2024-05-29 00:25:05 +02:00
|
|
|
libcsp-sys
|
|
|
|
|
========
|
|
|
|
|
|
|
|
|
|
This crate provides FFI bindings for the [`libcsp` library](https://github.com/libcsp/libcsp).
|
|
|
|
|
|
|
|
|
|
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](https://egit.irs.uni-stuttgart.de/rust/libcsp-rust).
|
|
|
|
|
|
|
|
|
|
## 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](https://egit.irs.uni-stuttgart.de/rust/libcsp-rust/src/branch/main/examples/autoconfig.rs).
|
|
|
|
|
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](https://egit.irs.uni-stuttgart.de/rust/libcsp-rust)
|
|
|
|
|
for more information to make the generation and specification of this auto-configuration file
|
|
|
|
|
as conveniently and easy as possible.
|
2024-06-01 18:59:27 +02:00
|
|
|
|
|
|
|
|
## 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
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
RUN_TESTS=1 cargo test
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
to run the unittests.
|
