Commencer

Configurez rapidement un environnement de développement Rust et écrivez une petite application !

Installer Rust

Vous pouvez essayer Rust en ligne dans le Rust Playground sans rien installer sur votre ordinateur.

Essayer Rust sans l'installer

Rustup : l'outil d'installation de Rust et gestionnaire de versions

La principale façon d'installer Rust est au moyen d'un outil nommé Rustup, qui est un outil d'installation de Rust et un gestionnaire de versions.

Il semblerait que vous utilisez macOS, Linux ou un autre OS de type UNIX. Pour télécharger Rustup et installer Rust, exécutez la commande suivante dans votre terminal, puis suivez les instructions à l'écran.

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

It looks like you’re running Windows. To start using Rust, download the installer, then run the program and follow the onscreen instructions. You may need to install the Visual Studio C++ Build tools when prompted to do so. If you are not on Windows see "Other Installation Methods".

Sous-système Windows pour Linux

Si vous êtes un utilisateur du sous-système Windows pour Linux, exécutez la commande suivante dans votre terminal, puis suivez les instructions à l'écran.

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

Rust fonctionne sur Windows, Linux, macOS, FreeBSD et NetBSD. Si vous êtes sur une de ces plateformes et voyez ceci, veuillez rapporter une erreur avec les valeur suivantes :

navigator.platform: MacIntel
navigator.appVersion: 5.0 (Macintosh)

Rapporter une erreur

Pour installer Rust, si vous utilisez Unix,
exécutez la commande suivante dans votre terminal, puis suivez les instructions à l'écran.

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

Si vous êtes sous Windows,
téléchargez et exécutez rustup‑init.exe, puis suivez les instructions à l'écran.

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

Si vous utilisez Windows,
téléchargez et exécutez rustup‑init.exe, puis suivez les instructions à l'écran.


Est-ce que Rust est à jour ?

Rust évolue souvent. Si vous avez installé Rustup il y a longtemps, il est possible que votre version de Rust ne soit plus à jour. Récupérez la dernière version via la commande rustup update.


En savoir plus sur l'installation

Cargo: l'outil de build et gestionnaire de paquets

Quand vous installez Rustup, vous installez aussi la dernière version stable de l'outil de build et gestionnaire de paquets de Rust, connu sous le nom de Cargo. Cargo fait de nombreuses choses :

  • construire votre projet avec cargo build
  • exécuter votre projet avec cargo run
  • tester votre projet avec cargo test
  • construire la documentation de votre projet avec cargo doc
  • publier une bibliothèque sur crates.io avec cargo publish

Pour tester que vous avez bien Rust et Cargo installés, vous pouvez exécuter ceci dans le terminal de votre choix:

cargo --version

Lire le Book de Cargo

Autres outils

Rust est supporté dans de nombreux d'éditeurs:

Générer un nouveau projet

Écrivons une petite application avec notre nouvel environnement de développement Rust. Pour commencer, nous utiliserons Cargo pour créer un nouveau projet pour nous. Dans le terminal de votre choix exécutez :

cargo new hello-rust

Cela va générer un nouveau répertoire appelé hello-rustavec les fichiers suivants :

hello-rust
|- Cargo.toml
|- src
  |- main.rs

Cargo.toml est le fichier manifeste de Rust. C'est là que vous gardez les métadonnées pour votre projet, ainsi que les dépendances.

src/main.rs est l'endroit où vous écrirez le code de notre application.


cargo new génère pour nous un projet "Hello, world!". Nous pouvons exécuter ce programme en se déplaçant dans le nouveau répertoire que nous avons créé et en exécutant ceci dans notre terminal :

cargo run

Vous devriez voir ceci dans votre terminal :

$ cargo run
   Compiling hello-rust v0.1.0 (/Users/ag_dubs/rust/hello-rust)
    Finished dev [unoptimized + debuginfo] target(s) in 1.34s
     Running `target/debug/hello-rust`
Hello, world!

Ajouter des dépendances

Ajoutons une dépendance à notre application. Vous pouvez trouver toutes sortes de bibliothèques sur crates.io, le registre de packages de Rust. En Rust nous faisons souvent référence aux packages avec le nom de "crate".

Dans ce projet, nous utiliserons une crate nommée ferris-says.

Dans notre fichier Cargo.toml nous ajouterons cette information (que nous avons obtenue sur la page web de la crate) :

[dependencies]
ferris-says = "0.2"

Maintenant nous pouvons exécuter :

cargo build

...et Cargo installera nos dépendances pour nous.

Vous constaterez qu'exécuter cette commande a créé un nouveau fichier pour nous, Cargo.lock. Ce fichier est un log des versions exactes des dépendances que l'on utilise localement.

Pour utiliser cette dépendance, nous pouvons ouvrir main.rs, supprimer tout ce qui y est présent (ce n'est qu'un exemple), et y ajouter cette ligne:

use ferris_says::say;

Cette ligne signifie que nous pouvons maintenant utiliser la fonction say que la crate ferris-says exporte pour nous.

Une petite application en Rust

Maintenant écrivons une petite application avec notre nouvelle dépendance. Dans notre main.rs ajoutez le code suivant :

use ferris_says::say; // from the previous step
use std::io::{stdout, BufWriter};

fn main() {
    let stdout = stdout();
    let message = String::from("Hello fellow Rustaceans!");
    let width = message.chars().count();

    let mut writer = BufWriter::new(stdout.lock());
    say(message.as_bytes(), width, &mut writer).unwrap();
}
    

Après avoir sauvegardé, nous pouvons exécuter notre application en tapant :

cargo run

Si tout s'est bien passé, vous devriez voir votre application afficher ceci à l'écran :

----------------------------
| Hello fellow Rustaceans! |
----------------------------
              \
               \
                 _~^~^~_
             \) /  o o  \ (/
               '_   -   _'
               / '-----' \
    

En savoir plus !

Vous êtes maintenant un Rustacé ! Bienvenue ! Nous sommes heureux de vous compter parmi nous. Quand vous serez prêt·e, faites un saut sur notre page « Apprendre », où vous pourrez trouver beaucoup de livres qui vous aideront a continuer votre aventure en Rust.

en savoir plus !

Qui est ce crabe, Ferris ?

Ferris est la mascotte non officielle de la communauté Rust. Beaucoup de programmeurs Rust s'appellent eux-mêmes "Rustacés", un jeu de mot avec “crustacé.”

Ferris est un nom jouant avec l'adjectif , “ferreux,” étant donné que la rouille (Rust en anglais) se forme souvent sur le fer, cela semblait une origine amusante pour le nom de notre mascotte !

Vous pouvez trouver plus d'images de Ferris sur rustacean.net. gif de ferris se promenant d'un côté à l'autre