Search code examples
rustrust-cargorust-2018

How to idiomatically alias a crate in Rust 2018?

I have a crate foo_sys. In Rust 2015 I used extern crate foo_sys as foo for convenience, but in Rust 2018 extern crate isn't needed anymore and I don't want to use it only for aliasing. When dropping extern crate, I get

error[E0463]: can't find crate for foo

Solution

  • This can be achieved with the rename-dependency Cargo feature, available in Rust 1.31. With this feature, it's possible to provide a package attribute to the dependencies:

    The rename-dependency feature allows you to import a dependency with a different name from the source. This can be useful in a few scenarios:

    • Depending on crates with the same name from different registries.
    • Depending on multiple versions of a crate.
    • Avoid needing extern crate foo as bar in Rust source.

    Instead of writing

    [dependencies]
foo_sys = "0.2"

    the package key can be added to the dependency in Cargo.toml:

    [dependencies]
foo = { package = "foo_sys", version = "0.2" }

    WARNING: Cargo prior to Rust 1.26.0 may download the wrong dependency when using this feature!