darnuria / rust-atelier

Mirroir de framagit https://framagit.org/darnuria/rust-initiation/

⚙🦀 Atelier de Programmation en Rust ⚙🦀

Au travers d'exercices simples on va s'approprier la syntaxe du langage Rust.

Retenez ceci pour la suite : Toute question est bonne, dans le doute demandez-moi. Rust est un langage complexe donc n'hésitez pas à poser des questions !

Vous preferez être très autonomes ? Lancez-vous directement dans rustlings après une installation de Rust et Cargo!

Les exercices d'atelier

Les exercices d'ateliers sont dans le dossier exercices, il est recommandé de commencer par 01-premiers-pas.rs puis 02-bonjour-toi.rs.

Notes

Vous pourrez trouver des notes dans le dossier cours, et une bibliographie avec des liens utiles.

Le dossier sujets contient des évaluations déjà utilisées.

Vos contributions au cours : vous pouvez soumettre des contributions au cours par courriel ou directement dans une merge request ou une issue sur framagit.

A faire pour continuer chez vous

Pour le mardi 29 septembre ou vendredi 02 octobre selon votre groupe !

• Avoir avancé dans rustlings jusque a l'exercice quiz2 au moins. Laissez-vous guider par rustlings watch. :)
• Avancer dans les exercices jusque au 08 au minimum, idéalement avoir tout fait.
• Préparer vos questions pour le prochain cours ou me les envoyer par courriel !

Installation de Rust et environnement de développement

Ces instructions sont valides pour votre ordinateur personnel ou à l'université ! Pour juste tester vous pouvez utiliser l'environnement de brouillon de Rust en ligne.

Installer son environnement de travail

Le plus important : installer rust-analyzer, ça vous sera utile pour la maison avec vos premiers projets avec cargo. :)

Vscodium

Visual studio mais sans le support de microsoft ni la télémetrie : https://github.com/VSCodium/vscodium

Pensez à lire la procédure d'installation disponible ici

Vous pourrez choisir sous linux le .AppImage (pensez à le rendre executable), ou le .deb à installer avec sudo dpkg -i mon_packet

Pensez à installer l'addon Rust !

Vim / Neovim / Emacs / Spacemacs

Quelques liens pour les personnes qui désireraient utiliser emacs avec spacemacs ou vim ou neovim pour Rust:

• Vim: https://opensource.com/article/20/7/vim-rust-ide
• Emacs avec Spacemacs: https://github.com/rust-lang/rust-mode

Note: Spacemacs est une configuration rapide à l'emploi pour emacs version 25 ou supérieure qui simplifie l'usage de emacs.

Pycharm - Rust

Si vous préférez les environnements intégrés de développement je vous recommande pycharm avec l'addon Rust.

Installation de rust avec Rustup

Pour installer le compilateur Rust, Rustc et Cargo, le package manager de Rust on va utiliser rustup.

Vous pouvez l'installer avec la commande suivante :

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

Note: Attention ! Ce type de commande va télécharger avec le programme curl un script puis va l'executer ! Soyez sûr de ce que vous faites lorsque vous installez quelque chose avec cette methodologie.

Ensuite choisissez les choix par défauts.

⚠ Attention ⚠ : Il faut bien penser d'ajouter source $HOME/.cargo/env à la fin de fichier de configuration local de bash disponible au chemin ~/.bashrc.

Ajouter au chemin les binaires installés par cargo et rustc

Si vous voulez allez vite, vous pouvez faire cela va écrire la chaine entre " dans votre fichier .bashrc: echo "source $HOME/.cargo/env" >> ~/.bashrc

Sinon vous aurez des erreurs du type: Command 'rustc' not found

Vérifier que rust est bien installé

Tentez de lancer les commandes suivantes: rustc --version et cargo --version.

Vous devriez obtenir quelque chose comme :

$ rustc --version
rustc 1.59.0 (9d1b2106e 2022-02-23)

Et pour cargo, le gestionnaire de paquet de l'ecosystème de Rust :

$ cargo --version
cargo 1.59.0 (49d8809dc 2022-02-10)

Rustlings

Rustlings est un programme qui permet d'apprendre en autonomie la syntaxe de Rust, le programme compile à chaque changement pour vos vos fichiers de code et passe à l'exercice suivant quand vous avez réussi ! Pratique pour se concentrer sur le domptage du compilateur Rust et de ses messages d'erreurs !

Pour l'installer vous pouvez suivre les instructions ici:

Pour la praticité, je vous reporte la procédure:

# Si vous voulez installer ailleurs que dans votre $HOME il suffit de changer
# la ligne après `bash -s`
curl -L https://git.io/rustlings | bash -s $HOME/rustlings

⚠ Erreur possible : Si vous avez l'erreur linker 'cc' not found faites sudo apt install build-essential il vous manque le minimum pour compiler du C/C++ ! Certains paquets rust en auront besoin.

Ensuite, vous pouvez aller dans le répertoire de rustlings: cd $HOME/rustlings, lancer rustlings en tapant rustlings watch dans votre terminal.

Ensuite il suffit de se laisser guider d'éditer les exercices disponnibles dans : ~/rustlings/exercices.

Vous devriez obtenir quelque chose mais en couleur comme:

! Compiling of exercises/variables/variables1.rs failed! Please try again. Here's the output:
error[E0425]: cannot find value `x` in this scope
  --> exercises/variables/variables1.rs:12:5
   |
12 |     x = 5;
   |     ^ not found in this scope

error[E0425]: cannot find value `x` in this scope
  --> exercises/variables/variables1.rs:13:36
   |
13 |     println!("x has the value {}", x);
   |                                    ^ not found in this scope

error: aborting due to 2 previous errors

For more information about this error, try `rustc --explain E0425`.

Une fois la correction faite, lisez bien les messages du compilateur ; on est pas en C ! Vous devriez voir quelque chose indiquant qu'il est temps de passer au prochain exercice !

✓ Successfully ran exercises/variables/variables1.rs!
! Compiling of exercises/variables/variables2.rs failed! Please try again. Here's the output:
error[E0282]: type annotations needed
 --> exercises/variables/variables2.rs:7:9
  |
7 |     let x;
  |         ^ consider giving `x` a type

error: aborting due to previous error

For more information about this error, try `rustc --explain E0282`.

Astuce: Les chemins que donne Rustlings sont utilisables pour naviguer directement si vous ouvrez un terminal dans votre editeur/IDE !

Bonus trèèèèèès recommandé

Si vous ne souhaitez pas vous faire un compte sur exercism vous pouvez pratiquer en clonant le dépot : https://github.com/exercism/rust/

• Exercism.io bases d'exercices en licence libre

Documentation et références

Beaucoup de ressources seront en anglais, en cours je tenterai de franciser les explications.

• The Rust programming Language Livre d'apprentissage de référence
• Documentation de la bibliothèque standard : Indispensable
• Rust by example Rust illustré par des exemples

En français vous pourrez aussi trouver le tutoriel de Guillaume Gomez, avoir une seconde façon ou troisième façon d'approcher un problème peut vous débloquer : https://blog.guillaume-gomez.fr/Rust

Environnement de developpement programmes utiles

Pour faciliter l'édition il existe des utilitaires utilisable entre tout les editeurs, comme l'analyseur de Rust:

rustup component add rust-analysis

Il en existe d'autre nous le verrons plus tard.