In your Cargo.toml:
``` [dependencies] varnish = "0.0.7"
varnish-sys = "0.0.7" ```
Varnish bindings, notably to build vmods
varnish-rs works on stable Rust and should be fine with more recent versions too. If it doesn't, plus open an issue.
varnish-rs relies on varnish-sys (in this same repository) to generate bindings from the libvarnish headers which you will need to install, depending on you linux distribution, the related package can be named varnish-devel, varnish-dev or maybe libvarnish-dev.
Right now, the only Varnish version supported is 7.0.
At the moment, we use an embedded python script to generate the boilerplate that exposes the rust vmod code to Varnish. Make sure that python3 is in your path.
bash
git clone https://github.com/gquintard/varnish-rs.git
cd varnish-rs
cargo build
If your varnish headers are installed where pkg-config can find them, it's all there is to it. If not, you can set the VARNISH_INCLUDE_PATHS environment variable to a colon-separated list of paths to search:
VARNISH_INCLUDE_PATHS=/my/custom/libpath:/my/other/custom/libpath cargo build
The varnish-rs and varnish-sys versions will work in tandem: to build version X of varnish, you need version X of varnish-sys, in turn varnish-sys will depend on a specific Varnish C library version:
| varnish-sys (rust) | libvarnish (C) | | :----------------: | :------------: | | 0.0.1 to 0.0.7 | 7.0 |
You can check which Varnish version is required using the libvarnish metadata field of varnish-sys:
bash
cargo metadata --format-version 1 | jq -r '.packages[] | select(.name == "varnish-sys") | .metadata.libvarnishapi.version '