Align arrows in diagrams (#39)

book/src/02_basic_calculator/08_overflow.md

@@ -108,5 +108,3 @@ application, you can run benchmarks to decide if it's something you can afford.
 
 - Check out ["Myths and legends about integer overflow in Rust"](https://huonw.github.io/blog/2016/04/myths-and-legends-about-integer-overflow-in-rust/)
 for an in-depth discussion about integer overflow in Rust.
-
-[^catching]: You can try to catch a panic, but it should be a last resort reserved for very specific circumstances.

book/src/03_ticket_v1/09_heap.md

@@ -81,11 +81,11 @@ s.push_str("Hey");
 ```
       +---------+--------+----------+
 Stack | pointer | length | capacity |
-      |    |    |   3    |    5     |
-      +----|----+--------+----------+
-           |       
-           |       
-           v       
+      |  |      |   3    |    5     |
+      +--|  ----+--------+----------+
+         |
+         |
+         v
        +---+---+---+---+---+
 Heap:  | H | e | y | ? | ? |
        +---+---+---+---+---+

book/src/03_ticket_v1/10_references_in_memory.md

@@ -27,11 +27,11 @@ you'll get something like this in memory:
            |                                    |
       +----v----+--------+----------+      +----|----+
 Stack | pointer | length | capacity |      | pointer |
-      |    |    |   3    |    5     |      |         |
-      +----|----+--------+----------+      +---------+
-           |        s                           r
-           |       
-           v       
+      |  |      |   3    |    5     |      |         |
+      +--|  ----+--------+----------+      +---------+
+         |          s                           r
+         |
+         v
        +---+---+---+---+---+
 Heap   | H | e | y | ? | ? |
        +---+---+---+---+---+

book/src/04_traits/03_operator_overloading.md

@@ -28,7 +28,7 @@ pub trait PartialEq {
 ```
 
 When you write `x == y` the compiler will look for an implementation of the `PartialEq` trait for the types of `x` and `y`
-and replace `x == y` with `x.eq(y)`. It's syntax sugar!
+and replace `x == y` with `x.eq(y)`. It's syntactic sugar!
 
 This is the correspondence for the main operators:
 

book/src/04_traits/04_derive.md

@@ -100,3 +100,8 @@ The compiler will nudge you to derive traits when possible.
 ## References
 
 - The exercise for this section is located in `exercises/04_traits/04_derive`
+
+## Further reading
+
+- [The little book of Rust macros](https://veykril.github.io/tlborm/)
+- [Proc macro workshop](https://github.com/dtolnay/proc-macro-workshop)

book/src/05_ticket_v2/06_fallibility.md

@@ -9,13 +9,13 @@ impl Ticket {
             panic!("Title cannot be empty");
         }
         if title.len() > 50 {
-            panic!("Title cannot be longer than 50 characters");
+            panic!("Title cannot be longer than 50 bytes");
         }
         if description.is_empty() {
             panic!("Description cannot be empty");
         }
         if description.len() > 500 {
-            panic!("Description cannot be longer than 500 characters");
+            panic!("Description cannot be longer than 500 bytes");
         }
 
         Ticket {

exercises/03_ticket_v1/02_validation/src/lib.rs

@@ -44,13 +44,13 @@ mod tests {
     }
 
     #[test]
-    #[should_panic(expected = "Title cannot be longer than 50 characters")]
+    #[should_panic(expected = "Title cannot be longer than 50 bytes")]
     fn title_cannot_be_longer_than_fifty_chars() {
         Ticket::new(overly_long_title(), valid_description(), "To-Do".into());
     }
 
     #[test]
-    #[should_panic(expected = "Description cannot be longer than 500 characters")]
+    #[should_panic(expected = "Description cannot be longer than 500 bytes")]
     fn description_cannot_be_longer_than_500_chars() {
         Ticket::new(valid_title(), overly_long_description(), "To-Do".into());
     }

exercises/03_ticket_v1/03_modules/src/lib.rs

@@ -19,13 +19,13 @@ impl Ticket {
             panic!("Title cannot be empty");
         }
         if title.len() > 50 {
-            panic!("Title cannot be longer than 50 characters");
+            panic!("Title cannot be longer than 50 bytes");
         }
         if description.is_empty() {
             panic!("Description cannot be empty");
         }
         if description.len() > 500 {
-            panic!("Description cannot be longer than 500 characters");
+            panic!("Description cannot be longer than 500 bytes");
         }
         if status != "To-Do" && status != "In Progress" && status != "Done" {
             panic!("Only `To-Do`, `In Progress`, and `Done` statuses are allowed");

exercises/03_ticket_v1/04_visibility/src/lib.rs

@@ -11,13 +11,13 @@ mod ticket {
                 panic!("Title cannot be empty");
             }
             if title.len() > 50 {
-                panic!("Title cannot be longer than 50 characters");
+                panic!("Title cannot be longer than 50 bytes");
             }
             if description.is_empty() {
                 panic!("Description cannot be empty");
             }
             if description.len() > 500 {
-                panic!("Description cannot be longer than 500 characters");
+                panic!("Description cannot be longer than 500 bytes");
             }
             if status != "To-Do" && status != "In Progress" && status != "Done" {
                 panic!("Only `To-Do`, `In Progress`, and `Done` statuses are allowed");

exercises/03_ticket_v1/05_encapsulation/src/lib.rs

@@ -11,13 +11,13 @@ pub mod ticket {
                 panic!("Title cannot be empty");
             }
             if title.len() > 50 {
-                panic!("Title cannot be longer than 50 characters");
+                panic!("Title cannot be longer than 50 bytes");
             }
             if description.is_empty() {
                 panic!("Description cannot be empty");
             }
             if description.len() > 500 {
-                panic!("Description cannot be longer than 500 characters");
+                panic!("Description cannot be longer than 500 bytes");
             }
             if status != "To-Do" && status != "In Progress" && status != "Done" {
                 panic!("Only `To-Do`, `In Progress`, and `Done` statuses are allowed");

exercises/03_ticket_v1/06_ownership/src/lib.rs

@@ -15,13 +15,13 @@ impl Ticket {
             panic!("Title cannot be empty");
         }
         if title.len() > 50 {
-            panic!("Title cannot be longer than 50 characters");
+            panic!("Title cannot be longer than 50 bytes");
         }
         if description.is_empty() {
             panic!("Description cannot be empty");
         }
         if description.len() > 500 {
-            panic!("Description cannot be longer than 500 characters");
+            panic!("Description cannot be longer than 500 bytes");
         }
         if status != "To-Do" && status != "In Progress" && status != "Done" {
             panic!("Only `To-Do`, `In Progress`, and `Done` statuses are allowed");

exercises/03_ticket_v1/07_setters/src/lib.rs

@@ -14,13 +14,13 @@ impl Ticket {
             panic!("Title cannot be empty");
         }
         if title.len() > 50 {
-            panic!("Title cannot be longer than 50 characters");
+            panic!("Title cannot be longer than 50 bytes");
         }
         if description.is_empty() {
             panic!("Description cannot be empty");
         }
         if description.len() > 500 {
-            panic!("Description cannot be longer than 500 characters");
+            panic!("Description cannot be longer than 500 bytes");
         }
         if status != "To-Do" && status != "In Progress" && status != "Done" {
             panic!("Only `To-Do`, `In Progress`, and `Done` statuses are allowed");
@@ -76,14 +76,14 @@ mod tests {
     }
 
     #[test]
-    #[should_panic(expected = "Title cannot be longer than 50 characters")]
+    #[should_panic(expected = "Title cannot be longer than 50 bytes")]
     fn title_cannot_be_longer_than_fifty_chars() {
         Ticket::new(valid_title(), valid_description(), "To-Do".into())
             .set_title(overly_long_title())
     }
 
     #[test]
-    #[should_panic(expected = "Description cannot be longer than 500 characters")]
+    #[should_panic(expected = "Description cannot be longer than 500 bytes")]
     fn description_cannot_be_longer_than_500_chars() {
         Ticket::new(valid_title(), valid_description(), "To-Do".into())
             .set_description(overly_long_description())

exercises/03_ticket_v1/10_references_in_memory/src/lib.rs

@@ -18,7 +18,7 @@ mod tests {
 
     #[test]
     fn u64_mut_ref_size() {
-        assert_eq!(size_of::<&u64>(), todo!());
+        assert_eq!(size_of::<&mut u64>(), todo!());
     }
 
     #[test]

exercises/03_ticket_v1/12_outro/src/lib.rs

@@ -1,6 +1,6 @@
 // TODO: Define a new `Order` type.
 //   It should keep track of three pieces of information: `product_name`, `quantity`, and `unit_price`.
-//   The product name can't be empty and it can't be longer than 300 characters.
+//   The product name can't be empty and it can't be longer than 300 bytes.
 //   The quantity must be strictly greater than zero.
 //   The unit price is in cents and must be strictly greater than zero.
 //   Order must include a method named `total` that returns the total price of the order.

exercises/04_traits/05_str_slice/src/lib.rs

@@ -12,13 +12,13 @@ impl Ticket {
             panic!("Title cannot be empty");
         }
         if title.len() > 50 {
-            panic!("Title cannot be longer than 50 characters");
+            panic!("Title cannot be longer than 50 bytes");
         }
         if description.is_empty() {
             panic!("Description cannot be empty");
         }
         if description.len() > 500 {
-            panic!("Description cannot be longer than 500 characters");
+            panic!("Description cannot be longer than 500 bytes");
         }
         if status != "To-Do" && status != "In Progress" && status != "Done" {
             panic!("Only `To-Do`, `In Progress`, and `Done` statuses are allowed");

exercises/05_ticket_v2/01_enum/src/lib.rs

@@ -20,13 +20,13 @@ impl Ticket {
             panic!("Title cannot be empty");
         }
         if title.len() > 50 {
-            panic!("Title cannot be longer than 50 characters");
+            panic!("Title cannot be longer than 50 bytes");
         }
         if description.is_empty() {
             panic!("Description cannot be empty");
         }
         if description.len() > 500 {
-            panic!("Description cannot be longer than 500 characters");
+            panic!("Description cannot be longer than 500 bytes");
         }
         if status != "To-Do" && status != "In Progress" && status != "Done" {
             panic!("Only `To-Do`, `In Progress`, and `Done` statuses are allowed");

exercises/05_ticket_v2/03_variants_with_data/src/lib.rs

@@ -22,13 +22,13 @@ impl Ticket {
             panic!("Title cannot be empty");
         }
         if title.len() > 50 {
-            panic!("Title cannot be longer than 50 characters");
+            panic!("Title cannot be longer than 50 bytes");
         }
         if description.is_empty() {
             panic!("Description cannot be empty");
         }
         if description.len() > 500 {
-            panic!("Description cannot be longer than 500 characters");
+            panic!("Description cannot be longer than 500 bytes");
         }
 
         Ticket {

exercises/05_ticket_v2/05_nullability/src/lib.rs

@@ -20,13 +20,13 @@ impl Ticket {
             panic!("Title cannot be empty");
         }
         if title.len() > 50 {
-            panic!("Title cannot be longer than 50 characters");
+            panic!("Title cannot be longer than 50 bytes");
         }
         if description.is_empty() {
             panic!("Description cannot be empty");
         }
         if description.len() > 500 {
-            panic!("Description cannot be longer than 500 characters");
+            panic!("Description cannot be longer than 500 bytes");
         }
 
         Ticket {

exercises/05_ticket_v2/06_fallibility/src/lib.rs

@@ -21,13 +21,13 @@ impl Ticket {
             panic!("Title cannot be empty");
         }
         if title.len() > 50 {
-            panic!("Title cannot be longer than 50 characters");
+            panic!("Title cannot be longer than 50 bytes");
         }
         if description.is_empty() {
             panic!("Description cannot be empty");
         }
         if description.len() > 500 {
-            panic!("Description cannot be longer than 500 characters");
+            panic!("Description cannot be longer than 500 bytes");
         }
 
         Ticket {
@@ -59,13 +59,13 @@ mod tests {
     fn title_cannot_be_longer_than_fifty_chars() {
         let error =
             Ticket::new(overly_long_title(), valid_description(), Status::ToDo).unwrap_err();
-        assert_eq!(error, "Title cannot be longer than 50 characters");
+        assert_eq!(error, "Title cannot be longer than 50 bytes");
     }
 
     #[test]
     fn description_cannot_be_longer_than_500_chars() {
         let error =
             Ticket::new(valid_title(), overly_long_description(), Status::ToDo).unwrap_err();
-        assert_eq!(error, "Description cannot be longer than 500 characters");
+        assert_eq!(error, "Description cannot be longer than 500 bytes");
     }
 }

exercises/05_ticket_v2/07_unwrap/src/lib.rs

@@ -25,13 +25,13 @@ impl Ticket {
             return Err("Title cannot be empty".to_string());
         }
         if title.len() > 50 {
-            return Err("Title cannot be longer than 50 characters".to_string());
+            return Err("Title cannot be longer than 50 bytes".to_string());
         }
         if description.is_empty() {
             return Err("Description cannot be empty".to_string());
         }
         if description.len() > 500 {
-            return Err("Description cannot be longer than 500 characters".to_string());
+            return Err("Description cannot be longer than 500 bytes".to_string());
         }
 
         Ok(Ticket {
@@ -60,7 +60,7 @@ mod tests {
     }
 
     #[test]
-    #[should_panic(expected = "Title cannot be longer than 50 characters")]
+    #[should_panic(expected = "Title cannot be longer than 50 bytes")]
     fn title_cannot_be_longer_than_fifty_chars() {
         easy_ticket(overly_long_title(), valid_description(), Status::ToDo);
     }

exercises/05_ticket_v2/08_error_enums/src/lib.rs

@@ -35,13 +35,13 @@ impl Ticket {
             return Err("Title cannot be empty".to_string());
         }
         if title.len() > 50 {
-            return Err("Title cannot be longer than 50 characters".to_string());
+            return Err("Title cannot be longer than 50 bytes".to_string());
         }
         if description.is_empty() {
             return Err("Description cannot be empty".to_string());
         }
         if description.len() > 500 {
-            return Err("Description cannot be longer than 500 characters".to_string());
+            return Err("Description cannot be longer than 500 bytes".to_string());
         }
 
         Ok(Ticket {
@@ -70,7 +70,7 @@ mod tests {
     }
 
     #[test]
-    #[should_panic(expected = "Title cannot be longer than 50 characters")]
+    #[should_panic(expected = "Title cannot be longer than 50 bytes")]
     fn title_cannot_be_longer_than_fifty_chars() {
         easy_ticket(overly_long_title(), valid_description(), Status::ToDo);
     }

exercises/05_ticket_v2/09_error_trait/src/lib.rs

@@ -43,7 +43,7 @@ impl Ticket {
         }
         if title.len() > 50 {
             return Err(TicketNewError::TitleError(
-                "Title cannot be longer than 50 characters".to_string(),
+                "Title cannot be longer than 50 bytes".to_string(),
             ));
         }
         if description.is_empty() {
@@ -53,7 +53,7 @@ impl Ticket {
         }
         if description.len() > 500 {
             return Err(TicketNewError::DescriptionError(
-                "Description cannot be longer than 500 characters".to_string(),
+                "Description cannot be longer than 500 bytes".to_string(),
             ));
         }
 
@@ -84,7 +84,7 @@ mod tests {
     }
 
     #[test]
-    #[should_panic(expected = "Title cannot be longer than 50 characters")]
+    #[should_panic(expected = "Title cannot be longer than 50 bytes")]
     fn title_cannot_be_longer_than_fifty_chars() {
         easy_ticket(overly_long_title(), valid_description(), Status::ToDo);
     }

exercises/05_ticket_v2/12_thiserror/src/lib.rs

@@ -71,7 +71,7 @@ mod tests {
     #[test]
     fn title_cannot_be_longer_than_fifty_chars() {
         let err = Ticket::new(overly_long_title(), valid_description(), Status::ToDo).unwrap_err();
-        assert_eq!(err.to_string(), "Title cannot be longer than 50 characters");
+        assert_eq!(err.to_string(), "Title cannot be longer than 50 bytes");
     }
 
     #[test]
@@ -79,7 +79,7 @@ mod tests {
         let err = Ticket::new(valid_title(), overly_long_description(), Status::ToDo).unwrap_err();
         assert_eq!(
             err.to_string(),
-            "Description cannot be longer than 500 characters"
+            "Description cannot be longer than 500 bytes"
         );
     }
 }

exercises/05_ticket_v2/14_source/src/lib.rs

@@ -17,11 +17,11 @@ mod status;
 pub enum TicketNewError {
     #[error("Title cannot be empty")]
     TitleCannotBeEmpty,
-    #[error("Title cannot be longer than 50 characters")]
+    #[error("Title cannot be longer than 50 bytes")]
     TitleTooLong,
     #[error("Description cannot be empty")]
     DescriptionCannotBeEmpty,
-    #[error("Description cannot be longer than 500 characters")]
+    #[error("Description cannot be longer than 500 bytes")]
     DescriptionTooLong,
 }
 

exercises/05_ticket_v2/15_outro/src/description.rs

@@ -1,5 +1,5 @@
 // TODO: Implement `TryFrom<String>` and `TryFrom<&str>` for the `TicketDescription` type,
-//   enforcing that the description is not empty and is not longer than 500 characters.
+//   enforcing that the description is not empty and is not longer than 500 bytes.
 //   Implement the traits required to make the tests pass too.
 
 pub struct TicketDescription(String);
@@ -27,7 +27,7 @@ mod tests {
         let err = TicketDescription::try_from(description).unwrap_err();
         assert_eq!(
             err.to_string(),
-            "The description cannot be longer than 500 characters"
+            "The description cannot be longer than 500 bytes"
         );
     }
 

exercises/05_ticket_v2/15_outro/src/title.rs

@@ -27,10 +27,7 @@ mod tests {
             "A title that's definitely longer than what should be allowed in a development ticket"
                 .to_string();
         let err = TicketTitle::try_from(title).unwrap_err();
-        assert_eq!(
-            err.to_string(),
-            "The title cannot be longer than 50 characters"
-        );
+        assert_eq!(err.to_string(), "The title cannot be longer than 50 bytes");
     }
 
     #[test]

helpers/ticket_fields/src/description.rs

@@ -5,7 +5,7 @@ pub struct TicketDescription(String);
 pub enum TicketDescriptionError {
     #[error("The description cannot be empty")]
     Empty,
-    #[error("The description cannot be longer than 500 characters")]
+    #[error("The description cannot be longer than 500 bytes")]
     TooLong,
 }
 
@@ -61,7 +61,7 @@ mod tests {
         let err = TicketDescription::try_from(overly_long_description()).unwrap_err();
         assert_eq!(
             err.to_string(),
-            "The description cannot be longer than 500 characters"
+            "The description cannot be longer than 500 bytes"
         );
     }
 

helpers/ticket_fields/src/title.rs

@@ -7,7 +7,7 @@ pub struct TicketTitle(String);
 pub enum TicketTitleError {
     #[error("The title cannot be empty")]
     Empty,
-    #[error("The title cannot be longer than 50 characters")]
+    #[error("The title cannot be longer than 50 bytes")]
     TooLong,
 }
 
@@ -61,10 +61,7 @@ mod tests {
     #[test]
     fn test_try_from_long_string() {
         let err = TicketTitle::try_from(overly_long_title()).unwrap_err();
-        assert_eq!(
-            err.to_string(),
-            "The title cannot be longer than 50 characters"
-        );
+        assert_eq!(err.to_string(), "The title cannot be longer than 50 bytes");
     }
 
     #[test]