Update app.py

app.py

@@ -45,8 +45,13 @@ lessons = [
 - Topic C: Create a Python Application  
 - Topic D: Prevent Errors  
 
-Use this tab to practice basic `print`, variables, and simple input/output.
-You can modify the starter code below or paste your own.
+**You’ll practice:**
+- Using `print()` and variables
+- Reading user input with `input()`
+- Building a tiny interactive console app
+
+**Mini-project idea:**  
+Create a **“Profile Card”** script that asks for your name, age, and hobby, then prints a nicely formatted profile.
 """,
         "starter_code": '''# Lesson 1: Simple Hello & Input
 
@@ -58,8 +63,11 @@ age = input("How old are you? ")
 print(f"Hello, {name}! You are {age} years old.")
 
 # Try:
-# 1. Add two numbers entered by the user.
-# 2. Print a message that includes that sum.
+# 1. Ask for a favorite color and food and add them to the message.
+# 2. Create a small "profile card" printed with multiple lines, e.g.:
+#    Name: ...
+#    Age: ...
+#    Favorite color: ...
 '''
     },
     {
@@ -71,8 +79,13 @@ print(f"Hello, {name}! You are {age} years old.")
 - Topic A: Process Strings and Integers  
 - Topic B: Process Decimals, Floats, and Mixed Number Types  
 
-Practice working with strings, integers, and floats.
-Try changing the values and adding your own calculations.
+**You’ll practice:**
+- Combining strings
+- Doing arithmetic with integers and floats
+- Using `round()` and basic numeric conversions
+
+**Mini-project idea:**  
+Create a **BMI & Health Stats** script that asks for height, weight, and age, calculates BMI, and prints a short health summary.
 """,
         "starter_code": '''# Lesson 2: Strings, Integers, Floats
 
@@ -93,8 +106,10 @@ print("BMI (unrounded):", bmi)
 print("BMI (rounded to 2 decimals):", round(bmi, 2))
 
 # Try:
-# 1. Ask the user for their name and birth year and compute their age.
-# 2. Convert a temperature from Fahrenheit to Celsius.
+# 1. Ask the user for their name and birth year; compute their age.
+# 2. Convert a temperature from Fahrenheit to Celsius:
+#       celsius = (f - 32) * 5/9
+# 3. Ask for two prices and print the subtotal, tax, and total.
 '''
     },
     {
@@ -106,7 +121,13 @@ print("BMI (rounded to 2 decimals):", round(bmi, 2))
 - Topic A: Process Ordered Data Structures (lists, tuples)  
 - Topic B: Process Unordered Data Structures (sets, dictionaries)  
 
-Use this tab to experiment with lists, tuples, sets, and dictionaries.
+**You’ll practice:**
+- Storing groups of values in lists and tuples
+- Using sets to deduplicate data
+- Using dictionaries to store labeled data
+
+**Mini-project idea:**  
+Build a tiny **“Student Gradebook”** using a dictionary of names and scores. Compute averages and print a report.
 """,
         "starter_code": '''# Lesson 3: Lists, Tuples, Sets, Dictionaries
 
@@ -136,13 +157,15 @@ student = {
 
 print("Student name:", student["name"])
 
-print("\\nAll student key/value pairs:")
+print("\nAll student key/value pairs:")
 for key, value in student.items():
     print(f"{key}: {value}")
 
 # Try:
-# 1. Add a new key "major" to the student dictionary.
+# 1. Add a new key "major" to the student dictionary, then print it.
 # 2. Create a list of 5 movies and print the first and last.
+# 3. Create a "gradebook" dict: student_name -> list of scores,
+#    then print each student's average.
 '''
     },
     {
@@ -154,7 +177,13 @@ for key, value in student.items():
 - Topic A: Write a Conditional Statement (`if`, `elif`, `else`)  
 - Topic B: Write a Loop (`for`, `while`)  
 
-Use this tab to build branching logic and repeated actions.
+**You’ll practice:**
+- Making decisions in code
+- Repeating actions until some condition is met
+- Combining `if` with loops for basic logic
+
+**Mini-project idea:**  
+Create a **“Number Guessing Game”** that picks a random number and gives the user several attempts with hints (too high / too low).
 """,
         "starter_code": '''# Lesson 4: Conditionals & Loops
 
@@ -177,7 +206,7 @@ else:
 print(f"Your grade is: {grade}")
 
 # Loop example: print even numbers 2-20
-print("\\nEven numbers from 2 to 20:")
+print("\nEven numbers from 2 to 20:")
 for n in range(2, 21, 2):
     print(n, end=" ")
 
@@ -186,6 +215,8 @@ print()  # newline
 # Try:
 # 1. Use a while loop to ask for a password until it is 'secret'.
 # 2. Write an if/elif/else to classify a number as positive, negative, or zero.
+# 3. (Challenge) Make a number guessing game (1-20) that tells the user if
+#    their guess is too high or too low.
 '''
     },
     {
@@ -198,7 +229,13 @@ print()  # newline
 - Topic B: Define and Instantiate a Class  
 - Topic C: Import and Use a Module  
 
-Use this tab to practice writing functions, basic classes, and using modules.
+**You’ll practice:**
+- Creating functions with parameters and return values
+- Creating simple classes with attributes and methods
+- Using built-in modules like `math`, `random`
+
+**Mini-project idea:**  
+Create a **“Banking Simulator”** with a `BankAccount` class that supports deposit, withdraw, and showing balance.
 """,
         "starter_code": '''# Lesson 5: Functions, Classes, and Modules
 
@@ -239,7 +276,9 @@ print("Random integer from 1 to 6:", random.randint(1, 6))
 
 # Try:
 # 1. Write a function is_even(n) that returns True if n is even.
-# 2. Create a BankAccount class with deposit and withdraw methods.
+# 2. Create a BankAccount class with deposit and withdraw methods,
+#    and test it with a few transactions.
+# 3. Use random.randint to simulate rolling two dice and print their sum.
 '''
     },
     {
@@ -253,8 +292,16 @@ print("Random integer from 1 to 6:", random.randint(1, 6))
 - Topic C: Get the Contents of a Directory  
 - Topic D: Manage Files and Directories  
 
-⚠️ For safety: in a hosted environment, file access is temporary and sandboxed.
-Use this to learn the basics of reading and writing files.
+⚠️ In a hosted environment, file access is temporary and sandboxed,
+but the patterns you learn here transfer directly to your local machine.
+
+**You’ll practice:**
+- Creating directories and files
+- Reading and writing text data
+- Listing directory contents
+
+**Mini-project idea:**  
+Create a simple **“Log Writer”** that appends timestamped messages to a log file, then reads and prints the last N lines.
 """,
         "starter_code": '''# Lesson 6: Files & Directories
 
@@ -285,6 +332,7 @@ for item in folder.iterdir():
 # Try:
 # 1. Add another file with different text.
 # 2. Read both files and print their contents.
+# 3. Add a timestamp to each line you write into a 'log.txt' file.
 '''
     },
     {
@@ -296,7 +344,16 @@ for item in folder.iterdir():
 - Topic A: Handle Exceptions  
 - Topic B: Raise Exceptions  
 
-Use this tab to practice `try/except` and raising your own exceptions.
+**You’ll practice:**
+- Wrapping risky code in `try/except`
+- Catching specific errors like `ValueError` and `ZeroDivisionError`
+- Raising your own exceptions when inputs are invalid
+
+**Mini-project idea:**  
+Create a **“Safe Calculator”** that:
+- Accepts user input for operations
+- Handles invalid inputs gracefully
+- Prevents divide-by-zero errors
 """,
         "starter_code": '''# Lesson 7: Exceptions
 
@@ -329,12 +386,14 @@ except ValueError as e:
 
 # Try:
 # 1. Wrap more user input in try/except to catch ValueError.
-# 2. Write a function that raises ValueError if a discount is not between 0 and 100.
+# 2. Write a function that raises ValueError if a discount is
+#    not between 0 and 100.
+# 3. Build a small "safe calculator" that handles bad input gracefully.
 '''
     },
 ]
 
-appendix_markdown = r"""
+appendix_markdown = """
 ## 📎 References & Appendices
 
 This tab consolidates extra reference material for the course.
@@ -387,11 +446,12 @@ Follow these conventions to keep your code clean and readable:
 
 **Comments & Docstrings**
 - Use `#` for short explanations above a line or block.  
-- Use triple-quoted strings `"""Docs here"""` for functions, classes, and modules.
+- Use triple-quoted strings for docstrings, for example:
+  `\"\"\"This is a multi-line docstring.\"\"\"`.
 
 **Structure**
 - Break large scripts into functions and classes.  
-- For larger programs, use
+- For larger programs, use:
 
 ```python
 if __name__ == "__main__":