trivia_app_demo.py

"""
Trivia Q&A Application - DEMO VERSION

This version uses mock data to demonstrate the application flow.
Run with: python trivia_app_demo.py
"""

import logging
import html
import sys
from typing import Optional, List, Any
from dataclasses import dataclass
from enum import Enum


# ============================================================================
# Configuration & Constants
# ============================================================================

API_ENDPOINT = "https://opentdb.com/api.php?amount=10"
REQUEST_TIMEOUT = 10
MAX_RETRIES = 3


# ============================================================================
# Logging Configuration
# ============================================================================

def setup_logging(level: int = logging.INFO) -> logging.Logger:
    """Configure logging for observability."""
    logger = logging.getLogger("trivia_app")
    logger.setLevel(level)
    
    handler = logging.StreamHandler(sys.stdout)
    formatter = logging.Formatter(
        '%(asctime)s - %(name)s - %(levelname)s - %(message)s',
        datefmt='%Y-%m-%d %H:%M:%S'
    )
    handler.setFormatter(formatter)
    
    if not logger.handlers:
        logger.addHandler(handler)
    
    return logger


logger = setup_logging()


# ============================================================================
# Domain Models
# ============================================================================

class ResponseCode(Enum):
    """API response codes."""
    SUCCESS = 0
    NO_RESULTS = 1
    INVALID_PARAMETER = 2


@dataclass
class TriviaQuestion:
    """Represents a single trivia question."""
    category: str
    difficulty: str
    question: str
    correct_answer: str
    incorrect_answers: List[str]
    
    def get_all_answers(self) -> List[str]:
        """Get all answers shuffled randomly."""
        import random
        answers = self.incorrect_answers.copy()
        answers.append(self.correct_answer)
        random.shuffle(answers)
        return answers
    
    def decode_html_entities(self) -> None:
        """Decode HTML entities in question and answers."""
        self.question = html.unescape(self.question)
        self.correct_answer = html.unescape(self.correct_answer)
        self.incorrect_answers = [html.unescape(ans) for ans in self.incorrect_answers]


@dataclass
class TriviaResponse:
    """Represents the API response."""
    response_code: int
    results: List[TriviaQuestion]


# ============================================================================
# Mock Data Provider
# ============================================================================

class MockTriviaProvider:
    """Provides mock trivia data for demonstration."""
    
    @staticmethod
    def get_mock_data() -> TriviaResponse:
        """Return mock trivia questions for testing."""
        mock_results = [
            TriviaQuestion(
                category="Entertainment: Comics",
                difficulty="hard",
                question="Better known by his nickname Logan, what is Wolverine's birth name?",
                correct_answer="James Howlett",
                incorrect_answers=["Logan Wolf", "Thomas Wilde", "John Savage"]
            ),
            TriviaQuestion(
                category="History",
                difficulty="easy",
                question="Which one of these countries was NOT in the Central Powers during WWI?",
                correct_answer="Spain",
                incorrect_answers=["Austria-Hungary", "Turkey", "Germany"]
            ),
            TriviaQuestion(
                category="Entertainment: Video Games",
                difficulty="easy",
                question="When was "Luigi's Mansion 3" released?",
                correct_answer="October 31st, 2019",
                incorrect_answers=["January 13th, 2019", "September 6th, 2018", "October 1st, 2019"]
            ),
            TriviaQuestion(
                category="General Knowledge",
                difficulty="easy",
                question="Earth is located in which galaxy?",
                correct_answer="The Milky Way Galaxy",
                incorrect_answers=["The Mars Galaxy", "The Galaxy Note", "The Black Hole"]
            ),
            TriviaQuestion(
                category="Science: Gadgets",
                difficulty="medium",
                question="In what year was the Oculus Rift revealed to the public through a Kickstarter campaign?",
                correct_answer="2012",
                incorrect_answers=["2010", "2011", "2013"]
            ),
        ]
        
        # Decode HTML entities
        for question in mock_results:
            question.decode_html_entities()
        
        return TriviaResponse(response_code=0, results=mock_results)


# ============================================================================
# Trivia Game
# ============================================================================

class TriviaGame:
    """Manages the trivia game flow and scoring."""
    
    def __init__(self, questions: List[TriviaQuestion]):
        """Initialize the game."""
        self.questions = questions
        self.current_question_index = 0
        self.score = 0
        self.answers_given = []
    
    def get_current_question(self) -> Optional[TriviaQuestion]:
        """Get the current question."""
        if self.current_question_index < len(self.questions):
            return self.questions[self.current_question_index]
        return None
    
    def submit_answer(self, selected_answer: str) -> bool:
        """Submit an answer and check if it's correct."""
        question = self.get_current_question()
        if question is None:
            return False
        
        is_correct = selected_answer == question.correct_answer
        
        self.answers_given.append({
            'question': question.question,
            'selected': selected_answer,
            'correct': question.correct_answer,
            'is_correct': is_correct
        })
        
        if is_correct:
            self.score += 1
            logger.debug(f"Correct answer. Score: {self.score}/{len(self.answers_given)}")
        else:
            logger.debug(f"Incorrect answer. Correct was: {question.correct_answer}")
        
        self.current_question_index += 1
        return is_correct
    
    def is_game_over(self) -> bool:
        """Check if all questions have been answered."""
        return self.current_question_index >= len(self.questions)
    
    def get_score_percentage(self) -> float:
        """Get the score as a percentage."""
        if len(self.answers_given) == 0:
            return 0.0
        return (self.score / len(self.answers_given)) * 100


# ============================================================================
# Console UI
# ============================================================================

class ConsoleUI:
    """Handles console-based user interface."""
    
    @staticmethod
    def clear_screen() -> None:
        """Clear the console screen."""
        import os
        os.system('cls' if os.name == 'nt' else 'clear')
    
    @staticmethod
    def print_header(text: str) -> None:
        """Print a formatted header."""
        print("\n" + "=" * 80)
        print(f" {text}")
        print("=" * 80)
    
    @staticmethod
    def print_question(question: TriviaQuestion, question_number: int, total: int) -> None:
        """Display a trivia question."""
        print(f"\n[Question {question_number}/{total}]")
        print(f"Category: {question.category}")
        print(f"Difficulty: {question.difficulty.upper()}")
        print(f"\n{question.question}\n")
    
    @staticmethod
    def print_options(options: List[str]) -> None:
        """Display answer options."""
        for i, option in enumerate(options, 1):
            print(f"  {i}. {option}")
    
    @staticmethod
    def get_user_selection(num_options: int) -> int:
        """Get user's answer selection."""
        while True:
            try:
                selection = input(f"\nYour answer (1-{num_options}): ").strip()
                selection_int = int(selection)
                
                if 1 <= selection_int <= num_options:
                    return selection_int
                else:
                    print(f"Please enter a number between 1 and {num_options}")
            
            except ValueError:
                print("Invalid input. Please enter a number.")
    
    @staticmethod
    def print_answer_feedback(is_correct: bool, correct_answer: str) -> None:
        """Display feedback for the user's answer."""
        if is_correct:
            print("\n✓ CORRECT!")
        else:
            print(f"\n✗ INCORRECT. The correct answer was: {correct_answer}")
    
    @staticmethod
    def print_final_score(game: TriviaGame) -> None:
        """Display final game results."""
        ConsoleUI.print_header("GAME OVER - FINAL RESULTS")
        print(f"\nTotal Score: {game.score}/{len(game.questions)}")
        print(f"Percentage: {game.get_score_percentage():.1f}%")
        print("\n" + "-" * 80)
        print("Question Summary:\n")
        
        for i, answer_data in enumerate(game.answers_given, 1):
            status = "✓" if answer_data['is_correct'] else "✗"
            print(f"{i}. {status} {answer_data['question']}")
            print(f"   Your answer: {answer_data['selected']}")
            if not answer_data['is_correct']:
                print(f"   Correct answer: {answer_data['correct']}")
            print()


# ============================================================================
# Main Application (Demo)
# ============================================================================

def main() -> None:
    """Main application entry point."""
    logger.info("Starting Trivia Q&A Application (DEMO MODE)")
    
    ConsoleUI.clear_screen()
    ConsoleUI.print_header("TRIVIA Q&A - OPEN TRIVIA DATABASE (DEMO)")
    print("\nLoading trivia questions (using mock data for demo)...\n")
    
    # Get mock data
    trivia_response = MockTriviaProvider.get_mock_data()
    
    if trivia_response is None or len(trivia_response.results) == 0:
        print("\n✗ Failed to load trivia questions.")
        logger.error("Application terminated due to data load failure")
        return
    
    print(f"✓ Loaded {len(trivia_response.results)} questions\n")
    
    # Initialize and run game
    game = TriviaGame(trivia_response.results)
    
    try:
        while not game.is_game_over():
            question = game.get_current_question()
            question_number = game.current_question_index + 1
            
            ConsoleUI.print_question(
                question,
                question_number,
                len(game.questions)
            )
            
            options = question.get_all_answers()
            ConsoleUI.print_options(options)
            
            # Get user's answer
            selection_index = ConsoleUI.get_user_selection(len(options)) - 1
            selected_answer = options[selection_index]
            
            # Check answer and provide feedback
            is_correct = game.submit_answer(selected_answer)
            ConsoleUI.print_answer_feedback(is_correct, question.correct_answer)
            
            # Pause before next question
            if not game.is_game_over():
                input("\nPress Enter to continue to the next question...")
        
        # Display final results
        ConsoleUI.print_final_score(game)
        logger.info(f"Game completed. Final score: {game.score}/{len(game.questions)}")
    
    except KeyboardInterrupt:
        print("\n\n✗ Game interrupted by user.")
        logger.info("Game interrupted by user")
    
    except Exception as e:
        logger.error(f"Unexpected error during game: {e}", exc_info=True)
        print(f"\n✗ An unexpected error occurred: {e}")


if __name__ == "__main__":
    main()