Add example of `cargo add`

2022-08-29 00:38:29 +02:00 · 2022-08-29 00:38:29 +02:00 · d66cb9871d
parent 98c6225e5f
commit d66cb9871d
5 changed files with 131 additions and 0 deletions
--- a/listings/ch02-guessing-game-tutorial/no-listing-06-cargo-add/Cargo.lock
+++ b/listings/ch02-guessing-game-tutorial/no-listing-06-cargo-add/Cargo.lock
@ -0,0 +1,83 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+[[package]]
+name = "cfg-if"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "baf1de4339761588bc0619e3cbc0120ee582ebb74b53b4efbf79117bd2da40fd"
+
+[[package]]
+name = "getrandom"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c9495705279e7140bf035dde1f6e750c162df8b625267cd52cc44e0b156732c8"
+dependencies = [
+ "cfg-if",
+ "libc",
+ "wasi",
+]
+
+[[package]]
+name = "guessing_game"
+version = "0.1.0"
+dependencies = [
+ "rand",
+]
+
+[[package]]
+name = "libc"
+version = "0.2.86"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b7282d924be3275cec7f6756ff4121987bc6481325397dde6ba3e7802b1a8b1c"
+
+[[package]]
+name = "ppv-lite86"
+version = "0.2.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ac74c624d6b2d21f425f752262f42188365d7b8ff1aff74c82e45136510a4857"
+
+[[package]]
+name = "rand"
+version = "0.8.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0ef9e7e66b4468674bfcb0c81af8b7fa0bb154fa9f28eb840da5c447baeb8d7e"
+dependencies = [
+ "libc",
+ "rand_chacha",
+ "rand_core",
+ "rand_hc",
+]
+
+[[package]]
+name = "rand_chacha"
+version = "0.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e12735cf05c9e10bf21534da50a147b924d555dc7a547c42e6bb2d5b6017ae0d"
+dependencies = [
+ "ppv-lite86",
+ "rand_core",
+]
+
+[[package]]
+name = "rand_core"
+version = "0.6.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "34cf66eb183df1c5876e2dcf6b13d57340741e8dc255b48e40a26de954d06ae7"
+dependencies = [
+ "getrandom",
+]
+
+[[package]]
+name = "rand_hc"
+version = "0.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3190ef7066a446f2e7f42e239d161e905420ccab01eb967c9eb27d21b2322a73"
+dependencies = [
+ "rand_core",
+]
+
+[[package]]
+name = "wasi"
+version = "0.10.2+wasi-snapshot-preview1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fd6fbd9a79829dd1ad0cc20627bf1ed606756a7f77edff7b66b7064f9cb327c6"
--- a/listings/ch02-guessing-game-tutorial/no-listing-06-cargo-add/Cargo.toml
+++ b/listings/ch02-guessing-game-tutorial/no-listing-06-cargo-add/Cargo.toml
@ -0,0 +1,8 @@
+[package]
+name = "guessing_game"
+version = "0.1.0"
+edition = "2021"
+
+# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
+
+[dependencies]
--- a/listings/ch02-guessing-game-tutorial/no-listing-06-cargo-add/output.txt
+++ b/listings/ch02-guessing-game-tutorial/no-listing-06-cargo-add/output.txt
@ -0,0 +1,18 @@
+$ cargo add rand@0.8.3
+    Updating crates.io index
+      Adding rand v0.8.3 to dependencies.
+             Features:
+             + alloc
+             + getrandom
+             + libc
+             + rand_chacha
+             + rand_hc
+             + std
+             + std_rng
+             - log
+             - nightly
+             - packed_simd
+             - serde
+             - serde1
+             - simd_support
+             - small_rng
--- a/listings/ch02-guessing-game-tutorial/no-listing-06-cargo-add/src/main.rs
+++ b/listings/ch02-guessing-game-tutorial/no-listing-06-cargo-add/src/main.rs
@ -0,0 +1,15 @@
+use std::io;
+
+fn main() {
+    println!("Guess the number!");
+
+    println!("Please input your guess.");
+
+    let mut guess = String::new();
+
+    io::stdin()
+        .read_line(&mut guess)
+        .expect("Failed to read line");
+
+    println!("You guessed: {guess}");
+}
--- a/src/ch02-00-guessing-game-tutorial.md
+++ b/src/ch02-00-guessing-game-tutorial.md
@ -362,6 +362,13 @@ that will still compile with the code in this chapter. Any version `0.9.0` or
 greater is not guaranteed to have the same API as what the following examples
 use.

+Instead of manually adding the dependency by editing the *Cargo.toml* file, we
+can ask Cargo to add the dependency for us, using the `cargo add` command:
+
+```console
+{{#include ../listings/ch02-guessing-game-tutorial/no-listing-06-cargo-add/output.txt}}
+```
+
 Now, without changing any of the code, let’s build the project, as shown in
 Listing 2-2.