Mise en place du workspace
Tags: rust, webdev, tutorial, vscode
Published: 2022-08-30 10:31:00

## Installation de Rust

Tout d'abord, nous devons installer Rust. Pour cela, je recommande d'utiliser rustup afin de pouvoir facilement gérer et mettre à jours nos toolchains.

Si vous êtes un utilisateur Linux, vous pouvez simplement lancer cette commande dans votre terminal : `curl - proto '=https' - tlsv1.2 -sSf https://sh.rustup.rs | sh`.

Si vous utilisez Windows, vous devez télécharger et installer [l'exécutable d'installation](https://www.rust-lang.org/tools/install).

Un fois installé, vous pouvez vérifier le succès de la procédure en tapant rustup -v dans un terminal. Cela devrait afficher à la fois la version de rustup (gestionnaire de toolchains) ainsi que de rustc (compilateur).

Maintenant, il n'en tient qu'à vous de décider de la toolchain que vous souhaitez utiliser.
- Stable : limiter un maximum les bugs.
- Nightly : accéder aux dernières fonctionnalités.
- Beta : un mix des deux.

Pour cet article, supposons que nous souhaitons travailler avec la version "nightly" de Rust :

`rustup default nightly`


## Installation de VSCode & Rust Analyzer

Quand il s'agit d'écrire du code en Rust, je recommande souvent l'utilisation de [Rust Analyzer](https://rust-analyzer.github.io/). En effet, cet outil améliore votre IDE sur de nombreux aspects. Par exemple :
- [Complétion de code](https://rust-analyzer.github.io/manual.html#magic-completions)
- [Auto-import](https://rust-analyzer.github.io/manual.html#completion-with-autoimport)
- [Types des variables et paramètres inline](https://rust-analyzer.github.io/manual.html#inlay-hints)
- [Highliting semantique de la syntaxe](https://rust-analyzer.github.io/manual.html#semantic-syntax-highlighting)
- Et bien d'autres…

[VSCode](https://code.visualstudio.com/) étant l'éditeur le mieux supporté, c'est celui-ci que nous utiliserons dans cet article. Cependant, Rust Analyzer s'intègre aussi avec d'autres éditeurs. Je vous encourage donc à consulter le [manuel](https://rust-analyzer.github.io/manual.html) si vous souhaitez l'intégrer à votre IDE favori.

Une fois VSCode installé, afin d'installer Rust Analyzer, il suffit de se rendre dans l'onglet des plugins à gauche de la fenêtre.

Aussi vous trouverez ci-après quelques autres plugins pouvant rendre votre vite plus facile lors du développement en Rust :

- Better TOML : Pratique pour les fichiers de configuration, ajoute le support des fichiers toml.
- crates : Vous permet de gérer les versions de vos crates directement depuis l'IDE.
- GitLens : Ajoute une intégration git directement dans VSCode.



![Installation de Rust Analyzer dans VSCode](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/dkcd1f3hm8qi92e33ypm.png)

## Création de notre projet

Nous sommes maintenant prêt à créer notre projet. Pour celà rien de plus simple, il suffit de taper `cargo new <project_name> --bin`. L'option `--bin` est là pour indiquer que nous souhaitons créer un programme et non une lib (`--lib`). A noter qu'un dépôt git est initialisé par défaut.
Votre arborescence devrait ressembler à ça :

```
├── Cargo.toml
└── src
    └── main.rs
```

Dans le prochain article, nous verrons comment mettre au point notre première route en Rust avec Rocket !