 | safe }})
+
+ {{ page.title }}
+ +
+
+
+
+ {{ page.content | safe }}
+
+# [Rustlings](https://rustlings.rust-lang.org) 🦀
-# Rustlings 🦀❤️
+Small exercises to get you used to reading and writing [Rust](https://www.rust-lang.org) code - _Recommended in parallel to reading [the official Rust book](https://doc.rust-lang.org/book) 📚️_
-
+Visit the **website** for a demo, info about setup and more:
-Greetings and welcome to Rustlings.
-This project contains small exercises to get you used to reading and writing Rust code.
-This includes reading and responding to compiler messages!
-
-It is recommended to do the Rustlings exercises in parallel to reading [the official Rust book](https://doc.rust-lang.org/book/), the most comprehensive resource for learning Rust 📚️
-
-[Rust By Example](https://doc.rust-lang.org/rust-by-example/) is another recommended resource that you might find helpful.
-It contains code examples and exercises similar to Rustlings, but online.
-
-## Getting Started
-
-### Installing Rust
-
-Before installing Rustlings, you need to have the **latest version of Rust** installed.
-Visit [www.rust-lang.org/tools/install](https://www.rust-lang.org/tools/install) for further instructions on installing Rust.
-This will also install _Cargo_, Rust's package/project manager.
-
-> 🐧 If you're on Linux, make sure you've installed `gcc` (for a linker).
->
-> Deb: `sudo apt install gcc`.
-> Dnf: `sudo dnf install gcc`.
-
-> 🍎 If you're on MacOS, make sure you've installed Xcode and its developer tools by running `xcode-select --install`.
-
-### Installing Rustlings
-
-The following command will download and compile Rustlings:
-
-```bash
-cargo install rustlings
-```
-
-
-
-
-> [!CAUTION]
-> Don't try to clone the repository to do the exercises! `rust-analyzer` won't work in that case. Please follow the instructions above instead.
->
-> If the installation fails… (click to expand)
- -- Make sure you have the latest Rust version by running `rustup update` -- Try adding the `--locked` flag: `cargo install rustlings --locked` -- Otherwise, please [report the issue](https://github.com/rust-lang/rustlings/issues/new) - -
->
-
-### Initialization
-
-After installing Rustlings, run the following command to initialize the `rustlings/` directory:
-
-```bash
-rustlings init
-```
-
-Why?
-> ->The intended way to run Rustlings is to install the binary and run `rustlings init` as described in the installation/initialization sections. This generates a `Cargo.toml` (different than what you see in the repository) that includes each exercise as a separate binary target which is enough for `rust-analyzer` to work. -> ->If you just clone the repository and try to run and edit the exercises directly, the language server will not work. -> ->
-If the command
-
-You are probably using Linux and installed Rust using your package manager.
-
-Cargo installs binaries to the directory `~/.cargo/bin`.
-Sadly, package managers often don't add `~/.cargo/bin` to your `PATH` environment variable.
-
-The solution is to …
-
-- either add `~/.cargo/bin` manually to `PATH`
-- or to uninstall Rust from the package manager and install it using the official way with `rustup`: https://www.rust-lang.org/tools/install
-
-
-
-Now, go into the newly initialized directory and launch Rustlings for further instructions on getting started with the exercises:
-
-```bash
-cd rustlings/
-rustlings
-```
-
-## Working environment
-
-### Editor
-
-Our general recommendation is [VS Code](https://code.visualstudio.com/) with the [rust-analyzer plugin](https://marketplace.visualstudio.com/items?itemName=rust-lang.rust-analyzer).
-But any editor that supports [rust-analyzer](https://rust-analyzer.github.io/) should be enough for working on the exercises.
-
-### Terminal
-
-While working with Rustlings, please use a modern terminal for the best user experience.
-The default terminal on Linux and Mac should be sufficient.
-On Windows, we recommend the [Windows Terminal](https://aka.ms/terminal).
-
-## Doing exercises
-
-The exercises are sorted by topic and can be found in the subdirectory `exercises/If the command rustlings can't be found… (click to expand)
-
-You are probably using Linux and installed Rust using your package manager.
-
-Cargo installs binaries to the directory `~/.cargo/bin`.
-Sadly, package managers often don't add `~/.cargo/bin` to your `PATH` environment variable.
-
-The solution is to …
-
-- either add `~/.cargo/bin` manually to `PATH`
-- or to uninstall Rust from the package manager and install it using the official way with `rustup`: https://www.rust-lang.org/tools/install
-
-
-If detecting file changes in the
-
-> You can add the **`--manual-run`** flag (`rustlings --manual-run`) to manually rerun the current exercise by entering `r` in the watch mode.
->
-> Please [report the issue](https://github.com/rust-lang/rustlings/issues/new) with some information about your operating system and whether you run Rustlings in a container or virtual machine (e.g. WSL).
-
-
-
-### Exercise List
-
-In the [watch mode](#watch-mode) (after launching `rustlings`), you can enter `l` to open the interactive exercise list.
-
-The list allows you to…
-
-- See the status of all exercises (done or pending)
-- `c`: Continue at another exercise (temporarily skip some exercises or go back to a previous one)
-- `r`: Reset status and file of an exercise (you need to _reload/reopen_ its file in your editor afterwards)
-
-See the footer of the list for all possible keys.
-
-## Continuing On
-
-Once you've completed Rustlings, put your new knowledge to good use!
-Continue practicing your Rust skills by building your own projects, contributing to Rustlings, or finding other open-source projects to contribute to.
-
-## Third-Party Exercises
-
-Third-party exercises are a set of exercises maintained by the community.
-You can use the same `rustlings` program that you installed with `cargo install rustlings` to run them:
-
-- [日本語版 Rustlings](https://github.com/sotanengel/rustlings-jp)：A Japanese translation of the Rustlings exercises.
-
-Do you want to create your own set of Rustlings exercises to focus on some specific topic?
-Or do you want to translate the original Rustlings exercises?
-Then follow the the guide about [third-party exercises](https://github.com/rust-lang/rustlings/blob/main/THIRD_PARTY_EXERCISES.md)!
-
-## Uninstalling Rustlings
-
-If you want to remove Rustlings from your system, run the following command:
-
-```bash
-cargo uninstall rustlings
-```
-
-## Contributing
-
-See [CONTRIBUTING.md](https://github.com/rust-lang/rustlings/blob/main/CONTRIBUTING.md) 🔗
-
-## Contributors ✨
-
-Thanks to [all the wonderful contributors](https://github.com/rust-lang/rustlings/graphs/contributors) 🎉
+## ➡️ [rustlings.rust-lang.org](https://rustlings.rust-lang.org) ⬅️
diff --git a/THIRD_PARTY_EXERCISES.md b/THIRD_PARTY_EXERCISES.md
deleted file mode 100644
index 62646c5b..00000000
--- a/THIRD_PARTY_EXERCISES.md
+++ /dev/null
@@ -1,53 +0,0 @@
-# Third-Party Exercises
-
-The support of Rustlings for third-party exercises allows you to create your own set of Rustlings exercises to focus on some specific topic.
-You could also offer a translation of the original Rustlings exercises as third-party exercises.
-
-## Getting started
-
-To create third-party exercises, install Rustlings and run `rustlings dev new PROJECT_NAME`.
-This command will, similar to `cargo new PROJECT_NAME`, create a template directory called `PROJECT_NAME` with all what you need to get started.
-
-Read the comments in the generated `info.toml` file to understand its format.
-It allows you to set a custom welcome and final message and specify the metadata of every exercise.
-
-## Create an exercise
-
-Here is an example of the metadata of one file:
-
-```toml
-[[exercises]]
-name = "intro1"
-hint = """
-To finish this exercise, you need to …
-This link might help you …"""
-```
-
-After entering this in `info.toml`, create the file `intro1.rs` in the `exercises/` directory.
-The exercise needs to contain a `main` function, but it can be empty.
-Adding tests is recommended.
-Look at the official Rustlings exercises for inspiration.
-
-You can optionally add a solution file `intro1.rs` to the `solutions/` directory.
-
-Now, run `rustlings dev check`.
-It will tell you about any issues with your exercises.
-For example, it will tell you to run `rustlings dev update` to update the `Cargo.toml` file to include the new exercise `intro1`.
-
-`rustlings dev check` will also run your solutions (if you have any) to make sure that they run successfully.
-
-That's it!
-You finished your first exercise 🎉
-
-## Publish
-
-Now, add more exercises and publish them as a Git repository.
-
-Users just have to clone that repository and run `rustlings` in it to start working on your set of exercises just like the official ones.
-
-One difference to the official exercises is that the solution files will not be hidden until the user finishes an exercise.
-But you can trust the users to not look at the solution too early 😉
-
-## Share
-
-After publishing your set of exercises, open an issue or a pull request in the official Rustlings repository to link to your project in the README 😃
diff --git a/build.rs b/build.rs
new file mode 100644
index 00000000..56878641
--- /dev/null
+++ b/build.rs
@@ -0,0 +1,5 @@
+fn main() {
+ // Fix building from source on Windows because it can't handle file links.
+ #[cfg(windows)]
+ let _ = std::fs::copy("dev/Cargo.toml", "dev-Cargo.toml");
+}
diff --git a/clippy.toml b/clippy.toml
index 2a981849..89b0a886 100644
--- a/clippy.toml
+++ b/clippy.toml
@@ -1,18 +1,11 @@
disallowed-types = [
- # Inefficient. Use `.queue(…)` instead.
- "crossterm::style::Stylize",
- "crossterm::style::styled_content::StyledContent",
+ { path = "crossterm::style::Stylize", reason = "inefficient, use `.queue(…)` instead" },
+ { path = "crossterm::style::styled_content::StyledContent", reason = "inefficient, use `.queue(…)` instead" },
]
disallowed-methods = [
- # We use `foldhash` instead of the default hasher.
- "std::collections::HashSet::new",
- "std::collections::HashSet::with_capacity",
- # Inefficient. Use `.queue(…)` instead.
- "crossterm::style::style",
- # Use `thread::Builder::spawn` instead and handle the error.
- "std::thread::spawn",
- "std::thread::Scope::spawn",
- # Return `ExitCode` instead.
- "std::process::exit",
+ { path = "crossterm::style::style", reason = "inefficient, use `.queue(…)` instead" },
+ { path = "std::thread::spawn", replacement = "std::thread::Builder::spawn", reason = "handle the error" },
+ { path = "std::thread::Scope::spawn", replacement = "std::thread::Builder::spawn", reason = "handle the error" },
+ { path = "std::process::exit", replacement = "std::process::ExitCode" },
]
diff --git a/dev/Cargo.toml b/dev/Cargo.toml
index 29a557a0..4f725b70 100644
--- a/dev/Cargo.toml
+++ b/dev/Cargo.toml
@@ -1,4 +1,4 @@
-# Don't edit the `bin` list manually! It is updated by `cargo run -- dev update`. This comment line will be stripped in `rustlings init`.
+# Don't edit the `bin` list manually! It is updated by `cargo dev update`. This comment line will be stripped in `rustlings init`.
bin = [
{ name = "intro1", path = "../exercises/00_intro/intro1.rs" },
{ name = "intro1_sol", path = "../solutions/00_intro/intro1.rs" },
@@ -192,7 +192,7 @@ bin = [
[package]
name = "exercises"
-edition = "2021"
+edition = "2024"
# Don't publish the exercises on crates.io!
publish = false
diff --git a/exercises/01_variables/README.md b/exercises/01_variables/README.md
index 7964ff29..5ba2efca 100644
--- a/exercises/01_variables/README.md
+++ b/exercises/01_variables/README.md
@@ -1,7 +1,7 @@
# Variables
In Rust, variables are immutable by default.
-When a variable is immutable, once a value is bound to a name, you can’t change that value.
+When a variable is immutable, once a value is bound to a name, you can't change that value.
You can make them mutable by adding `mut` in front of the variable name.
## Further information
diff --git a/exercises/01_variables/variables5.rs b/exercises/01_variables/variables5.rs
index 49db8e9e..cf5620da 100644
--- a/exercises/01_variables/variables5.rs
+++ b/exercises/01_variables/variables5.rs
@@ -1,6 +1,6 @@
fn main() {
let number = "T-H-R-E-E"; // Don't change this line
- println!("Spell a number: {}", number);
+ println!("Spell a number: {number}");
// TODO: Fix the compiler error by changing the line below without renaming the variable.
number = 3;
diff --git a/exercises/03_if/if2.rs b/exercises/03_if/if2.rs
index 10037f26..ca8493cc 100644
--- a/exercises/03_if/if2.rs
+++ b/exercises/03_if/if2.rs
@@ -19,7 +19,7 @@ mod tests {
#[test]
fn yummy_food() {
- // This means that calling `picky_eater` with the argument "food" should return "Yummy!".
+ // This means that calling `picky_eater` with the argument "strawberry" should return "Yummy!".
assert_eq!(picky_eater("strawberry"), "Yummy!");
}
diff --git a/exercises/05_vecs/vecs2.rs b/exercises/05_vecs/vecs2.rs
index a9be2580..0c996266 100644
--- a/exercises/05_vecs/vecs2.rs
+++ b/exercises/05_vecs/vecs2.rs
@@ -9,26 +9,6 @@ fn vec_loop(input: &[i32]) -> VecIf detecting file changes in the exercises/ directory fails… (click to expand)
-
-> You can add the **`--manual-run`** flag (`rustlings --manual-run`) to manually rerun the current exercise by entering `r` in the watch mode.
->
-> Please [report the issue](https://github.com/rust-lang/rustlings/issues/new) with some information about your operating system and whether you run Rustlings in a container or virtual machine (e.g. WSL).
-
-rustlings can't be found…") %}
+
+You are probably using Linux and installed Rust using your package manager.
+
+Cargo installs binaries to the directory `~/.cargo/bin`.
+Sadly, package managers often don't add `~/.cargo/bin` to your `PATH` environment variable.
+
+- Either add `~/.cargo/bin` manually to `PATH`
+- Or uninstall Rust from the package manager and [install it using the official way with `rustup`](https://www.rust-lang.org/tools/install)
+
+{% end %}
+
+Now, go into the newly initialized directory and launch Rustlings for further instructions on getting started with the exercises:
+
+```bash
+cd rustlings/
+rustlings
+```
+
+## Working environment
+
+### Editor
+
+Our general recommendation is [VS Code](https://code.visualstudio.com/) with the [rust-analyzer plugin](https://marketplace.visualstudio.com/items?itemName=rust-lang.rust-analyzer).
+But any editor that supports [rust-analyzer](https://rust-analyzer.github.io/) should be enough for working on the exercises.
+
+### Terminal
+
+While working with Rustlings, please use a modern terminal for the best user experience.
+The default terminal on Linux and Mac should be sufficient.
+On Windows, we recommend the [Windows Terminal](https://aka.ms/terminal).
+
+## Usage
+
+After being done with the setup, visit the [**usage**](@/usage/index.md) page for some info about using Rustlings 🚀
diff --git a/website/content/usage/index.md b/website/content/usage/index.md
new file mode 100644
index 00000000..88dabf4a
--- /dev/null
+++ b/website/content/usage/index.md
@@ -0,0 +1,55 @@
++++
+title = "Usage"
++++
+
+
+
+## Doing exercises
+
+The exercises are sorted by topic and can be found in the subdirectory `exercises/exercises/ directory fails…") %}
+
+You can add the **`--manual-run`** flag (`rustlings --manual-run`) to manually rerun the current exercise by entering `r` in the watch mode.
+
+Please [report the issue](https://github.com/rust-lang/rustlings/issues/new) with some information about your operating system and whether you run Rustlings in a container or a virtual machine (e.g. WSL).
+
+{% end %}
+
+## Exercise List
+
+In the [watch mode](#watch-mode) (after launching `rustlings`), you can enter `l` to open the interactive exercise list.
+
+The list allows you to…
+
+- See the status of all exercises (done or pending)
+- `c`: Continue at another exercise (temporarily skip some exercises or go back to a previous one)
+- `r`: Reset status and file of the selected exercise (you need to _reload/reopen_ its file in your editor afterwards)
+
+See the footer of the list for all possible keys.
+
+## Questions?
+
+If you need any help while doing the exercises and the builtin hints aren't helpful, feel free to ask in the [_Q&A_ discussions](https://github.com/rust-lang/rustlings/discussions/categories/q-a?discussions_q=) if your question isn't answered there 💡
+
+## Continuing On
+
+Once you've completed Rustlings, put your new knowledge to good use!
+Continue practicing your Rust skills by building your own projects, contributing to Rustlings, or finding other open-source projects to contribute to.
+
+> If you want to create your own Rustlings exercises, visit the [**community exercises**](@/community-exercises/index.md) page 🏗️
diff --git a/website/input.css b/website/input.css
new file mode 100644
index 00000000..af0675d8
--- /dev/null
+++ b/website/input.css
@@ -0,0 +1,54 @@
+@import 'tailwindcss';
+
+@layer base {
+ h1 {
+ @apply text-4xl mt-3 mb-3 font-bold;
+ }
+ h2 {
+ @apply text-3xl mt-4 mb-1.5 font-bold;
+ }
+ h3 {
+ @apply text-2xl mt-5 mb-1.5 font-bold;
+ }
+ h4 {
+ @apply text-xl mt-6 mb-1.5 font-bold;
+ }
+ p {
+ @apply mb-2;
+ }
+ a {
+ @apply text-[#FFC832] underline hover:decoration-orange-400 transition duration-300;
+ }
+ ul {
+ @apply mt-2 mb-3 ml-1 list-disc list-inside marker:text-sky-600;
+ }
+ ol {
+ @apply mt-2 mb-3 ml-1 list-decimal list-inside marker:text-sky-500;
+ }
+ li {
+ @apply my-0.5;
+ }
+ code {
+ @apply bg-white/10 px-1 pb-px pt-1 rounded-md;
+ }
+ pre code {
+ @apply bg-inherit p-0 text-inherit;
+ }
+ hr {
+ @apply my-5 rounded-full;
+ }
+ img {
+ @apply md:w-3/4 lg:w-3/5;
+ }
+ blockquote {
+ @apply px-3 pt-2 pb-0.5 mb-4 mt-2 border-s-4 border-white/80 bg-white/7 rounded-sm;
+ }
+
+ pre {
+ @apply px-2 pt-2 pb-px overflow-x-auto text-sm sm:text-base rounded-sm mt-2 mb-4 after:content-[attr(data-lang)] after:text-[8px] after:opacity-40 selection:bg-white/15;
+ }
+ pre code mark {
+ @apply pb-0.5 pt-1 pr-px text-inherit rounded-xs;
+ }
+}
+
diff --git a/website/justfile b/website/justfile
new file mode 100644
index 00000000..7efc3ef9
--- /dev/null
+++ b/website/justfile
@@ -0,0 +1,5 @@
+zola:
+ zola serve --open
+
+tailwind:
+ npx @tailwindcss/cli -w -i input.css -o static/main.css
diff --git a/website/package.json b/website/package.json
new file mode 100644
index 00000000..38dd27e9
--- /dev/null
+++ b/website/package.json
@@ -0,0 +1,5 @@
+{
+ "dependencies": {
+ "@tailwindcss/cli": "^4.1"
+ }
+}
diff --git a/website/static/images/happy_ferris.svg b/website/static/images/happy_ferris.svg
new file mode 100644
index 00000000..c7f240dd
--- /dev/null
+++ b/website/static/images/happy_ferris.svg
@@ -0,0 +1,33 @@
+
+
+
diff --git a/website/static/images/panic.svg b/website/static/images/panic.svg
new file mode 100644
index 00000000..be55f5e0
--- /dev/null
+++ b/website/static/images/panic.svg
@@ -0,0 +1,70 @@
+
+
+
+
diff --git a/website/static/images/rust_logo.svg b/website/static/images/rust_logo.svg
new file mode 100644
index 00000000..3b42cfe0
--- /dev/null
+++ b/website/static/images/rust_logo.svg
@@ -0,0 +1,61 @@
+
diff --git a/website/templates/404.html b/website/templates/404.html
new file mode 100644
index 00000000..eb9d4691
--- /dev/null
+++ b/website/templates/404.html
@@ -0,0 +1,14 @@
+{% extends "base.html" %}
+
+{% block content %}
+
+{% endblock %}
diff --git a/website/templates/anchor-link.html b/website/templates/anchor-link.html
new file mode 100644
index 00000000..c8644d96
--- /dev/null
+++ b/website/templates/anchor-link.html
@@ -0,0 +1,2 @@
+
diff --git a/website/templates/base.html b/website/templates/base.html
new file mode 100644
index 00000000..1a55aebf
--- /dev/null
+++ b/website/templates/base.html
@@ -0,0 +1,92 @@
+
+
+
+
+
+
+ {%- set timestamp = now(timestamp=true) -%}
+
+ {%- if page.title -%}
+ {% set_global title = page.title %}
+ {%- elif section.title -%}
+ {% set_global title = section.title %}
+ {%- else -%}
+ {% set_global title = config.title %}
+ {%- endif -%}
+
+ {%- if page.description -%}
+ {% set_global description = page.description %}
+ {%- elif section.description -%}
+ {% set_global description = section.description %}
+ {%- else -%}
+ {% set_global description = config.description %}
+ {%- endif -%}
+
+ {%- if page.permalink -%}
+ {% set_global permalink = page.permalink %}
+ {%- elif section.permalink -%}
+ {% set_global permalink = section.permalink %}
+ {%- endif %}
+
+
+
+{% endblock %}
diff --git a/website/templates/page.html b/website/templates/page.html
new file mode 100644
index 00000000..b2f6c019
--- /dev/null
+++ b/website/templates/page.html
@@ -0,0 +1,39 @@
+{% extends "base.html" %}
+
+{% block content %}
+ Rustlings
+ + {{ section.content | safe }} +
+
+ {{ summary | safe }} (click to expand) +
+ ++ {{ body | markdown | safe }} ++