Skip to content

Mon exploration de Rust

Cette page, et j'espère les suivantes, regrouperont mon exploration du langage Rust, et son interface avec le moteur de jeu Godot. Tout ça sans IA, à l'ancienne. Non pas que je ne souhaite pas utiliser d'IA, mais apprendre un nouveau langage nécessite de se plonger réellement dans les mécaniques, et il faut se confronter aux difficultés pour comprendre réellement.

Installation

Installation sur Linux Mint

Je suis simplement le tutoriel du book :

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

Et après avoir relancé le terminal, on vérifie avec :

rustc --version
Ca marche direct. On vérifie quelques points avec les commandes suivantes
  • Mise à jour
    rustup update
    
  • lire la doc locale :
    rustup doc
    

Configuration de VSCodium pour Rust

La page de référence des différents outils : https://rust-lang.org/tools/.

DOnc Ctrl+Shift+X pour ouvrir les extensions, et on installe rust-analyser.

Bon, il y aura encore du travail de configuration à faire pour le debugging, mais on verra ça plus loin.

Premiers pas

Utilisation de cargo

Dans un terminal ouvert dans mon dossier RUST, j'utilise :

cargo new hello_world
Cette action :
  • créé un dossier hello_world
  • le peuple avec :
    • un dossier src contenant le fichier main.rs ;
      fn main() {
      println!("Hello, world!");
      }
      
    • un fichier .gitignore contenant uniquement un dossier /target ;
    • un fichier cargo.toml (cargo manifest)

Ensuite, toujours depuis le terminal, en étant dans le dossier hello_world :

cargo build    

Il y a eu compilation, création du dossier target et d'un fichier Cargo.lock.

Dans le dossier target, on trouve un dossier debug, qui contient beaucoup de choses, dont l'exécutable hello_world.

On peut l'exécuter directement depuis le console :

target/debug/hello_world
ou par l'intermédiaire de la commande cargo run :
fabien@fabien-Tour:~/Documents/RUST/hello_world$ cargo run
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.01s
     Running `target/debug/hello_world`
Hello, world!

IntelliSense

Bon, j'ai dit pas d'IA, mais l'extension rust-analyser propose des informations de code détaillées et des «smart suggestions» (comme ils disent).

En ouvrant le fichier main.rs, on voit apparaitre rust-anaylserdans la barre en bas de VSCodium.

Donc plein d'options sur le typage, l'auto-complétion, etc. On verra ça plus tard.

Installation du Debugging dans VSCodium

Sur Linux, il faut installer l'extension CodeLLDB, puis redémarrer les extensions.

Bon, premier problème : j'ai ouvert le dossier RUST dans VSCodium, et pas le dossier RUST/hello_world, et donc ça ne fonctionne pas, car le debugging cherche un fichier Cargo.toml depuis ce dossier et dans ses dossiers parents. Il faut donc ouvrir réellement le dossier du projet, ici RUST\hello_world. Une fois le dossier changé, le debugging se lance.

Une dernière configuration : ++ctrl+,++, on autorise les breakpoint partout (breakpoint everywhere).

Et ça ne marche pas, les points d'arrêts ne sont pas reconnus...

Selon mon ami Claude, c'est un problème de lien symbolique... J'ai ouvert le dossier depuis mon raccourcis Documents, qui est lui-même un lien symbolique. Donc il faut préférer l'ouvrir directement depuis le bon point de montage.

Claude me propose de mettre la correction suivante dans .vscode/launch.json :

"sourceMap": { "/mnt/sdb1/Documents": "/home/fabien/Documents" } 

Une fois les corrections effectuées, le debugging fonctionne. Ouf !

A priori, c'est donc ok pour la configuration de VSCodium.

Quelques remarques sur la syntaxe Rust

Le code du fichier main.rs est le suivant :

fn main() {
    println!("Hello, world!");
}
Donc :
  • fndéfinit une fonction nommée main sans paramètres.
  • Le corps de la fonction est repéré par une paire d'accolades {}.
  • println! est une macro (?) pas une fonction, a priori c'est le ! qui fait la différence entre les deux.
  • "Hello, world!" est une chaine de caratères.
  • Il y a un ; à la fin de la ligne, qui signifie la fin de l'expression.

Encore un point de compilation

Si depuis le dossier hello_world j'exécute la commande suivante :

rustc src/main.rs
je compile le fichier et crée un exécutable appelé main (sou Linux) directement dans le dossier hello_world, que je peux exécuter avec la commande ./main.

Cargo

Quelques commandes cargo :

  • cargo new projet : créee un nouveau projet nommé projet, avec toute la structure précédemment vue ;
  • cargo build : compile le projet et crée un exécutable dans le répertoire debug.
  • cargo run : compile le projet et l'exécute.
  • cargo check : vérifie si le projet est compilable mais ne crée pas l'exécutable.
  • cargo build --release : crée un exécutable dans le dossier target/release. L'exécutable est optimisé, le temps d'exécution de la commande est plus long.

Bon, il est temps de passer à la suite, création d'un projet guessing_game.