Source code for src.academic_adventure

"""
academic_adventure.py

This module contains the main game logic for the Academic Adventure game. It uses the pygame 
library to create a game window, handle events, and render the game state to the screen.
"""

# importing libraries
import pygame

from classes import *
from menu import *
from settings import *



class Game:
    """
    The main class representing the game.

    Attributes
    ----------
    bg_music : pygame.mixer.Sound
        The background music for the game.

    screen : pygame.Surface
        The main game window.

    clock : pygame.time.Clock
        A clock to control the game's frame rate.

    x : int
        An example attribute for demonstration purposes.

    running : bool
        Flag indicating whether the game is currently running.

    Methods
    -------
    __init__()
        Initializes the game, including pygame and the game window.

    new()
        Initializes a new game, creating a new level and menu.

    run()
        Runs the main game loop, handling events and updating the game state.
    """
    def __init__(self) -> None:
        """
        Initializes the game

        Parameters
        ----------
        None.

        Returns
        -------
        None.
        """
        # Initialize pygame and create window
        pygame.init()
        pygame.mixer.init()

        #audio
        self.bg_music = pygame.mixer.Sound('src/audio/bg_music.wav')
        self.bg_music.set_volume(0.3)
        self.bg_music.play(loops = -1)

        # Create the screen and clock
        self.screen = pygame.display.set_mode((SCREEN_WIDTH, SCREEN_HEIGHT))
        self.clock = pygame.time.Clock()
        
        # self.x = 0

        # Game loop control
        self.running = True



    def new(self):
        """
        Initializes a new game by creating a new level and menu.
        
        Parameters
        ----------
        None.

        Returns
        -------
        None.
        """
        # Create a new level and menu
        self.level = Level(level_list, bg_list, self.screen)
        self.menu = Menu(self.level)

    



    def run(self):
        """
        Runs the main game loop, handling events and updating the game state.

        Parameters
        ----------
        None.

        Returns
        -------
        None.
        """
        # Game loop
        try:
            self.new()

            while self.running:
                for event in pygame.event.get():
                    if event.type == pygame.QUIT:
                        self.running = False

                    # Pause the game
                    if event.type == pygame.KEYDOWN:
                        if event.key == pygame.K_ESCAPE:  # 'ESC' key to pause the game
                            self.menu.current_screen = "pause"
                            self.menu.pause()

                # Update the game state and render the screen
                if self.menu.current_screen == "main_menu":
                    self.menu.main_menu("src\graphics\backgrounds\menu_bg.png")
                elif self.level.game_over:
                    self.menu.game_over()
                elif self.menu.current_screen == "play":
                    self.level.run()
                    pygame.display.flip()
                    self.clock.tick(60)
                elif self.menu.current_screen == "credits":
                    self.menu.credits()
        
        # Handle errors
        except pygame.error as e:
            print(f"An error occurred during game execution: {e}")
        except Exception as e:
            print(f"An unexpected error occurred during game execution: {e}")
        finally:
            pygame.quit()




if __name__ == "__main__":
    game = Game()
    game.run()