Capstone Project: Interactive CLI Quiz Application0%

Capstone Project: Interactive CLI Quiz Application

Beginner16 min read•Updated: 2026-09-30

Capstone Project: Interactive CLI Quiz Application

Interactive testing and automated assessment engines are among the most ubiquitous real-world software applications—from university entrance portals to edtech learning platforms.

In this capstone project, you will combine lists, dictionaries, functions, control loops, and file persistence to build an interactive, production-ready CLI Quiz Application equipped with score tracking, conceptual explanations, and a persistent top-score leaderboard.

Real-World Analogy: The KBC Hotseat Engine

Imagine the computer system behind India's famous quiz show Kaun Banega Crorepati (KBC):

Visual Architecture Blueprint

+-------------------------------------------------------------------------+
|                  KAUN BANEGA CROREPATI (KBC) QUIZ ENGINE                |
+-------------------------------------------------------------------------+
|                                                                         |
|   1. Question Bank (RAM/File) ──> Shuffled randomly for each contestant |
|                                                                         |
|   2. Computer Screen Display  ──> Formats Question + Options (A, B, C, D)|
|                                                                         |
|   3. Contestant Input Buffer  ──> Validates input: strictly 'A'-'D' or 'Q'|
|                                                                         |
|   4. Evaluation Engine        ──> "Sahi Jawab!" or "Galat Jawab!"       |
|                               ──> Explains why correct & updates score  |
|                                                                         |
|   5. Leaderboard Storage      ──> Appends Name, Score, Accuracy to      |
|                                   'leaderboard.txt' via with open(...)  |
|                                                                         |
+-------------------------------------------------------------------------+

Every question is a structured dictionary, each response is sanitized against invalid inputs, and final scores are preserved on disk so winners are remembered across game sessions.

Project Specification & Architecture

Our Quiz Application consists of 4 decoupled components:

1
Question Bank: A list of dictionaries containing questions, 4 structured choices, the correct answer key ("A", "B", "C", or "D"), and a brief conceptual explanation.
2
Game Engine:

Shuffles questions to give each player a fresh randomized attempt.
Prompts the user with robust input validation.
Tracks correct answers, incorrect answers, and cumulative score.

1
Assessment Reporter:

Calculates score percentage, accuracy rating, and qualitative grade (e.g., Distinction, Pass, Needs Improvement).

1
Leaderboard File Persistence:

Appends player scores with timestamps to quiz_leaderboard.txt.
Reads and ranks top scores in descending order.

Complete Production-Grade Implementation

Here is the modular, fully runnable Quiz Application script:

1"""
2MSK Python Capstone: Interactive CLI Quiz Application with Leaderboard
3Author: MSK Institute
4"""
5import os
6import random
7from datetime import datetime
8 
9LEADERBOARD_FILE = "quiz_leaderboard.txt"
10 
11# --- 1. Structured Question Bank ---
12QUESTION_BANK = [
  {
      "id": 1,
      "question": "Which keyword is used to define an asynchronous or standard function in Python?",
      "options": {
          "A": "func",
          "B": "def",
          "C": "function",
          "D": "define"
      },
      "answer": "B",
      "explanation": "Python uses the 'def' keyword (short for define) to declare functions."
  },
  {
      "id": 2,
      "question": "Which built-in Python data structure is ordered, indexed, and immutable?",
      "options": {
          "A": "List",
          "B": "Dictionary",
          "C": "Tuple",
          "D": "Set"
      },
      "answer": "C",
      "explanation": "Tuples are immutable sequences enclosed in parentheses; their contents cannot be changed after creation."
  },
  {
      "id": 3,
      "question": "What is the primary advantage of the 'with open(...) as f:' context manager?",
      "options": {
          "A": "It converts files to JSON automatically",
          "B": "It guarantees automatic file closure even on uncaught errors",
          "C": "It speeds up network downloads",
          "D": "It bypasses operating system security permissions"
      },
      "answer": "B",
      "explanation": "The context manager protocol ensures __exit__() is invoked, automatically closing files upon block termination."
  },
  {
      "id": 4,
      "question": "What does the dictionary method dict.get('key', 'default') return if 'key' is absent?",
      "options": {
          "A": "Raises KeyError",
          "B": "Returns None always",
          "C": "Returns 'default' without crashing",
          "D": "Deletes the dictionary"
      },
      "answer": "C",
      "explanation": "The .get() method provides safe fallback access, returning the supplied default value instead of raising KeyError."
  },
  {
      "id": 5,
      "question": "What is the output of bool([]) in Python?",
      "options": {
          "A": "True",
          "B": "False",
          "C": "None",
          "D": "Error"
      },
      "answer": "B",
      "explanation": "In Python, empty sequences (empty lists, empty strings, empty tuples) evaluate to False in boolean context."
  }
73]
74 
75# --- 2. Leaderboard Storage Engine ---
76def save_score(player_name: str, score: int, total: int) -> None:
  """Appends a new score entry to the persistent leaderboard file."""
  timestamp = datetime.now().strftime("%Y-%m-%d %H:%M")
  percentage = (score / total) * 100
  with open(LEADERBOARD_FILE, "a", encoding="utf-8") as f:
      f.write(f"{player_name}|{score}|{total}|{percentage:.1f}%|{timestamp}\n")
82 
83def display_leaderboard() -> None:
  """Reads and displays the top scores in descending order."""
  if not os.path.exists(LEADERBOARD_FILE):
      print("\n[INFO] No leaderboard records found yet.")
      return
88 
  entries = []
  with open(LEADERBOARD_FILE, "r", encoding="utf-8") as f:
      for line in f:
          line = line.strip()
          if line:
              parts = line.split("|")
              if len(parts) == 5:
                  name, score, total, pct, time_str = parts
                  entries.append((name, int(score), int(total), pct, time_str))
98 
  # Sort entries by score descending
  entries.sort(key=lambda x: x[1], reverse=True)
101 
  print("\n" + "="*65)
  print(f"{'RANK':<5} | {'PLAYER':<18} | {'SCORE':<8} | {'ACCURACY':<10} | {'DATE'}")
  print("="*65)
  for rank, (name, sc, tot, pct, dt) in enumerate(entries[:5], start=1):
      print(f"{rank:<5} | {name:<18} | {sc}/{tot:<6} | {pct:<10} | {dt}")
  print("="*65 + "\n")
108 
109# --- 3. Core Quiz Execution Engine ---
110def run_quiz(player_name: str, questions: list, simulated_inputs: list = None) -> int:
  """Runs an interactive or simulated quiz session."""
  shuffled_questions = random.sample(questions, len(questions))
  score = 0
  total = len(shuffled_questions)
115 
  print("\n" + "#"*60)
  print(f"  WELCOME TO THE MSK PYTHON CHALLENGE, {player_name.upper()}!")
  print(f"  Total Questions: {total} | 1 Mark Per Correct Answer")
  print("#"*60 + "\n")
120 
  input_index = 0
  for idx, item in enumerate(shuffled_questions, start=1):
      print(f"\nQuestion {idx} of {total}:")
      print(f"  {item['question']}")
      for opt_key, opt_text in item["options"].items():
          print(f"    [{opt_key}] {opt_text}")
127 
      # Handle simulated input for automated test runs or live input()
      while True:
          if simulated_inputs is not None and input_index < len(simulated_inputs):
              user_choice = simulated_inputs[input_index]
              input_index += 1
              print(f"  Contestant chose: {user_choice}")
          else:
              user_choice = input("  Your choice (A/B/C/D): ").strip().upper()
136 
          if user_choice in ["A", "B", "C", "D"]:
              break
          print("  [!] Invalid choice! Please select strictly A, B, C, or D.")
140 
      # Evaluate Answer
      if user_choice == item["answer"]:
          print("  [CORRECT!] Sahi Jawab! (+1 Mark)")
          score += 1
      else:
          print(f"  [WRONG!] Correct answer was: [{item['answer']}] {item['options'][item['answer']]}")
      
      print(f"  Insight: {item['explanation']}")
149 
  # Final Score Card
  percentage = (score / total) * 100
  print("\n" + "="*50)
  print(f"           FINAL SCORE CARD: {player_name.upper()}")
  print("="*50)
  print(f"  Total Questions : {total}")
  print(f"  Correct Answers : {score}")
  print(f"  Accuracy        : {percentage:.1f}%")
  
  if percentage >= 80:
      grade = "Distinction (Python Champion!)"
  elif percentage >= 60:
      grade = "First Class (Solid Foundations)"
  elif percentage >= 40:
      grade = "Pass (Keep Practicing)"
  else:
      grade = "Needs Improvement (Review Chapters)"
  print(f"  Grade           : {grade}")
  print("="*50)
169 
  # Persist to disk
  save_score(player_name, score, total)
  return score
173 
174# --- 4. Automated Demonstration & Verification ---
175if __name__ == "__main__":
  # Clean up any past leaderboard file for a clean test run
  if os.path.exists(LEADERBOARD_FILE):
      os.remove(LEADERBOARD_FILE)
179 
  # Fix random seed for predictable verification output
  random.seed(42)
182 
  # Simulated Player 1: Arjun (Answers 4 correctly)
  simulated_answers_arjun = ["B", "C", "B", "C", "A"] # Last one is wrong
  run_quiz("Arjun Mehta", QUESTION_BANK, simulated_inputs=simulated_answers_arjun)
186 
  # Simulated Player 2: Divya (Perfect 5/5 score)
  simulated_answers_divya = ["B", "C", "B", "C", "B"]
  # Re-seed to ensure same question order
  random.seed(42)
  run_quiz("Divya Nair", QUESTION_BANK, simulated_inputs=simulated_answers_divya)
192 
  # Display Persistent Leaderboard
  display_leaderboard()

Expected Output

1############################################################
WELCOME TO THE MSK PYTHON CHALLENGE, ARJUN MEHTA!
Total Questions: 5 | 1 Mark Per Correct Answer
4############################################################
5 
6Question 1 of 5:
Which keyword is used to define an asynchronous or standard function in Python?
  [A] func
  [B] def
  [C] function
  [D] define
Contestant chose: B
[CORRECT!] Sahi Jawab! (+1 Mark)
Insight: Python uses the 'def' keyword (short for define) to declare functions.
15 
16Question 2 of 5:
Which built-in Python data structure is ordered, indexed, and immutable?
  [A] List
  [B] Dictionary
  [C] Tuple
  [D] Set
Contestant chose: C
[CORRECT!] Sahi Jawab! (+1 Mark)
Insight: Tuples are immutable sequences enclosed in parentheses; their contents cannot be changed after creation.
25 
26Question 3 of 5:
What is the primary advantage of the 'with open(...) as f:' context manager?
  [A] It converts files to JSON automatically
  [B] It guarantees automatic file closure even on uncaught errors
  [C] It speeds up network downloads
  [D] It bypasses operating system security permissions
Contestant chose: B
[CORRECT!] Sahi Jawab! (+1 Mark)
Insight: The context manager protocol ensures __exit__() is invoked, automatically closing files upon block termination.
35 
36Question 4 of 5:
What does the dictionary method dict.get('key', 'default') return if 'key' is absent?
  [A] Raises KeyError
  [B] Returns None always
  [C] Returns 'default' without crashing
  [D] Deletes the dictionary
Contestant chose: C
[CORRECT!] Sahi Jawab! (+1 Mark)
Insight: The .get() method provides safe fallback access, returning the supplied default value instead of raising KeyError.
45 
46Question 5 of 5:
What is the output of bool([]) in Python?
  [A] True
  [B] False
  [C] None
  [D] Error
Contestant chose: A
[WRONG!] Correct answer was: [B] False
Insight: In Python, empty sequences (empty lists, empty strings, empty tuples) evaluate to False in boolean context.
55 
56==================================================
         FINAL SCORE CARD: ARJUN MEHTA
58==================================================
Total Questions : 5
Correct Answers : 4
Accuracy        : 80.0%
Grade           : Distinction (Python Champion!)
63==================================================
64 
65=================================================================
66RANK  | PLAYER             | SCORE    | ACCURACY   | DATE
67=================================================================
   | Divya Nair         | 5/5      | 100.0%     | 2026-09-12 14:52
   | Arjun Mehta        | 4/5      | 80.0%      | 2026-09-12 14:52
70=================================================================

Best Practices & Comparison: Do's and Don'ts

Practice	Bad Implementation	Gold-Standard Implementation
Question Storage	Hardcoding `if question == 1:` cascades	Structured data structures (list of dictionaries)
Input Validation	Assuming input is always valid	Strict `while True` loop validating `'A'` through `'D'`
Question Order	Presenting static questions in identical order	Shuffle questions with `random.sample()` for fairness
Leaderboard Sync	Overwriting file on every play	Append mode (`"a"`) preserving historic competition data
Feedback	Only showing final score at the very end	Immediate question-by-question feedback and insights
Score Sorting	Printing entries in raw chronological order	Sort descending by score using `entries.sort(key=...)`

Quick Revision Summary Cheat Sheet

Data Modeling: Model complex entities (quizzes, products, transactions) as lists of dictionaries for modular iteration.
Randomization: Use random.sample(seq, len(seq)) to create a non-destructive shuffled copy of a sequence.
Input Sanitization: Combine .strip().upper() to gracefully accept " a ", "A", or "a".
Append Mode ('a'): Ideal for logging events, audit trails, and leaderboard score archives without truncating prior history.
Custom Sorting: Use list.sort(key=lambda item: item[1], reverse=True) to order multi-column tuples or dictionaries.

⚠️ Production Development Best Practices & Common Traps

1
Always Validate User Input: Never trust raw user inputs. Wrap numeric casts with try...except ValueError to prevent sudden crashes.
2
Defensive File Loading: Always check whether a storage file exists or catch FileNotFoundError when initializing terminal databases.
3
Modular Function Design: Keep functions focused on a single responsibility (e.g. load_data(), save_data(), display_menu(), add_record()).

Interactive Quiz• Knowledge Check

Practice Quiz

Question 1

What does random.sample(population, k) return when shuffling questions?

Question 2

Why is file append mode ('a') chosen over write mode ('w') for the leaderboard?

Question 3

What is the benefit of organizing question options into a dictionary {'A': ..., 'B': ...} instead of a raw list?

Question 4

What does the expression user_input.strip().upper() achieve?

Question 5

In entries.sort(key=lambda x: x[1], reverse=True), what does reverse=True signify?

Practice Challenge

Scenario: The 50-50 Lifeline Feature

In TV quiz shows, contestants can trigger a 50-50 Lifeline that removes two incorrect choices, leaving only the correct answer and one randomly chosen wrong answer.

Add a 50-50 Lifeline feature to the Quiz Application:

1
Create a function use_fifty_fifty(question_item):

Identifies the correct option key.
Gathers all 3 incorrect keys.
Randomly chooses 1 incorrect key to keep.
Returns a reduced dictionary containing only the correct option and the 1 surviving wrong option.

1
Demonstrate calling use_fifty_fifty on a sample question and verifying that exactly 2 options remain.

Starter Code

1import random
2 
3sample_q = {
4    "question": "Which keyword defines an anonymous inline function in Python?",
5    "options": {
6        "A": "def",
7        "B": "inline",
8        "C": "lambda",
9        "D": "func"
10    },
11    "answer": "C",
12    "explanation": "The lambda keyword creates small anonymous functions."
13}
14 
15# TODO: Implement use_fifty_fifty(q) that returns a dict with 2 options (the answer + 1 wrong)

Complete Solution

1import random
2 
3sample_q = {
4    "question": "Which keyword defines an anonymous inline function in Python?",
5    "options": {
6        "A": "def",
7        "B": "inline",
8        "C": "lambda",
9        "D": "func"
10    },
11    "answer": "C",
12    "explanation": "The lambda keyword creates small anonymous functions."
13}
14 
15def use_fifty_fifty(q: dict) -> dict:
16    correct_key = q["answer"]
17    wrong_keys = [k for k in q["options"].keys() if k != correct_key]
18    
19    # Pick one wrong key to keep
20    surviving_wrong = random.choice(wrong_keys)
21    
22    # Return filtered options containing only correct and surviving wrong
23    active_keys = sorted([correct_key, surviving_wrong])
24    filtered_options = {k: q["options"][k] for k in active_keys}
25    return filtered_options
26 
27# Test Lifeline
28print(f"Original Options: {sample_q['options']}")
29lifeline_options = use_fifty_fifty(sample_q)
30print(f"\nAfter 50-50 Lifeline:")
31for k, v in lifeline_options.items():
32    print(f"  [{k}] {v}")
33 
34assert len(lifeline_options) == 2
35assert sample_q["answer"] in lifeline_options
36print("\n[SUCCESS] 50-50 Lifeline validated successfully!")

Expected Output

1Original Options: {'A': 'def', 'B': 'inline', 'C': 'lambda', 'D': 'func'}
2 
3After 50-50 Lifeline:
4  [A] def
5  [C] lambda
6 
7[SUCCESS] 50-50 Lifeline validated successfully!

🚀 What's Next?

In the next lesson, we will continue your Python learning journey with Expense Tracker (16: Projects).

👉 Continue to Next Lesson: Expense Tracker →

Next Lesson

Expense Tracker

Continue learning with hands-on practice, examples, and exercises in the upcoming topic.

Related Lessons

Previous Lesson	Next Lesson
Contact Book	Expense Tracker

Practice Quiz

Test your understanding of this lesson with 5 questions. Each question has one correct answer.

Previous Next

PreviousPrevNext

MSK Institute • Shikohabad

Loading Page Content...

Preparing courses, live labs, and learning resources.सामग्री लोड हो रही है, कृपया प्रतीक्षा करें...

Connecting serverPlease wait...

💻 Practical Labs🚀 Free Demo📜 Verified Certificates

Expense Tracker

Capstone Project: Interactive CLI Quiz Application

Beginner16 min read•Updated: 2026-09-30

Study Materials Cheatsheet

Capstone Project: Interactive CLI Quiz Application

Interactive testing and automated assessment engines are among the most ubiquitous real-world software applications—from university entrance portals to edtech learning platforms.

Real-World Analogy: The KBC Hotseat Engine

Imagine the computer system behind India's famous quiz show Kaun Banega Crorepati (KBC):

Visual Architecture Blueprint

+-------------------------------------------------------------------------+
|                  KAUN BANEGA CROREPATI (KBC) QUIZ ENGINE                |
+-------------------------------------------------------------------------+
|                                                                         |
|   1. Question Bank (RAM/File) ──> Shuffled randomly for each contestant |
|                                                                         |
|   2. Computer Screen Display  ──> Formats Question + Options (A, B, C, D)|
|                                                                         |
|   3. Contestant Input Buffer  ──> Validates input: strictly 'A'-'D' or 'Q'|
|                                                                         |
|   4. Evaluation Engine        ──> "Sahi Jawab!" or "Galat Jawab!"       |
|                               ──> Explains why correct & updates score  |
|                                                                         |
|   5. Leaderboard Storage      ──> Appends Name, Score, Accuracy to      |
|                                   'leaderboard.txt' via with open(...)  |
|                                                                         |
+-------------------------------------------------------------------------+

Every question is a structured dictionary, each response is sanitized against invalid inputs, and final scores are preserved on disk so winners are remembered across game sessions.

Project Specification & Architecture

Our Quiz Application consists of 4 decoupled components:

1
Question Bank: A list of dictionaries containing questions, 4 structured choices, the correct answer key ("A", "B", "C", or "D"), and a brief conceptual explanation.
2
Game Engine:

Shuffles questions to give each player a fresh randomized attempt.
Prompts the user with robust input validation.
Tracks correct answers, incorrect answers, and cumulative score.

1
Assessment Reporter:

Calculates score percentage, accuracy rating, and qualitative grade (e.g., Distinction, Pass, Needs Improvement).

1
Leaderboard File Persistence:

Appends player scores with timestamps to quiz_leaderboard.txt.
Reads and ranks top scores in descending order.

Complete Production-Grade Implementation

Here is the modular, fully runnable Quiz Application script:

1"""
2MSK Python Capstone: Interactive CLI Quiz Application with Leaderboard
3Author: MSK Institute
4"""
5import os
6import random
7from datetime import datetime
8 
9LEADERBOARD_FILE = "quiz_leaderboard.txt"
10 
11# --- 1. Structured Question Bank ---
12QUESTION_BANK = [
  {
      "id": 1,
      "question": "Which keyword is used to define an asynchronous or standard function in Python?",
      "options": {
          "A": "func",
          "B": "def",
          "C": "function",
          "D": "define"
      },
      "answer": "B",
      "explanation": "Python uses the 'def' keyword (short for define) to declare functions."
  },
  {
      "id": 2,
      "question": "Which built-in Python data structure is ordered, indexed, and immutable?",
      "options": {
          "A": "List",
          "B": "Dictionary",
          "C": "Tuple",
          "D": "Set"
      },
      "answer": "C",
      "explanation": "Tuples are immutable sequences enclosed in parentheses; their contents cannot be changed after creation."
  },
  {
      "id": 3,
      "question": "What is the primary advantage of the 'with open(...) as f:' context manager?",
      "options": {
          "A": "It converts files to JSON automatically",
          "B": "It guarantees automatic file closure even on uncaught errors",
          "C": "It speeds up network downloads",
          "D": "It bypasses operating system security permissions"
      },
      "answer": "B",
      "explanation": "The context manager protocol ensures __exit__() is invoked, automatically closing files upon block termination."
  },
  {
      "id": 4,
      "question": "What does the dictionary method dict.get('key', 'default') return if 'key' is absent?",
      "options": {
          "A": "Raises KeyError",
          "B": "Returns None always",
          "C": "Returns 'default' without crashing",
          "D": "Deletes the dictionary"
      },
      "answer": "C",
      "explanation": "The .get() method provides safe fallback access, returning the supplied default value instead of raising KeyError."
  },
  {
      "id": 5,
      "question": "What is the output of bool([]) in Python?",
      "options": {
          "A": "True",
          "B": "False",
          "C": "None",
          "D": "Error"
      },
      "answer": "B",
      "explanation": "In Python, empty sequences (empty lists, empty strings, empty tuples) evaluate to False in boolean context."
  }
73]
74 
75# --- 2. Leaderboard Storage Engine ---
76def save_score(player_name: str, score: int, total: int) -> None:
  """Appends a new score entry to the persistent leaderboard file."""
  timestamp = datetime.now().strftime("%Y-%m-%d %H:%M")
  percentage = (score / total) * 100
  with open(LEADERBOARD_FILE, "a", encoding="utf-8") as f:
      f.write(f"{player_name}|{score}|{total}|{percentage:.1f}%|{timestamp}\n")
82 
83def display_leaderboard() -> None:
  """Reads and displays the top scores in descending order."""
  if not os.path.exists(LEADERBOARD_FILE):
      print("\n[INFO] No leaderboard records found yet.")
      return
88 
  entries = []
  with open(LEADERBOARD_FILE, "r", encoding="utf-8") as f:
      for line in f:
          line = line.strip()
          if line:
              parts = line.split("|")
              if len(parts) == 5:
                  name, score, total, pct, time_str = parts
                  entries.append((name, int(score), int(total), pct, time_str))
98 
  # Sort entries by score descending
  entries.sort(key=lambda x: x[1], reverse=True)
101 
  print("\n" + "="*65)
  print(f"{'RANK':<5} | {'PLAYER':<18} | {'SCORE':<8} | {'ACCURACY':<10} | {'DATE'}")
  print("="*65)
  for rank, (name, sc, tot, pct, dt) in enumerate(entries[:5], start=1):
      print(f"{rank:<5} | {name:<18} | {sc}/{tot:<6} | {pct:<10} | {dt}")
  print("="*65 + "\n")
108 
109# --- 3. Core Quiz Execution Engine ---
110def run_quiz(player_name: str, questions: list, simulated_inputs: list = None) -> int:
  """Runs an interactive or simulated quiz session."""
  shuffled_questions = random.sample(questions, len(questions))
  score = 0
  total = len(shuffled_questions)
115 
  print("\n" + "#"*60)
  print(f"  WELCOME TO THE MSK PYTHON CHALLENGE, {player_name.upper()}!")
  print(f"  Total Questions: {total} | 1 Mark Per Correct Answer")
  print("#"*60 + "\n")
120 
  input_index = 0
  for idx, item in enumerate(shuffled_questions, start=1):
      print(f"\nQuestion {idx} of {total}:")
      print(f"  {item['question']}")
      for opt_key, opt_text in item["options"].items():
          print(f"    [{opt_key}] {opt_text}")
127 
      # Handle simulated input for automated test runs or live input()
      while True:
          if simulated_inputs is not None and input_index < len(simulated_inputs):
              user_choice = simulated_inputs[input_index]
              input_index += 1
              print(f"  Contestant chose: {user_choice}")
          else:
              user_choice = input("  Your choice (A/B/C/D): ").strip().upper()
136 
          if user_choice in ["A", "B", "C", "D"]:
              break
          print("  [!] Invalid choice! Please select strictly A, B, C, or D.")
140 
      # Evaluate Answer
      if user_choice == item["answer"]:
          print("  [CORRECT!] Sahi Jawab! (+1 Mark)")
          score += 1
      else:
          print(f"  [WRONG!] Correct answer was: [{item['answer']}] {item['options'][item['answer']]}")
      
      print(f"  Insight: {item['explanation']}")
149 
  # Final Score Card
  percentage = (score / total) * 100
  print("\n" + "="*50)
  print(f"           FINAL SCORE CARD: {player_name.upper()}")
  print("="*50)
  print(f"  Total Questions : {total}")
  print(f"  Correct Answers : {score}")
  print(f"  Accuracy        : {percentage:.1f}%")
  
  if percentage >= 80:
      grade = "Distinction (Python Champion!)"
  elif percentage >= 60:
      grade = "First Class (Solid Foundations)"
  elif percentage >= 40:
      grade = "Pass (Keep Practicing)"
  else:
      grade = "Needs Improvement (Review Chapters)"
  print(f"  Grade           : {grade}")
  print("="*50)
169 
  # Persist to disk
  save_score(player_name, score, total)
  return score
173 
174# --- 4. Automated Demonstration & Verification ---
175if __name__ == "__main__":
  # Clean up any past leaderboard file for a clean test run
  if os.path.exists(LEADERBOARD_FILE):
      os.remove(LEADERBOARD_FILE)
179 
  # Fix random seed for predictable verification output
  random.seed(42)
182 
  # Simulated Player 1: Arjun (Answers 4 correctly)
  simulated_answers_arjun = ["B", "C", "B", "C", "A"] # Last one is wrong
  run_quiz("Arjun Mehta", QUESTION_BANK, simulated_inputs=simulated_answers_arjun)
186 
  # Simulated Player 2: Divya (Perfect 5/5 score)
  simulated_answers_divya = ["B", "C", "B", "C", "B"]
  # Re-seed to ensure same question order
  random.seed(42)
  run_quiz("Divya Nair", QUESTION_BANK, simulated_inputs=simulated_answers_divya)
192 
  # Display Persistent Leaderboard
  display_leaderboard()

Expected Output

1############################################################
WELCOME TO THE MSK PYTHON CHALLENGE, ARJUN MEHTA!
Total Questions: 5 | 1 Mark Per Correct Answer
4############################################################
5 
6Question 1 of 5:
Which keyword is used to define an asynchronous or standard function in Python?
  [A] func
  [B] def
  [C] function
  [D] define
Contestant chose: B
[CORRECT!] Sahi Jawab! (+1 Mark)
Insight: Python uses the 'def' keyword (short for define) to declare functions.
15 
16Question 2 of 5:
Which built-in Python data structure is ordered, indexed, and immutable?
  [A] List
  [B] Dictionary
  [C] Tuple
  [D] Set
Contestant chose: C
[CORRECT!] Sahi Jawab! (+1 Mark)
Insight: Tuples are immutable sequences enclosed in parentheses; their contents cannot be changed after creation.
25 
26Question 3 of 5:
What is the primary advantage of the 'with open(...) as f:' context manager?
  [A] It converts files to JSON automatically
  [B] It guarantees automatic file closure even on uncaught errors
  [C] It speeds up network downloads
  [D] It bypasses operating system security permissions
Contestant chose: B
[CORRECT!] Sahi Jawab! (+1 Mark)
Insight: The context manager protocol ensures __exit__() is invoked, automatically closing files upon block termination.
35 
36Question 4 of 5:
What does the dictionary method dict.get('key', 'default') return if 'key' is absent?
  [A] Raises KeyError
  [B] Returns None always
  [C] Returns 'default' without crashing
  [D] Deletes the dictionary
Contestant chose: C
[CORRECT!] Sahi Jawab! (+1 Mark)
Insight: The .get() method provides safe fallback access, returning the supplied default value instead of raising KeyError.
45 
46Question 5 of 5:
What is the output of bool([]) in Python?
  [A] True
  [B] False
  [C] None
  [D] Error
Contestant chose: A
[WRONG!] Correct answer was: [B] False
Insight: In Python, empty sequences (empty lists, empty strings, empty tuples) evaluate to False in boolean context.
55 
56==================================================
         FINAL SCORE CARD: ARJUN MEHTA
58==================================================
Total Questions : 5
Correct Answers : 4
Accuracy        : 80.0%
Grade           : Distinction (Python Champion!)
63==================================================
64 
65=================================================================
66RANK  | PLAYER             | SCORE    | ACCURACY   | DATE
67=================================================================
   | Divya Nair         | 5/5      | 100.0%     | 2026-09-12 14:52
   | Arjun Mehta        | 4/5      | 80.0%      | 2026-09-12 14:52
70=================================================================

Best Practices & Comparison: Do's and Don'ts

Practice	Bad Implementation	Gold-Standard Implementation
Question Storage	Hardcoding `if question == 1:` cascades	Structured data structures (list of dictionaries)
Input Validation	Assuming input is always valid	Strict `while True` loop validating `'A'` through `'D'`
Question Order	Presenting static questions in identical order	Shuffle questions with `random.sample()` for fairness
Leaderboard Sync	Overwriting file on every play	Append mode (`"a"`) preserving historic competition data
Feedback	Only showing final score at the very end	Immediate question-by-question feedback and insights
Score Sorting	Printing entries in raw chronological order	Sort descending by score using `entries.sort(key=...)`

Quick Revision Summary Cheat Sheet

Data Modeling: Model complex entities (quizzes, products, transactions) as lists of dictionaries for modular iteration.
Randomization: Use random.sample(seq, len(seq)) to create a non-destructive shuffled copy of a sequence.
Input Sanitization: Combine .strip().upper() to gracefully accept " a ", "A", or "a".
Append Mode ('a'): Ideal for logging events, audit trails, and leaderboard score archives without truncating prior history.
Custom Sorting: Use list.sort(key=lambda item: item[1], reverse=True) to order multi-column tuples or dictionaries.

⚠️ Production Development Best Practices & Common Traps

1
Always Validate User Input: Never trust raw user inputs. Wrap numeric casts with try...except ValueError to prevent sudden crashes.
2
Defensive File Loading: Always check whether a storage file exists or catch FileNotFoundError when initializing terminal databases.
3
Modular Function Design: Keep functions focused on a single responsibility (e.g. load_data(), save_data(), display_menu(), add_record()).

Interactive Quiz• Knowledge Check

Practice Quiz

Question 1

What does random.sample(population, k) return when shuffling questions?

Question 2

Why is file append mode ('a') chosen over write mode ('w') for the leaderboard?

Question 3

What is the benefit of organizing question options into a dictionary {'A': ..., 'B': ...} instead of a raw list?

Question 4

What does the expression user_input.strip().upper() achieve?

Question 5

In entries.sort(key=lambda x: x[1], reverse=True), what does reverse=True signify?

Practice Challenge

Scenario: The 50-50 Lifeline Feature

In TV quiz shows, contestants can trigger a 50-50 Lifeline that removes two incorrect choices, leaving only the correct answer and one randomly chosen wrong answer.

Add a 50-50 Lifeline feature to the Quiz Application:

1
Create a function use_fifty_fifty(question_item):

Identifies the correct option key.
Gathers all 3 incorrect keys.
Randomly chooses 1 incorrect key to keep.
Returns a reduced dictionary containing only the correct option and the 1 surviving wrong option.

1
Demonstrate calling use_fifty_fifty on a sample question and verifying that exactly 2 options remain.

Starter Code

1import random
2 
3sample_q = {
4    "question": "Which keyword defines an anonymous inline function in Python?",
5    "options": {
6        "A": "def",
7        "B": "inline",
8        "C": "lambda",
9        "D": "func"
10    },
11    "answer": "C",
12    "explanation": "The lambda keyword creates small anonymous functions."
13}
14 
15# TODO: Implement use_fifty_fifty(q) that returns a dict with 2 options (the answer + 1 wrong)

Complete Solution

1import random
2 
3sample_q = {
4    "question": "Which keyword defines an anonymous inline function in Python?",
5    "options": {
6        "A": "def",
7        "B": "inline",
8        "C": "lambda",
9        "D": "func"
10    },
11    "answer": "C",
12    "explanation": "The lambda keyword creates small anonymous functions."
13}
14 
15def use_fifty_fifty(q: dict) -> dict:
16    correct_key = q["answer"]
17    wrong_keys = [k for k in q["options"].keys() if k != correct_key]
18    
19    # Pick one wrong key to keep
20    surviving_wrong = random.choice(wrong_keys)
21    
22    # Return filtered options containing only correct and surviving wrong
23    active_keys = sorted([correct_key, surviving_wrong])
24    filtered_options = {k: q["options"][k] for k in active_keys}
25    return filtered_options
26 
27# Test Lifeline
28print(f"Original Options: {sample_q['options']}")
29lifeline_options = use_fifty_fifty(sample_q)
30print(f"\nAfter 50-50 Lifeline:")
31for k, v in lifeline_options.items():
32    print(f"  [{k}] {v}")
33 
34assert len(lifeline_options) == 2
35assert sample_q["answer"] in lifeline_options
36print("\n[SUCCESS] 50-50 Lifeline validated successfully!")

Expected Output

1Original Options: {'A': 'def', 'B': 'inline', 'C': 'lambda', 'D': 'func'}
2 
3After 50-50 Lifeline:
4  [A] def
5  [C] lambda
6 
7[SUCCESS] 50-50 Lifeline validated successfully!

🚀 What's Next?

In the next lesson, we will continue your Python learning journey with Expense Tracker (16: Projects).

👉 Continue to Next Lesson: Expense Tracker →

Next Lesson

Expense Tracker

Continue learning with hands-on practice, examples, and exercises in the upcoming topic.

Related Lessons

Previous Lesson	Next Lesson
Contact Book	Expense Tracker

Practice Quiz

Test your understanding of this lesson with 5 questions. Each question has one correct answer.

Previous Next