crates.io是 Rust 社区的中央存储库,用作发现和下载包的位置。cargo
默认配置为,使用它来查找请求的包.
获取托管在crates.io的依赖'库',将它添加到您的Cargo.toml
.
如果你的Cargo.toml
,还没有[dependencies]
部分,添加它,然后列出您要使用的包名称和版本。这个例子增加了一个time
箱(crate)依赖:
[dependencies]
time = "0.1.12"
版本字符串是semver版本要求。该指定依赖项文档 提供了有关此处选项的更多信息.
如果我们还想添加一个regex
箱子依赖,我们不需要为每个箱子都添加[dependencies]
。下面就是你的Cargo.toml
文件整体,看起来像依赖于time
和regex
箱:
[package]
name = "hello_world"
version = "0.1.0"
authors = ["Your Name <[email protected]>"]
[dependencies]
time = "0.1.12"
regex = "0.1.41"
重新运行cargo build
,Cargo 将获取新的依赖项及其所有依赖项,将它们全部编译,然后更新Cargo.lock
:
$ cargo build
Updating registry `https://github.com/rust-lang/crates.io-index`
Downloading memchr v0.1.5
Downloading libc v0.1.10
Downloading regex-syntax v0.2.1
Downloading memchr v0.1.5
Downloading aho-corasick v0.3.0
Downloading regex v0.1.41
Compiling memchr v0.1.5
Compiling libc v0.1.10
Compiling regex-syntax v0.2.1
Compiling memchr v0.1.5
Compiling aho-corasick v0.3.0
Compiling regex v0.1.41
Compiling hello_world v0.1.0 (file:///path/to/project/hello_world)
我们的Cargo.lock
包含有关,我们使用的所有这些依赖项的哪个版本的确实信息.
现在,如果regex
在crates.io上更新了,在我们选择cargo update
之前,我们仍会使用相同的版本进行构建.
你现在可以使用regex
箱了,通过在main.rs
使用extern crate
。
extern crate regex;
use regex::Regex;
fn main() {
let re = Regex::new(r"^\d{4}-\d{2}-\d{2}$").unwrap();
println!("Did our date match? {}", re.is_match("2014-01-01"));
}
运行它将显示:
$ cargo run
Running `target/hello_world`
Did our date match? true