#dll #c #link #linker #build-script #download #build #hyperlink #libraries #build-scripts

librarian

A crate for downloading and linking to non-rust libraries from app build scripts

4 releases

0.2.3 Oct 22, 2020
0.2.2 Jun 20, 2020
0.2.1 Jun 19, 2020
0.2.0 Jun 19, 2020
0.1.0 Jun 18, 2020

#247 in Build Utils

0BSD OR MIT OR Apache-2.0 and maybe LGPL-3.0

21KB
412 lines

crates.io docs.rs

Librarian - a Rust crate for downloading and linking to non-rust libraries from app build scripts

When I started using C libraries in Rust on Windows, what bothered me a lot was the fact that while normally building a crate just requires cargo build, if you have to link to a C library and especially if you have to use a DLL, the process becomes more complicated. To eliminate that, I made this crate for myself and am publishing it in hope it will be useful to others.

Do note that right now the project is only tested in a limited amount of environments, so I don't guarantee it will work for you, and I don't guarantee backwards compatibility. However if it doesn't work for you you're welcome to contribute!

It probably isn't feasible to integrate with all the different build systems there are to allow automatically fetching source and building it. While it makes me appreciate the Rust build system, it means automatic downloading will only work for prebuilt libraries.

(Current) Features

  • Downloading .zip/.tgz archives with prebuilt C libraries
  • A wrapper for adding a link search path (cargo:rustc-link-search)
  • A way to copy .dll/.so files to the build folder (Currently only makes sense to do from app build scripts, not lib build scripts)

Installing

To use Librarian in your build script, add the following to your Cargo.toml:

[build-dependencies]
librarian = "*"

License

TL;DR do whatever you want

Licensed under either the BSD Zero Clause License (https://opensource.org/licenses/0BSD), the Apache 2.0 License (http://www.apache.org/licenses/LICENSE-2.0) or the MIT License (http://opensource.org/licenses/MIT), at your choice.

Dependencies

~0–8.5MB
~154K SLoC