rustlings

Rascheln ?❤️

Grüße und willkommen bei Rustlings. Dieses Projekt enthält kleine Übungen, um Sie an das Lesen und Schreiben von Rust-Code zu gewöhnen. Dazu gehört das Lesen und Beantworten von Compiler-Nachrichten!

Es wird empfohlen, die Rustlings-Übungen parallel zur Lektüre des offiziellen Rust-Buches durchzuführen, der umfassendsten Ressource zum Erlernen von Rust️

Rust By Beispiel ist eine weitere empfohlene Ressource, die für Sie hilfreich sein könnte. Es enthält Codebeispiele und Übungen ähnlich wie Rustlings, jedoch online.

Erste Schritte

Rust installieren

Bevor Sie Rustlings installieren, müssen Sie die neueste Version von Rust installiert haben. Besuchen Sie www.rust-lang.org/tools/install für weitere Anweisungen zur Installation von Rust. Dadurch wird auch Cargo installiert, der Paket-/Projektmanager von Rust.

? Wenn Sie Linux verwenden, stellen Sie sicher, dass Sie gcc (als Linker) installiert haben.

Deb: sudo apt install gcc . Dnf: sudo dnf install gcc .

? Wenn Sie MacOS verwenden, stellen Sie sicher, dass Sie Xcode und seine Entwicklertools installiert haben, indem Sie xcode-select --install ausführen.

Rustlings installieren

Mit dem folgenden Befehl können Sie Rustlings herunterladen und kompilieren:

cargo install rustlings

Wenn die Installation fehlschlägt ... ( zum Erweitern klicken )

• Stellen Sie sicher, dass Sie über die neueste Rust-Version verfügen, indem Sie rustup update ausführen
• Versuchen Sie, die Flagge --locked hinzuzufügen: cargo install rustlings --locked
• Ansonsten melden Sie bitte das Problem

Initialisierung

Führen Sie nach der Installation von Rustlings den folgenden Befehl aus, um das Verzeichnis rustlings/ zu initialisieren:

rustlings init

Wenn der Befehl rustlings nicht gefunden werden kann ... ( zum Vergrößern anklicken )

Sie verwenden wahrscheinlich Linux und haben Rust mit Ihrem Paketmanager installiert.

Cargo installiert Binärdateien im Verzeichnis ~/.cargo/bin . Leider fügen Paketmanager ~/.cargo/bin häufig nicht zu Ihrer PATH Umgebungsvariablen hinzu.

Die Lösung besteht darin, …

• Fügen Sie ~/.cargo/bin entweder manuell zu PATH hinzu
• oder um Rust über den Paketmanager zu deinstallieren und auf dem offiziellen Weg mit rustup zu installieren: https://www.rust-lang.org/tools/install

Gehen Sie nun in das neu initialisierte Verzeichnis und starten Sie Rustlings, um weitere Anweisungen zum Einstieg in die Übungen zu erhalten:

 cd rustlings/
rustlings

Arbeitsumgebung

Editor

Unsere allgemeine Empfehlung ist VS Code mit dem Rust-Analyzer-Plugin. Für die Bearbeitung der Übungen sollte aber jeder Editor ausreichen, der Rust-Analyzer unterstützt.

Terminal

Bitte verwenden Sie bei der Arbeit mit Rustlings ein modernes Terminal, um die beste Benutzererfahrung zu erzielen. Das Standardterminal unter Linux und Mac sollte ausreichen. Unter Windows empfehlen wir das Windows-Terminal.

Übungen machen

Die Übungen sind nach Themen sortiert und im Unterverzeichnis exercises/<topic> zu finden. Für jedes Thema gibt es eine zusätzliche README.md Datei mit einigen Ressourcen, die Ihnen den Einstieg in das Thema erleichtern. Wir empfehlen Ihnen dringend, einen Blick darauf zu werfen, bevor Sie beginnen ️

Die meisten Übungen enthalten einen Fehler, der die Kompilierung verhindert, und es liegt an Ihnen, ihn zu beheben! Einige Übungen beinhalten Tests, die bestanden werden müssen, damit die Übung durchgeführt werden kann ✅

Suchen Sie nach TODO und todo!() um herauszufinden, was Sie ändern müssen. Bitten Sie um Hinweise, indem Sie im Überwachungsmodus h eingeben

Watch-Modus

Nach der Initialisierung kann Rustlings durch einfaches Ausführen des Befehls rustlings gestartet werden.

Dadurch wird der Überwachungsmodus gestartet, der Sie in einer vordefinierten Reihenfolge durch die Übungen führt (was unserer Meinung nach für Neulinge am besten ist). Die aktuelle Übung wird jedes Mal automatisch erneut ausgeführt, wenn Sie die Datei der Übung im Verzeichnis exercises/ ändern.

Wenn die Erkennung von Dateiänderungen im Verzeichnis exercises/ fehlschlägt … ( zum Erweitern klicken )

Sie können das Flag --manual-run ( rustlings --manual-run ) hinzufügen, um die aktuelle Übung manuell erneut auszuführen, indem Sie im Überwachungsmodus r eingeben.

Bitte melden Sie das Problem mit einigen Informationen zu Ihrem Betriebssystem und ob Sie Rustlings in einem Container oder einer virtuellen Maschine (z. B. WSL) ausführen.

Übungsliste

Im Uhrmodus (nach dem Start von rustlings ) können Sie l eingeben, um die interaktive Übungsliste zu öffnen.

Mit der Liste können Sie…

• Sehen Sie sich den Status aller Übungen an (erledigt oder ausstehend)
• c : Mit einer anderen Übung fortfahren (einige Übungen vorübergehend überspringen oder zu einer vorherigen zurückkehren)
• r : Status und Datei der ausgewählten Übung zurücksetzen (Sie müssen die Datei anschließend in Ihrem Editor neu laden/erneut öffnen )

Alle möglichen Schlüssel finden Sie in der Fußzeile der Liste.

Fragen?

Wenn Sie beim Durchführen der Übungen Hilfe benötigen und die integrierten Hinweise nicht hilfreich sind, können Sie in der Frage-und-Antwort- Kategorie der Diskussionen nachfragen, falls Ihre Frage noch nicht gestellt wurde

Übungen von Drittanbietern

Bei Übungen von Drittanbietern handelt es sich um eine Reihe von Übungen, die von der Community gepflegt werden. Sie können dasselbe rustlings -Programm verwenden, das Sie mit cargo install rustlings installiert haben, um sie auszuführen:

• 日本語版 Rustlings: Eine japanische Übersetzung der Rustlings-Übungen.

Möchten Sie Ihre eigenen Rustlings-Übungen erstellen, um sich auf ein bestimmtes Thema zu konzentrieren? Oder möchten Sie die Original-Rustlings-Übungen übersetzen? Dann befolgen Sie die Anleitung zu Übungen von Drittanbietern!

Weiter geht es

Sobald Sie „Rustlings“ abgeschlossen haben, können Sie Ihr neues Wissen sinnvoll nutzen! Üben Sie Ihre Rust-Fähigkeiten weiter, indem Sie Ihre eigenen Projekte erstellen, zu Rustlings beitragen oder andere Open-Source-Projekte finden, zu denen Sie beitragen können.

Rustlings deinstallieren

Wenn Sie Rustlings von Ihrem System entfernen möchten, führen Sie den folgenden Befehl aus:

cargo uninstall rustlings

Mitwirken

Siehe CONTRIBUTING.md?

Mitwirkende

Vielen Dank an alle wunderbaren Mitwirkenden?