The Rust Programming Language

Installation

La première étape est d’installer Rust. Nous telechargerons Rust via rustup, un outil en ligne de commande permettant de gérer les versions de Rust et les outils associes. Vous aurez besoin d’une connexion internet pour le téléchargement.

Note : si vous préférez ne pas utiliser rustup pour une raison quelconque, veuillez consulter la page des autres méthodes d’installation de Rust pour plus d’options.

Les étapes suivantes installent la derniere version stable du compilateur Rust. Les garanties de stabilite de Rust assurent que tous les exemples du livre qui compilent continueront a compiler avec les versions plus récentes de Rust. La sortie peut varier legerement d’une version à l’autre, car Rust ameliore souvent les messages d’erreur et les avertissements. Autrement dit, toute version stable plus récente de Rust que vous installez en suivant ces étapes devrait fonctionner comme prevu avec le contenu de ce livre.

Installer rustup sur Linux ou macOS

Si vous utilisez Linux ou macOS, ouvrez un terminal et entrez la commande suivante :

$ curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf | sh

La commande téléchargé un script et lance l’installation de l’outil rustup, qui installé la derniere version stable de Rust. Il se peut que votre mot de passe vous soit demande. Si l’installation reussit, la ligne suivante apparaîtra :

Rust is installed now. Great!

Vous aurez également besoin d’un linker (éditeur de liens), qui est un programme que Rust utilise pour regrouper ses sorties compilées en un seul fichier. Il est probable que vous en ayez déjà un. Si vous obtenez des erreurs de linker, vous devriez installer un compilateur C, qui inclura généralement un éditeur de liens. Un compilateur C est également utile car certains packages Rust courants dependent de code C et nécessitent un compilateur C.

Sur macOS, vous pouvez obtenir un compilateur C en exécutant :

$ xcode-select --install

Les utilisateurs Linux devraient généralement installer GCC ou Clang, conformement à la documentation de leur distribution. Par exemple, si vous utilisez Ubuntu, vous pouvez installer le paquet build-essential.

Installer rustup sur Windows

Sur Windows, rendez-vous sur https://www.rust-lang.org/tools/install et suivez les instructions pour installer Rust. À un moment de l’installation, il vous sera demandé d’installer Visual Studio. Celui-ci fournit un éditeur de liens et les bibliothèques natives nécessaires pour compiler les programmes. Si vous avez besoin d’aide supplémentaire pour cette étape, consultez https://rust-lang.github.io/rustup/installation/windows-msvc.html.

Le reste de ce livre utilise des commandes qui fonctionnent aussi bien dans cmd.exe que dans PowerShell. S’il y à des differences spécifiques, nous expliquerons laquelle utiliser.

Resolution de problèmes

Pour vérifier que Rust est correctement installé, ouvrez un terminal et entrez cette ligne :

$ rustc --version

Vous devriez voir le numéro de version, le hash du commit et la date du commit pour la derniere version stable publiée, dans le format suivant :

rustc x.y.z (abcabcabc yyyy-mm-dd)

Si vous voyez cette information, vous avez installé Rust avec succès ! Si vous ne voyez pas cette information, vérifiez que Rust se trouve dans votre variable système %PATH% comme suit.

Dans le CMD Windows, utilisez :

> echo %PATH%

Dans PowerShell, utilisez :

> echo $env:Path

Sous Linux et macOS, utilisez :

$ echo $PATH

Si tout est correct et que Rust ne fonctionne toujours pas, il existe plusieurs endroits où vous pouvez obtenir de l’aide. Découvrez comment entrer en contact avec d’autres Rustaceans (un surnom amusant que nous nous donnons) sur la page de la communauté.

Mise à jour et désinstallation

Une fois Rust installé via rustup, la mise à jour vers une nouvelle version est simple. Depuis votre terminal, exécutez le script de mise à jour suivant :

$ rustup update

Pour désinstaller Rust et rustup, exécutez le script de désinstallation suivant depuis votre terminal :

$ rustup self uninstall

Lire la documentation locale

L’installation de Rust inclut également une copie locale de la documentation afin que vous puissiez la lire hors ligne. Exécutez rustup doc pour ouvrir la documentation locale dans votre navigateur.

Chaque fois qu’un type ou une fonction est fourni par la bibliothèque standard et que vous n’etes pas sur de ce qu’il fait ou comment l’utiliser, consultez la documentation de l’interface de programmation applicative (API) pour le découvrir !

Utiliser des éditeurs de texte et des IDE

Ce livre ne fait aucune hypothèse sur les outils que vous utilisez pour écrire du code Rust. Presque n’importe quel éditeur de texte fera l’affaire ! Cependant, de nombreux éditeurs de texte et environnements de développement intégrés (IDE) offrent une prise en charge intégrée de Rust. Vous pouvez toujours trouver une liste assez à jour de nombreux éditeurs et IDE sur la page des outils du site web de Rust.

Travailler hors ligne avec ce livre

Dans plusieurs exemples, nous utiliserons des packages Rust au-dela de la bibliothèque standard. Pour travailler sur ces exemples, vous aurez besoin soit d’une connexion internet, soit d’avoir téléchargé ces dépendances à l’avance. Pour télécharger les dépendances à l’avance, vous pouvez exécuter les commandes suivantes. (Nous expliquerons ce qu’est cargo et ce que fait chacune de ces commandes en détail plus tard.)

$ cargo new get-dependencies
$ cd get-dependencies
$ cargo add rand@0.8.5 trpl@0.2.0

Cela mettra en cache les téléchargements de ces packages afin que vous n’ayez pas à les télécharger plus tard. Une fois cette commande exécutée, vous n’avez pas besoin de conserver le dossier get-dependencies. Si vous avez exécute cette commande, vous pouvez utiliser le drapeau --offline avec toutes les commandes cargo dans le reste du livre pour utiliser ces versions en cache au lieu de tenter d’utiliser le reseau.