You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
To use Rust-Bio in your Rust project, add the following to your Cargo.toml
[dependencies]
bio = "*"
Crates like Rust-Bio should follow Rust conventions like semantic versioning, which says:
Given a version number MAJOR.MINOR.PATCH, increment the:
MAJOR version when you make incompatible API changes
MINOR version when you add functionality in a backward compatible manner
PATCH version when you make backward compatible bug fixes
Additional labels for pre-release and build metadata are available as extensions to the MAJOR.MINOR.PATCH format.
cargo uses that convention when figuring out which version of Rust-Bio to download. So, Cargo.toml should instead include, at the least:
[dependencies]
bio = "1"
To explain why, let's say that someone makes a nice library crate that depends on Rust-Bio. With bio = "*", that nice library crate will stop compiling successfully if a beneficial improvement to Rust-Bio ever requires making backwards-incompatible changes. The users of that nice library crate will not really be able to fix that themselves since they don't control that nice library crate. With bio = "1", the nice library crate will continue to use version 1 even after version 2 comes out, avoiding that problem.
Even if Rust-Bio will never make backwards-incompatible changes, it would then never have its major version changed, and so bio = "1" would also work fine in that scenario.
The text was updated successfully, but these errors were encountered:
On the home page of Rust-Bio's documentation, it says
Crates like Rust-Bio should follow Rust conventions like semantic versioning, which says:
cargo
uses that convention when figuring out which version of Rust-Bio to download. So,Cargo.toml
should instead include, at the least:To explain why, let's say that someone makes a nice library crate that depends on Rust-Bio. With
bio = "*"
, that nice library crate will stop compiling successfully if a beneficial improvement to Rust-Bio ever requires making backwards-incompatible changes. The users of that nice library crate will not really be able to fix that themselves since they don't control that nice library crate. Withbio = "1"
, the nice library crate will continue to use version 1 even after version 2 comes out, avoiding that problem.Even if Rust-Bio will never make backwards-incompatible changes, it would then never have its major version changed, and so
bio = "1"
would also work fine in that scenario.The text was updated successfully, but these errors were encountered: