Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Installer des binaires avec cargo install

La commande cargo install vous permet d’installer et d’utiliser des crates binaires localement. Cela n’est pas destine a remplacer les paquets système ; c’est un moyen pratique pour les développeurs Rust d’installer des outils que d’autres ont partages sur crates.io. Notez que vous ne pouvez installer que des paquets qui ont des cibles binaires. Une cible binaire est le programme exécutable qui est crée si le crate possède un fichier src/main.rs ou un autre fichier spécifié comme binaire, par opposition à une cible de bibliothèque qui n’est pas exécutable en soi mais qui est adaptee pour être incluse dans d’autres programmes. En general, les crates contiennent des informations dans le fichier README indiquant si un crate est une bibliothèque, possède une cible binaire, ou les deux.

Tous les binaires installés avec cargo install sont stockés dans le dossier bin du repertoire racine d’installation. Si vous avez installé Rust avec rustup.rs et que vous n’avez aucune configuration personnalisee, ce repertoire sera $HOME/.cargo/bin. Assurez-vous que ce repertoire est dans votre $PATH pour pouvoir exécuter les programmes que vous avez installés avec cargo install.

Par exemple, dans le chapitre 12, nous avons mentionné qu’il existe une implémentation en Rust de l’outil grep appelée ripgrep pour rechercher dans les fichiers. Pour installer ripgrep, nous pouvons exécuter la commande suivante :

$ cargo install ripgrep
    Updating crates.io index
  Downloaded ripgrep v14.1.1
  Downloaded 1 crate (213.6 KB) in 0.40s
  Installing ripgrep v14.1.1
--snip--
   Compiling grep v0.3.2
    Finished `release` profile [optimized + debuginfo] target(s) in 6.73s
  Installing ~/.cargo/bin/rg
   Installed package `ripgrep v14.1.1` (executable `rg`)

L’avant-derniere ligne de la sortie indique l’emplacement et le nom du binaire installé, qui dans le cas de ripgrep est rg. Tant que le repertoire d’installation est dans votre $PATH, comme mentionné precedemment, vous pouvez alors exécuter rg --help et commencer à utiliser un outil plus rapide, écrit en Rust, pour rechercher dans les fichiers !