Merge branch 'main' into rc-exercise

Author: manyinsects

.all-contributorsrc

@@ -1371,6 +1371,132 @@
       "contributions": [
         "content"
       ]
+    },
+    {
+      "login": "wojexe",
+      "name": "wojexe",
+      "avatar_url": "https://avatars.githubusercontent.com/u/21208490?v=4",
+      "profile": "https://wojexe.com",
+      "contributions": [
+        "content"
+      ]
+    },
+    {
+      "login": "Tostapunk",
+      "name": "Mattia Schiavon",
+      "avatar_url": "https://avatars.githubusercontent.com/u/25140297?v=4",
+      "profile": "https://github.com/Tostapunk",
+      "contributions": [
+        "content"
+      ]
+    },
+    {
+      "login": "PrettyWood",
+      "name": "Eric Jolibois",
+      "avatar_url": "https://avatars.githubusercontent.com/u/18406791?v=4",
+      "profile": "http://toucantoco.com",
+      "contributions": [
+        "content"
+      ]
+    },
+    {
+      "login": "EdwinChang24",
+      "name": "Edwin Chang",
+      "avatar_url": "https://avatars.githubusercontent.com/u/88263098?v=4",
+      "profile": "http://edwinchang.vercel.app",
+      "contributions": [
+        "content"
+      ]
+    },
+    {
+      "login": "saikatdas0790",
+      "name": "Saikat Das",
+      "avatar_url": "https://avatars.githubusercontent.com/u/7412443?v=4",
+      "profile": "https://saikat.dev/",
+      "contributions": [
+        "content"
+      ]
+    },
+    {
+      "login": "thatlittleboy",
+      "name": "Jeremy Goh",
+      "avatar_url": "https://avatars.githubusercontent.com/u/30731072?v=4",
+      "profile": "https://github.com/thatlittleboy",
+      "contributions": [
+        "content"
+      ]
+    },
+    {
+      "login": "Lioness100",
+      "name": "Lioness100",
+      "avatar_url": "https://avatars.githubusercontent.com/u/65814829?v=4",
+      "profile": "https://github.com/Lioness100",
+      "contributions": [
+        "content"
+      ]
+    },
+    {
+      "login": "tvkn",
+      "name": "Tristan Nicholls",
+      "avatar_url": "https://avatars.githubusercontent.com/u/79277926?v=4",
+      "profile": "https://github.com/tvkn",
+      "contributions": [
+        "content"
+      ]
+    },
+    {
+      "login": "clairew",
+      "name": "Claire",
+      "avatar_url": "https://avatars.githubusercontent.com/u/9344258?v=4",
+      "profile": "http://clairewang.net",
+      "contributions": [
+        "content"
+      ]
+    },
+    {
+      "login": "Mouwrice",
+      "name": "Maurice Van Wassenhove",
+      "avatar_url": "https://avatars.githubusercontent.com/u/56763273?v=4",
+      "profile": "https://github.com/Mouwrice",
+      "contributions": [
+        "content"
+      ]
+    },
+    {
+      "login": "johnmendel",
+      "name": "John Mendelewski",
+      "avatar_url": "https://avatars.githubusercontent.com/u/77524?v=4",
+      "profile": "http://jmthree.com",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "brianfakhoury",
+      "name": "Brian Fakhoury",
+      "avatar_url": "https://avatars.githubusercontent.com/u/20828724?v=4",
+      "profile": "http://fakhoury.xyz",
+      "contributions": [
+        "content"
+      ]
+    },
+    {
+      "login": "markusboehme",
+      "name": "Markus Boehme",
+      "avatar_url": "https://avatars.githubusercontent.com/u/5074759?v=4",
+      "profile": "https://github.com/markusboehme",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "nico-vromans",
+      "name": "Nico Vromans",
+      "avatar_url": "https://avatars.githubusercontent.com/u/48183857?v=4",
+      "profile": "https://github.com/nico-vromans",
+      "contributions": [
+        "content"
+      ]
     }
   ],
   "contributorsPerLine": 8,

.editorconfig

@@ -2,6 +2,6 @@ root = true
 
 [*.rs]
 end_of_line = lf
-insert_final_newfile = true
+insert_final_newline = true
 indent_style = space
 indent_size = 4

AUTHORS.md

@@ -195,6 +195,24 @@ authors.
     <td align="center"><a href="https://jamesabromley.wordpress.com/"><img src="https://avatars.githubusercontent.com/u/2474334?v=4?s=100" width="100px;" alt=""/><br /><sub><b>James Bromley</b></sub></a><br /><a href="#content-jayber" title="Content">🖋</a></td>
     <td align="center"><a href="https://github.com/swhiteCQC"><img src="https://avatars.githubusercontent.com/u/77438466?v=4?s=100" width="100px;" alt=""/><br /><sub><b>swhiteCQC</b></sub></a><br /><a href="#content-swhiteCQC" title="Content">🖋</a></td>
     <td align="center"><a href="https://github.com/neilpate"><img src="https://avatars.githubusercontent.com/u/7802334?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Neil Pate</b></sub></a><br /><a href="#content-neilpate" title="Content">🖋</a></td>
+    <td align="center"><a href="https://wojexe.com"><img src="https://avatars.githubusercontent.com/u/21208490?v=4?s=100" width="100px;" alt=""/><br /><sub><b>wojexe</b></sub></a><br /><a href="#content-wojexe" title="Content">🖋</a></td>
+    <td align="center"><a href="https://github.com/Tostapunk"><img src="https://avatars.githubusercontent.com/u/25140297?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Mattia Schiavon</b></sub></a><br /><a href="#content-Tostapunk" title="Content">🖋</a></td>
+    <td align="center"><a href="http://toucantoco.com"><img src="https://avatars.githubusercontent.com/u/18406791?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Eric Jolibois</b></sub></a><br /><a href="#content-PrettyWood" title="Content">🖋</a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="http://edwinchang.vercel.app"><img src="https://avatars.githubusercontent.com/u/88263098?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Edwin Chang</b></sub></a><br /><a href="#content-EdwinChang24" title="Content">🖋</a></td>
+    <td align="center"><a href="https://saikat.dev/"><img src="https://avatars.githubusercontent.com/u/7412443?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Saikat Das</b></sub></a><br /><a href="#content-saikatdas0790" title="Content">🖋</a></td>
+    <td align="center"><a href="https://github.com/thatlittleboy"><img src="https://avatars.githubusercontent.com/u/30731072?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Jeremy Goh</b></sub></a><br /><a href="#content-thatlittleboy" title="Content">🖋</a></td>
+    <td align="center"><a href="https://github.com/Lioness100"><img src="https://avatars.githubusercontent.com/u/65814829?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Lioness100</b></sub></a><br /><a href="#content-Lioness100" title="Content">🖋</a></td>
+    <td align="center"><a href="https://github.com/tvkn"><img src="https://avatars.githubusercontent.com/u/79277926?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Tristan Nicholls</b></sub></a><br /><a href="#content-tvkn" title="Content">🖋</a></td>
+    <td align="center"><a href="http://clairewang.net"><img src="https://avatars.githubusercontent.com/u/9344258?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Claire</b></sub></a><br /><a href="#content-clairew" title="Content">🖋</a></td>
+    <td align="center"><a href="https://github.com/Mouwrice"><img src="https://avatars.githubusercontent.com/u/56763273?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Maurice Van Wassenhove</b></sub></a><br /><a href="#content-Mouwrice" title="Content">🖋</a></td>
+    <td align="center"><a href="http://jmthree.com"><img src="https://avatars.githubusercontent.com/u/77524?v=4?s=100" width="100px;" alt=""/><br /><sub><b>John Mendelewski</b></sub></a><br /><a href="https://github.com/rust-lang/rustlings/commits?author=johnmendel" title="Code">💻</a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="http://fakhoury.xyz"><img src="https://avatars.githubusercontent.com/u/20828724?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Brian Fakhoury</b></sub></a><br /><a href="#content-brianfakhoury" title="Content">🖋</a></td>
+    <td align="center"><a href="https://github.com/markusboehme"><img src="https://avatars.githubusercontent.com/u/5074759?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Markus Boehme</b></sub></a><br /><a href="https://github.com/rust-lang/rustlings/commits?author=markusboehme" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/nico-vromans"><img src="https://avatars.githubusercontent.com/u/48183857?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Nico Vromans</b></sub></a><br /><a href="#content-nico-vromans" title="Content">🖋</a></td>
   </tr>
 </table>
 

CHANGELOG.md

@@ -1,3 +1,76 @@
+<a name="5.0.0"></a>
+## 5.0.0 (2022-07-16)
+
+#### Features
+
+- Hint comments in exercises now also include a reference to the
+  `hint` watch mode subcommand.
+- **intro1**: Added more hints to point the user to the source file.
+- **variables**: Switched variables3 and variables4.
+- Moved `vec` and `primitive_types` exercises before `move_semantics`.
+- Renamed `vec` to `vecs` to be more in line with the naming in general.
+- Split up the `collections` exercises in their own folders.
+- **vec2**: Added a second part of the function that provides an alternative,
+  immutable way of modifying vec values.
+- **enums3**: Added a hint.
+- Moved `strings` before `modules`.
+- Added a `strings3` exercise to teach modifying strings.
+- Added a `hashmaps3` exercise for some advanced usage of hashmaps.
+- Moved the original `quiz2` to be `strings4`, since it only tested strings
+  anyways.
+- Reworked `quiz2` into a new exercise that tests more chapters.
+- Renamed `option` to `options`.
+- **options1**: Rewrote parts of the exercise to remove the weird array
+  iteration stuff.
+- Moved `generics3` to be `quiz3`.
+- Moved box/arc exercises behind `iterators`.
+- **iterators4**: Added a test for factorials of zero.
+- Split `threads1` between two exercises, the first one focusing more on
+  `JoinHandle`s.
+- Added a `threads3` exercises that uses `std::sync::mpsc`.
+- Added a `clippy3` exercises with some more interesting checks.
+- **as_ref_mut**: Added a section that actually tests `AsMut`.
+- Added 3 new lifetimes exercises.
+- Added 3 new traits exercises.
+
+#### Bug Fixes
+
+- **variables2**: Made output messages more verbose.
+- **variables5**: Added a nudging hint about shadowing.
+- **variables6**: Fixed link to book.
+- **functions**: Clarified the README wording. Generally cleaned up
+  some hints and added some extra comments.
+- **if2**: Renamed function name to `foo_if_fizz`.
+- **move_semantics**: Clarified some hints.
+- **quiz1**: Renamed the function name to be more verbose.
+- **structs1**: Use an integer type instead of strings. Renamed "unit structs"
+  to "unit-like structs", as is used in the book.
+- **structs3**: Added the `panic!` statement in from the beginning.
+- **errors1**: Use `is_empty()` instead of `len() > 0`
+- **errors3**: Improved the hint.
+- **errors5**: Improved exercise instructions and the hint.
+- **errors6**: Provided the skeleton of one of the functions that's supposed
+  to be implemented.
+- **iterators3**: Inserted `todo!` into `divide()` to keep a compiler error
+  from happening.
+- **from_str**: Added a hint comment about string error message conversion with
+  `Box<dyn Error>`.
+- **try_from_into**: Fixed the function name in comment.
+  
+#### Removed
+
+- Removed the legacy LSP feature that was using `mod.rs` files.
+- Removed `quiz4`.
+- Removed `advanced_errs`. These were the last exercises in the recommended
+  order, and I've always felt like they didn't quite fit in with the mostly
+  simple, book-following style we've had in Rustlings.
+
+#### Housekeeping
+
+- Added missing exercises to the book index.
+- Updated spacing in Cargo.toml.
+- Added a GitHub actions config so that tests run on every PR/commit.
+
 <a name="4.8.0"></a>
 ## 4.8.0 (2022-07-01)
 

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "rustlings"
-version = "4.8.0"
+version = "5.0.0"
 authors = ["Liv <[email protected]>", "Carol (Nichols || Goulding) <[email protected]>"]
 edition = "2021"
 

Cargo.toml

@@ -54,11 +54,11 @@ If you get a permission denied message, you might have to exclude the directory
 
 ## Manually
 
-Basically: Clone the repository at the latest tag, run `cargo install`.
+Basically: Clone the repository at the latest tag, run `cargo install --path .`.
 
 ```bash
-# find out the latest version at https://github.com/rust-lang/rustlings/releases/latest (on edit 4.7.1)
-git clone -b 4.7.1 --depth 1 https://github.com/rust-lang/rustlings
+# find out the latest version at https://github.com/rust-lang/rustlings/releases/latest (on edit 5.0.0)
+git clone -b 5.0.0 --depth 1 https://github.com/rust-lang/rustlings
 cd rustlings
 cargo install --force --path .
 ```

README.md

@@ -5,20 +5,22 @@
 | variables              | §3.1                |
 | functions              | §3.3                |
 | if                     | §3.5                |
-| move_semantics         | §4.1, §4.2          |
 | primitive_types        | §3.2, §4.3          |
+| vecs                   | §8.1                |
+| move_semantics         | §4.1, §4.2          |
 | structs                | §5.1, §5.3          |
 | enums                  | §6, §18.3           |
-| modules                | §7                  |
-| collections            | §8.1, §8.3          |
 | strings                | §8.2                |
+| modules                | §7                  |
+| hashmaps               | §8.3                |
+| options                | §10.1               |
 | error_handling         | §9                  |
 | generics               | §10                 |
-| option                 | §10.1               |
 | traits                 | §10.2               |
 | tests                  | §11.1               |
+| lifetimes              | §10.3               |
 | standard_library_types | §13.2, §15.1, §16.3 |
-| threads                | §16.1               |
+| threads                | §16.1, §16.2, §16.3 |
 | macros                 | §19.6               |
 | clippy                 | n/a                 |
 | conversions            | n/a                 |

exercises/README.md

@@ -4,6 +4,8 @@
 
 // This exercise uses some concepts that we won't get to until later in the course, like `Box` and the
 // `From` trait. It's not important to understand them in detail right now, but you can read ahead if you like.
+// For now, think of the `Box<dyn ...>` type as an "I want anything that does ???" type, which, given
+// Rust's usual standards for runtime safety, should strike you as somewhat lenient!
 
 // In short, this particular use case for boxes is for when you want to own a value and you care only that it is a 
 // type which implements a particular trait. To do so, The Box is declared as of type Box<dyn Trait> where Trait is the trait

exercises/error_handling/errors5.rs

@@ -7,4 +7,4 @@ macros. Instead, we'll show you how to use and create them.
 ## Further information
 
 - [Macros](https://doc.rust-lang.org/book/ch19-06-macros.html)
-- [The Little Book of Rust Macros](https://danielkeep.github.io/tlborm/book/index.html)
+- [The Little Book of Rust Macros](https://veykril.github.io/tlborm/)