In my very large Rust-based project of about 100k lines of code, 100 direct dependencies, and 800 total dependencies, I always require version="*"
for each dependency, except for specific ones that either I cannot or don’t want to upgrade.
Crucially, I also commit my Cargo.lock
, as the Cargo manual recommends.
I normally build with cargo --locked
. Periodically, I will do a cargo update
and run cargo outdated
so that I’m able to see if there are specific packages keeping me at older versions.
To upgrade a specific package, I can just remove its record directly from Cargo.lock
and then do a regular cargo build
.
This works very well!
Advantages
- I minimize my number of dependencies, and therefor build times
- I keep my personal ecosystem from falling too far behind that of crates.io
- I rarely wind up with a situation where I have two dependencies that depend on a different symbol version
- I don’t have to change a version in all of my many
Cargo.toml
s
Disadvantages
- I cannot publish my large repository to a wider audience (but that will never happen for this repository)
- People who see my code start feeling ill and start shifting their eyes nervously.
I once had a project where I added a crate and a completely different part of the application that didn’t use that crate broke.
Turns out that I didn’t include the patch version in a dependency and that new dependency required an earlier patch version that had a critical bug in it.
Your solution is like this, but even more extreme by also allowing a dependency to get your code to link to an old major version, breaking everything.
So, your solution only works if you don’t plan to ever add a new dependency.
In practice, I have about 10% of my dependencies not have the latest version, according to
cargo-outdated
, once I complete acargo update
.For personal projects this is fine, but I’m curious why you feel the need to have every crate be the newest? Once you have it compiling, why upgrade dependencies at all unless you have to? Compiling a new binary is way more work than just running the one that is already compiled. You talk about minimizing build times with this method, but it isn’t clear why recompiling at all with newer dependencies is beneficial.
Theoretically, every update to a crate is better than the last, but sometimes it’s just adding non-breaking features that you weren’t using anyway. You could just check crate updates every once in a while looking for performance gains or features you would like to make use of.
Could also be performance benefits. You could research into updates of every dependency (and some crates don’t publish changelogs, so you have to dive through commit messages), but who has the time for that?
My experience is that keeping up-to-date is beneficial in any language:
I’m not obsessive, though. If a few packages are out-of-date due to some dependency that I want to hold back, it’s fine. And I only do the
cargo update
once or twice a month anyway.