Python Quiz Application Project

"""A reusable command-line multiple-choice quiz."""

from __future__ import annotations

import random


QUESTIONS = [
    {
        "question": "Which keyword defines a function in Python?",
        "options": ["func", "def", "function", "method"],
        "answer": 1,
        "explanation": "Python functions begin with the def keyword.",
    },
    {
        "question": "Which collection stores unique values?",
        "options": ["list", "tuple", "set", "string"],
        "answer": 2,
        "explanation": "A set keeps one instance of each hashable value.",
    },
    {
        "question": "What does len([10, 20, 30]) return?",
        "options": ["2", "3", "30", "60"],
        "answer": 1,
        "explanation": "The list contains three items.",
    },
    {
        "question": "Which block handles a raised exception?",
        "options": ["catch", "rescue", "except", "error"],
        "answer": 2,
        "explanation": "Python pairs try with one or more except blocks.",
    },
    {
        "question": "Which operator checks value equality?",
        "options": ["=", "==", "!=", ":="],
        "answer": 1,
        "explanation": "== compares values; = assigns a value.",
    },
]


def ask_question(item: dict[str, object], number: int) -> bool:
    options = item["options"]
    if not isinstance(options, list):
        raise TypeError("Question options must be a list.")

    print(f"\n{number}. {item['question']}")
    for index, option in enumerate(options, start=1):
        print(f"   {index}. {option}")

    while True:
        choice = input(f"Your answer [1-{len(options)}]: ").strip()
        if choice.isdigit() and 1 <= int(choice) <= len(options):
            break
        print("Choose one of the displayed option numbers.")

    correct = int(choice) - 1 == item["answer"]
    print("Correct!" if correct else f"Not quite. Correct answer: {options[item['answer']]}")
    print(item["explanation"])
    return correct


def run_quiz(questions: list[dict[str, object]]) -> int:
    shuffled = questions.copy()
    random.shuffle(shuffled)
    score = sum(ask_question(item, number) for number, item in enumerate(shuffled, start=1))
    percentage = score / len(shuffled) * 100 if shuffled else 0
    print(f"\nFinal score: {score}/{len(shuffled)} ({percentage:.0f}%)")
    return score


def main() -> None:
    print("Python Basics Quiz")
    run_quiz(QUESTIONS)


if __name__ == "__main__":
    main()