Salutations et bienvenue à Rustlings. Ce projet contient de petits exercices pour vous habituer à lire et écrire du code Rust. Cela inclut la lecture et la réponse aux messages du compilateur !
Il est recommandé de faire les exercices Rustlings en parallèle de la lecture du livre officiel de Rust, la ressource la plus complète pour apprendre Rust ️
Rust By Exemple est une autre ressource recommandée qui pourrait vous être utile. Il contient des exemples de code et des exercices similaires à Rustlings, mais en ligne.
Avant d'installer Rustlings, vous devez avoir installé la dernière version de Rust . Visitez www.rust-lang.org/tools/install pour plus d'instructions sur l'installation de Rust. Cela installera également Cargo , le gestionnaire de packages/projets de Rust.
? Si vous êtes sous Linux, assurez-vous d'avoir installé
gcc
(pour un éditeur de liens).Deb :
sudo apt install gcc
. Dnf :sudo dnf install gcc
.
? Si vous utilisez MacOS, assurez-vous d'avoir installé Xcode et ses outils de développement en exécutant
xcode-select --install
.
La commande suivante téléchargera et compilera Rustlings :
cargo install rustlings
rustup update
--locked
: cargo install rustlings --locked
Après avoir installé Rustlings, exécutez la commande suivante pour initialiser le répertoire rustlings/
:
rustlings init
rustlings
est introuvable… ( cliquez pour agrandir )Vous utilisez probablement Linux et avez installé Rust à l'aide de votre gestionnaire de packages.
Cargo installe les binaires dans le répertoire ~/.cargo/bin
. Malheureusement, les gestionnaires de packages n'ajoutent souvent pas ~/.cargo/bin
à votre variable d'environnement PATH
.
La solution est de…
~/.cargo/bin
manuellement à PATH
rustup
: https://www.rust-lang.org/tools/installMaintenant, allez dans le répertoire nouvellement initialisé et lancez Rustlings pour obtenir des instructions supplémentaires sur la façon de démarrer les exercices :
cd rustlings/
rustlings
Notre recommandation générale est VS Code avec le plugin rust-analyzer. Mais tout éditeur prenant en charge Rust-Analyzer devrait suffire pour travailler sur les exercices.
Lorsque vous travaillez avec Rustlings, veuillez utiliser un terminal moderne pour la meilleure expérience utilisateur. Le terminal par défaut sous Linux et Mac devrait suffire. Sous Windows, nous recommandons le terminal Windows.
Les exercices sont classés par thème et se trouvent dans le sous-répertoire exercises/<topic>
. Pour chaque sujet, il existe un fichier README.md
supplémentaire contenant des ressources pour vous aider à démarrer sur le sujet. Nous vous recommandons fortement d'y jeter un œil avant de commencer ️
La plupart des exercices contiennent une erreur qui empêche leur compilation, et c'est à vous de la corriger ! Certains exercices contiennent des tests qui doivent être réussis pour que l'exercice soit effectué ✅
Recherchez TODO
et todo!()
pour découvrir ce que vous devez modifier. Demandez des indices en saisissant h
en mode montre
Après initialisation, Rustlings peut être lancé en exécutant simplement la commande rustlings
.
Cela lancera le mode montre qui vous guidera à travers les exercices dans un ordre prédéfini (ce que nous pensons être le mieux pour les nouveaux arrivants). Il réexécutera automatiquement l'exercice en cours à chaque fois que vous modifierez le fichier de l'exercice dans le répertoire exercises/
.
exercises/
échoue… ( cliquez pour développer )Vous pouvez ajouter l'indicateur
--manual-run
(rustlings --manual-run
) pour réexécuter manuellement l'exercice en cours en entrantr
dans le mode montre.Veuillez signaler le problème avec quelques informations sur votre système d'exploitation et si vous exécutez Rustlings dans un conteneur ou une machine virtuelle (par exemple WSL).
En mode montre (après avoir lancé rustlings
), vous pouvez saisir l
pour ouvrir la liste d'exercices interactive.
La liste vous permet de…
c
: Continuer sur un autre exercice (sauter temporairement certains exercices ou revenir à un précédent)r
: Réinitialisation du statut et du fichier de l'exercice sélectionné (vous devez ensuite recharger/rouvrir son fichier dans votre éditeur)Voir le pied de page de la liste pour toutes les clés possibles.
Si vous avez besoin d'aide pour faire les exercices et que les astuces intégrées ne vous sont pas utiles, n'hésitez pas à demander dans la catégorie Q&R des discussions si votre question n'a pas encore été posée.
Les exercices tiers sont un ensemble d'exercices maintenus par la communauté. Vous pouvez utiliser le même programme rustlings
que celui que vous avez installé avec cargo install rustlings
pour les exécuter :
Voulez-vous créer votre propre série d’exercices Rustlings pour vous concentrer sur un sujet spécifique ? Ou souhaitez-vous traduire les exercices originaux de Rustlings ? Alors suivez le guide sur les exercices tiers !
Une fois que vous avez terminé Rustlings, mettez vos nouvelles connaissances à profit ! Continuez à mettre en pratique vos compétences Rust en créant vos propres projets, en contribuant à Rustlings ou en trouvant d'autres projets open source auxquels contribuer.
Si vous souhaitez supprimer Rustlings de votre système, exécutez la commande suivante :
cargo uninstall rustlings
Voir CONTRIBUTION.md ?
Merci à tous les merveilleux contributeurs ?