Exécuter du code localement avec Cargo

Si vous souhaitez expérimenter le code sur votre propre système, il vous faudra d’abord installer Rust. Pour ce faire, suivez les instructions dans le livre Rust - en anglais. Vous disposerez alors de rustc et cargo. Au moment de l’écriture, la dernière version stable de Rust a ces numéros de version :

% rustc --version
rustc 1.69.0 (84c898d65 2023-04-16)
% cargo --version
cargo 1.69.0 (6e9a83356 2023-04-12)

N’importe quelle version plus récente peut également être utilisée, étant donné que les versions de Rust sont rétrocompatibles.

Suivez ensuite ces étapes pour créer un binaire Rust à partir d’un des exemples dans cette formation :

  1. Cliquez sur le bouton “Copy to clipboard” sur l’exemple que vous souhaitez copier.

  2. Exécutez cargo new exercise pour créer un nouveau répertoire exercise/ pour héberger votre code :

    $ cargo new exercise
         Created binary (application) `exercise` package
    
  3. Rendez vous dans le répertoire exercise/ et exécutez cargo run pour compiler et exécuter votre binaire :

    $ cd exercise
    $ cargo run
       Compiling exercise v0.1.0 (/home/mgeisler/tmp/exercise)
        Finished dev [unoptimized + debuginfo] target(s) in 0.75s
         Running `target/debug/exercise`
    Hello, world!
    
  4. Remplacez le code standard sous src/main.rs par votre propre code. Par exemple, en suivant l’exemple de la page précédente, modifiez src/main.rs comme ceci :

    fn main() {
        println!("Edit me!");
    }
  5. Exécutez cargo run pour compiler et exécuter votre binaire mis à jour :

    $ cargo run
       Compiling exercise v0.1.0 (/home/mgeisler/tmp/exercise)
        Finished dev [unoptimized + debuginfo] target(s) in 0.24s
         Running `target/debug/exercise`
    Edit me!
    
  6. Exécutez cargo check afin de rapidement déterminer si votre projet contient des erreurs. Exécutez cargo build pour le compiler sans l’exécuter. Pour une compilation normale en mode debug, le résultat se trouvera dans le répertoire target/debug/. Enfin, vous pouvez exécuter cargo build --release pour générer un binaire optimisé qui se trouvera dans le répertoire target/release/.

  7. Vous pouvez déclarer des dépendances pour votre projet dans le fichier Cargo.toml. Quand vous lancez des commandes cargo, Cargo se charge de télécharger et compiler les dépendances manquantes.

Essayez d’encourager les participants à installer Cargo et à utiliser un éditeur local. Cela leur facilitera la vie puisqu’ils auront un environnement de développement normal.