Table of Contents

1. Challenge

   Introduction

   The goal of this lab is to complete the implementation for a product management application in Rust. Your tasks will involve the implementation and logic for two key data structures. The first will be a Category enum that represents the type of the product such as a food, electronic, or furniture item. The second will be a Product struct which represents the actual products in the inventory, including data such as their names, categories, prices, and quantities.

   You will also utilize the concept of pattern matching for the method implementations of these data structures to perform functions such as adding, removing, editing, and filtering for certain products in the inventory. Some other Rust features that you will be exposed to include the built-in Option enum and closures.

   At the end of the lab, you will be incorporating the implemented data structures into the main application logic to make the application fully functional. You can then run the application by clicking the Run button in the Terminal or inputting cargo run into the Terminal. Feel free to also checkout the solution directory if you get stuck.

2. Challenge

   Step 1: Category Enum

   The first data structure you will implement is the Category enum. Enums, short for enumerations, are custom data types that have a set of distinct values called variants. Each variant represents a state in which any variable of this enum type can be at any given time. For those who may be familiar with this concept in other languages such as C/C++ or Java, the concept is very much the same in Rust.

   The Category enum is necessary here because it represents the types of products in the inventory, which can be either Food, Electronic, or Furniture. Enums in Rust can have methods implemented for them, as seen in the impl Category block. Currently, the only method is get_category() which you will need to implement. You will need to utilize match statements in this method, which is a pattern matching construct in Rust for executing code depending on a certain condition.

   match statements follow the following format:

   match variable {
   	condition a => { execute code },
   	condition b => { execute code },
   	condition c => { execute code },
   	_ => { execute code }
   }
   

   This is very similar to switch statements from other languages, where if the variable meets a specific condition, only that block of code is executed. The final condition with the _ functions like a default case meant to be a catch-all for any conditions that are not specified or not important.

   The reason this is sometimes needed is because match statements are exhaustive; in other words, EVERY single possible value for the variable must have a condition. When using match where every possible value is addressed, this statement is not necessary. However, if you were to match to an integer value where you only want to do something if the value was 1, 2, 3, or 4, you would absolutely need this because the Rust compiler requires that ALL possible integer values be addressed.

   Another important detail is that the _ catch-all should always come last in a match statement because the order of a match is always top-down. If it was first, none of the other conditions would evaluate because the _ would always be matched first.

3. Challenge

   Step 2: Product Struct

   Now you will need to implement the Product struct. Product is also a data structure like Category, but this time it's a struct instead of an enum. Structs in Rust function similarly to classes in other languages and are typically used for object-oriented programming.

   In product.rs, you will find that the Product struct has already been defined. Each field has been marked pub to allow it to be visible in other modules, and each field has also had its type specified. You will be responsible for completing each method within the impl block. In the next two methods, you will be exposed to 3 more Rust features. The first is the Option enum, which is a built-in Rust enum that has 2 variants. These variants are Some(), and None. Since Rust does not have a null value, the Option enum is typically used for any actions that may not return a value. If a value is returned, then the Option is contains that value in Some(value). If not, then the Option is of the None variant.

   Next is closures. Closures in Rust are just like anonymous/lambda functions in other languages. They are typically seen in the format function_with_callback(|a| BODY). In this case, the closure is the entire expression within the parentheses. As an example, if you wanted to filter an array of numbers in Javascript to only include values greater than 5, you would do something along the lines of array.filter(x => x > 5). The Rust closure equivalent for the x => x > 5 expression would be |x| x > 5.

   Lastly, another form of pattern matching you will be using here is an if let as an alternative to match. For example:

   let example = function_that_returns_option();
   
   match example {
   	Some(i) => do_something(),
   	//Since Option can only be Some or None, you could replace None with _ here
   	None => {} // means do nothing
   };
   
   //Only executes if example is Some(), doesn't do anything if it is None
   if let Some(i) = example {
   	do something
   }
   

   In the event that you only care about a single specific condition, if let allows you to be far more compact than having to write out a full match statement with actions for the conditions that you don't care about.

4. Challenge

   Step 3: Incorporating into main application

   Now that you have defined and implemented both Category and Product, you will now need to utilize them in the application through main.rs. You will notice in main that there is another match statement that performs actions based on the user input and it will be your task to add the appropriate function calls from Category and Product to the correct input cases. With all the tasks done, the application is now fully functional! Running the application will prompt you with options to either add, remove, or edit a Product. The search function allows you to retrieve all products that contain the specified keyword, while the show all option will display all products currently in the inventory.

5. Challenge

   Epilogue

   If you'd like to play around some more with the application after completing the lab, feel free to do so! For instance, adding more variants to Category(remember to address them in get_category()) or some other methods to the Category implementation. Perhaps you could also modify edit_product to change its name or category as well!

   Although there won't be any tasks for you in whatever you'd like to do, you can always run cargo check(to check that your code will compile) or cargo run to test any edits you make. The Rust compiler is very specific on what issues your code may have and you should definitely get used to reading its output when working on any Rust applications!