batframework 1.0.7__tar.gz → 1.0.8a2__tar.gz

batframework-1.0.8a2/PKG-INFO

@@ -0,0 +1,58 @@
+Metadata-Version: 2.1
+Name: batframework
+Version: 1.0.8a2
+Summary: Pygame framework for making games easier.
+Author-email: Turan Baturay <baturayturan@gmail.com>
+Project-URL: Homepage, https://github.com/TuranBaturay/batFramework
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: pygame-ce
+
+# batFramework
+
+batFramework is a Python game framework built using Pygame, designed to simplify game development by providing entities, scenes, a scene manager, and various utilities.
+
+## Purpose and Overview
+The primary objective of batFramework is to streamline game development by utilizing entities and scenes that hold entities. It employs a manager, which inherits from the scene manager, to handle scenes, propagate events, and manage updates and rendering.
+
+## Installation and Setup
+To install batFramework, you can use pip:
+```pip install batFramework```
+
+
+The only dependency required is pygame-ce.
+
+## Usage Instructions
+To create a basic app using batFramework, here's an example:
+
+```python
+import batFramework as bf
+
+# Initialize the framework
+bf.init((1280, 720), window_title="My Amazing Program")
+
+# Create a manager and a scene
+bf.Manager(bf.Scene("main")).run()
+```
+In practice, users can inherit bf.Scene to create their own scenes, adding specific behaviors, entities, etc.
+
+## Features and Functionalities
+
+- Scene management for organizing game components
+- Cutscene support to facilitate storytelling sequences
+- Audio management for music and sound effects with volume control
+- Entity, sprite, and animated sprite support
+- Utility modules such as time management and easingAnimation
+
+Users can leverage these functionalities to build games efficiently using batFramework.
+
+For more detailed usage and examples, please refer to the documentation or codebase.
+
+
+# License
+ MIT License
+
+

batframework-1.0.8a2/README.md

@@ -0,0 +1,45 @@
+# batFramework
+
+batFramework is a Python game framework built using Pygame, designed to simplify game development by providing entities, scenes, a scene manager, and various utilities.
+
+## Purpose and Overview
+The primary objective of batFramework is to streamline game development by utilizing entities and scenes that hold entities. It employs a manager, which inherits from the scene manager, to handle scenes, propagate events, and manage updates and rendering.
+
+## Installation and Setup
+To install batFramework, you can use pip:
+```pip install batFramework```
+
+
+The only dependency required is pygame-ce.
+
+## Usage Instructions
+To create a basic app using batFramework, here's an example:
+
+```python
+import batFramework as bf
+
+# Initialize the framework
+bf.init((1280, 720), window_title="My Amazing Program")
+
+# Create a manager and a scene
+bf.Manager(bf.Scene("main")).run()
+```
+In practice, users can inherit bf.Scene to create their own scenes, adding specific behaviors, entities, etc.
+
+## Features and Functionalities
+
+- Scene management for organizing game components
+- Cutscene support to facilitate storytelling sequences
+- Audio management for music and sound effects with volume control
+- Entity, sprite, and animated sprite support
+- Utility modules such as time management and easingAnimation
+
+Users can leverage these functionalities to build games efficiently using batFramework.
+
+For more detailed usage and examples, please refer to the documentation or codebase.
+
+
+# License
+ MIT License
+
+

{batframework-1.0.7 → batframework-1.0.8a2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "batframework"
-version = "1.0.7"
+version = "1.0.8a2"
 authors = [
     { name="Turan Baturay", email="baturayturan@gmail.com" }
 ]
@@ -15,7 +15,7 @@ classifiers = [
     "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
 ]
-requires-python = ">=3.11"
+requires-python = ">=3.10"
 dependencies=[
     "pygame-ce"
 ]

batframework-1.0.8a2/src/batFramework/__init__.py

@@ -0,0 +1,66 @@
+import pygame
+from .constants import Constants as const
+import os
+import json
+initialized = False
+
+def init(
+    resolution:tuple[int,int],
+    flags:int=0,
+    vsync:int = 0,
+    default_text_size=None,
+    default_font=None,
+    resource_path:str|None=None,
+    window_title:str="BatFramework Project",
+    fps_limit : int = 0
+    ):
+    global initialized
+    if not initialized:
+        pygame.init()
+        pygame.display.set_caption(window_title)
+
+        # Initialize display
+        const.init_screen(resolution,flags,vsync)
+        const.set_fps_limit(fps_limit)
+
+        # Initialize default text size
+        if default_text_size: const.set_default_text_size(default_text_size)
+        # Initialize resource path for game data
+        if resource_path: const.set_resource_path(resource_path)
+
+        # Initialize default font cache
+        from .utils import Utils
+        if default_font is None or isinstance(default_font,str):
+            Utils.init_font(default_font)
+        else:
+            raise ValueError(f"default_font '{default_font}' can be either string or None")
+        
+        f = list(Utils.FONTS[None].values())[0]
+        print(f"Set default font to : {f.name} {'' if default_font is not None else '(default value)'}")
+        initialized = True
+
+from .constants import Colors as color
+from .constants import Axis as axis
+from .utils import Singleton
+from .utils import Utils as utils
+from .time import Time, Timer
+from .cutscene import Cutscene,CutsceneManager
+from .cutsceneBlocks import *
+from .easing import Easing, EasingAnimation
+from .audioManager import AudioManager
+from .utils import Layout, Alignment, Direction
+from .transition import *
+from .action import Action
+from .actionContainer import ActionContainer
+from .camera import Camera
+from .entity import Entity
+from .dynamicEntity import DynamicEntity
+from .animatedSprite import AnimatedSprite, AnimState
+from .stateMachine import State, StateMachine
+from .particles import Particle, ParticleManager
+# from .debugger import Debugger
+from .scene import Scene
+from .gui import * 
+from .sceneManager import SceneManager
+from .manager import Manager
+

{batframework-1.0.7 → batframework-1.0.8a2}/src/batFramework/action.py

@@ -12,21 +12,20 @@ class Action:
         Args:
             name (str): The name of the action.
         """
-        self._name :str= name
-        self._active :bool= False
-        self._type :ActionType = ActionType.INSTANTANEOUS
-        self._key_control : set= set()       
-        self._mouse_control :set = set()
-        self._gamepad_button_control :set = set()
-        self._gamepad_axis_control :set = set()
+        self._name = name
+        self._active = False
+        self._type = ActionType.INSTANTANEOUS
+        self._key_control = set()
+        self._mouse_control = set()
+        self._gamepad_button_control = set()
+        self._gamepad_axis_control = set()
         self._holding = set()
         self._unique = True
-        self.data: Any = None
+        self.data : Any = None
 
     def set_unique(self, val: bool) -> None:
         """
         Set whether this action is unique (exclusive).
-        When in an action Container, unique actions -when active - break the propagation of their event to other actions.
 
         Args:
             val (bool): True if the action is unique, False otherwise.
@@ -52,7 +51,7 @@ class Action:
         self._active = value
         self._holding = set()
 
-    def add_key_control(self, *keys) -> "Action":
+    def add_key_control(self, *keys) -> 'Action':
         """
         Add key controls to the action.
 
@@ -65,26 +64,7 @@ class Action:
         self._key_control.update(keys)
         return self
 
-    def remove_key_control(self, *keys:int) -> "Action":
-        """
-        Remove key controls to the action.
-
-        Args:
-            *keys (int): Key codes to control this action.
-
-        Returns:
-            Action: The updated Action object for method chaining.
-        """
-        self._key_control = self._key_control - set(keys)
-        return self
-
-    def replace_key_control(self, key, new_key) -> "Action":
-        if not key in self._key_control : return self
-        self.remove_key_control(key)
-        self.add_key_control(new_key)
-        return self
-
-    def add_mouse_control(self, *mouse_buttons:int) -> "Action":
+    def add_mouse_control(self, *mouse_buttons) -> 'Action':
         """
         Add mouse control to the action.
 
@@ -106,7 +86,7 @@ class Action:
         """
         return self._name
 
-    def set_continuous(self) -> "Action":
+    def set_continuous(self) -> 'Action':
         """
         Set the action type to continuous.
 
@@ -126,7 +106,7 @@ class Action:
         """
         return self._type == ActionType.CONTINUOUS
 
-    def set_instantaneous(self) -> "Action":
+    def set_instantaneous(self) -> 'Action':
         """
         Set the action type to instantaneous.
 
@@ -146,7 +126,7 @@ class Action:
         """
         return self._type == ActionType.INSTANTANEOUS
 
-    def set_holding(self) -> "Action":
+    def set_holding(self) -> 'Action':
         """
         Set the action type to holding.
 
@@ -165,14 +145,9 @@ class Action:
         """
         return self._type == ActionType.HOLDING
 
-    def process_update(self, event: pygame.Event) -> None:
-        if (
-            self.is_active()
-            and event.type == pygame.MOUSEMOTION
-            and self.is_holding_type()
-            and pygame.MOUSEMOTION in self._mouse_control
-        ):
-            self.data = {"pos": event.pos, "rel": event.rel}
+    def process_update(self,event:pygame.Event)->None:
+        if self.is_active() and event.type == pygame.MOUSEMOTION and  self.is_holding_type() and pygame.MOUSEMOTION in self._mouse_control:
+            self.data = {"pos":event.pos,"rel":event.rel}
 
     def process_activate(self, event: pygame.event.Event) -> bool:
         """
@@ -230,7 +205,10 @@ class Action:
                 if not self._holding:
                     self._active = False
                     return True
-            elif event.type == pygame.MOUSEMOTION and event.type in self._mouse_control:
+            elif (
+                event.type == pygame.MOUSEMOTION
+                and event.type in self._mouse_control
+            ):
                 self.value = None
                 if event.type in self._holding:
                     self._holding.remove(event.type)

batframework-1.0.8a2/src/batFramework/actionContainer.py

@@ -0,0 +1,38 @@
+import batFramework as bf
+
+
+class ActionContainer:
+    def __init__(self, *actions: list[bf.Action]) -> None:
+        self._actions: dict[str, bf.Action] = {}
+        if actions:
+            self.add_action(*actions)
+
+    def clear(self):
+        self._actions = {}
+
+    def add_action(self, *actions: bf.Action):
+        for action in actions:
+            self._actions[action.get_name()] = action
+
+    def get(self,name:str)->bf.Action:
+        return self._actions.get(name)
+
+    def has_action(self, name:str):
+        return name in self._actions
+
+    def is_active(self, *names:str)->bool:
+        return all(self._actions.get(name).is_active() if name in self._actions else False for name in names)
+
+    def process_event(self, event):
+        for action in self._actions.values():
+            a = action.process_event(event)
+            if a and action._unique:
+                break
+
+    def reset(self):
+        for action in self._actions.values():
+            action.reset()
+
+    def hard_reset(self):
+        for action in self._actions.values():
+            action.hard_reset()

batframework-1.0.8a2/src/batFramework/animatedSprite.py

@@ -0,0 +1,117 @@
+import batFramework as bf
+import pygame
+
+
+
+def search_index(target, lst):
+    cumulative_sum = 0
+    for index, value in enumerate(lst):
+        cumulative_sum += value
+        if cumulative_sum >= target:
+            return index
+    return -1
+
+
+class AnimState:
+    def __init__(self, file, width, height, frame_length_list:list|int) -> None:
+        self.frames: list[pygame.Surface] = bf.utils.img_slice(file, width, height)
+        self.frames_flipX: list[pygame.Surface] = bf.utils.img_slice(
+            file, width, height, True
+        )
+
+        self.frame_length_list = []
+        self.ffl_length = 0
+        self.set_frame_length_list(frame_length_list)
+
+    def get_frame_index(self, counter:float|int):
+        return search_index(int(counter % self.ffl_length), self.frame_length_list)
+
+    def get_frame(self, counter, flip):
+        i = self.get_frame_index(counter)
+        return self.frames_flipX[i] if flip else self.frames[i]
+
+    def set_frame_length_list(self,frame_length_list:list[int]|int):
+        if isinstance(frame_length_list,int):
+            frame_length_list = [frame_length_list] * len(self.frames)
+        if len(frame_length_list) != len(self.frames) : 
+            raise ValueError("frame_length_list should have values for all frames")
+        self.frame_length_list = frame_length_list
+        self.ffl_length = sum(self.frame_length_list)
+        
+
+class AnimatedSprite(bf.DynamicEntity):
+    def __init__(self, size=None) -> None:
+        super().__init__(size, no_surface=True)
+        self.float_counter = 0
+        self.animStates: dict[str, AnimState] = {}
+        self.current_animState :str = ""
+        self.flipX = False
+        self._locked = False
+
+    def set_counter(self,value:float):
+        self.float_counter = value
+        
+
+    def lock_animState(self):
+        self._locked = True
+
+    def unlock_animState(self):
+        self._locked = False
+
+    def set_flipX(self, value):
+        self.flipX = value
+
+    def remove_animState(self, name:str):
+        if not name in self.animStates :return
+        self.animStates.pop(name) 
+        if self.current_animState == name : self.current_animState = list(self.animStates.keys())[0] if self.animStates else "" 
+
+    def add_animState(
+        self, name: str, file: str, size: tuple[int, int], frame_length_list: list[int]
+    ):
+        if name in self.animStates:
+            return
+        self.animStates[name] = AnimState(file, *size, frame_length_list)
+        if len(self.animStates) == 1 : self.set_animState(name)
+
+    def set_animState(self, state:str, reset_counter=True, lock=False):
+        if state not in self.animStates or self._locked:
+            return False
+        self.current_animState = state
+        self.rect = (
+            self.animStates[self.current_animState]
+            .frames[0]
+            .get_frect(center=self.rect.center)
+        )
+        if reset_counter or self.float_counter > sum(
+            self.get_state().frame_length_list
+        ):
+            self.float_counter = 0
+        if lock:
+            self.lock_animState()
+        return True
+
+    def get_state(self):
+        return self.animStates.get(self.current_animState,None)
+
+    def get_frame_index(self):
+        return self.animStates[self.current_animState].get_frame_index(
+            self.float_counter
+        )
+
+    def update(self, dt: float):
+        if not self.animStates : return
+        self.float_counter += 60 * dt
+        if self.float_counter > self.get_state().ffl_length:
+            self.float_counter = 0
+        self.do_update(dt)
+
+    def draw(self, camera: bf.Camera) -> bool:
+        if not self.visible or not camera.intersects(self.rect) or not self.animStates:
+            return False
+        # pygame.draw.rect(camera.surface,"purple",camera.transpose(self.rect).move(2,2))
+        camera.surface.blit(
+            self.get_state().get_frame(self.float_counter, self.flipX),
+            camera.transpose(self.rect),
+        )
+        return True

{batframework-1.0.7 → batframework-1.0.8a2}/src/batFramework/audioManager.py

@@ -5,19 +5,24 @@ pygame.mixer.init()
 
 
 class AudioManager(metaclass=bf.Singleton):
-    def __init__(self)->None:
-        self.sounds: dict = {}
-        self.musics: dict = {}
-        self.current_music :str|None= None
-        self.music_volume :float= 1
-        self.sound_volume :float= 1
+    def __init__(self):
+        self.sounds: dict[str : dict[str, pygame.mixer.Sound, bool]] = {}
+        self.musics: dict[str:str] = {}
+        self.current_music = None
+        self.music_volume = 1
+        self.sound_volume = 1
         pygame.mixer_music.set_endevent(bf.const.MUSIC_END_EVENT)
 
-    def free_sounds(self, force:bool=False):
+    def free_sounds(self, force=False):
         if force:
             self.sounds = {}
             return
-        self.sounds =  {key:value for key,value in self.sounds.items() if value["persistent"]}
+        to_remove = []
+        for name, data in self.sounds.items():
+            if not data["persistent"]:
+                to_remove.append(name)
+
+        _ = [self.sounds.pop(i) for i in to_remove]
 
     def set_sound_volume(self, volume: float):
         self.sound_volume = volume
@@ -26,54 +31,38 @@ class AudioManager(metaclass=bf.Singleton):
         self.music_volume = volume
         pygame.mixer_music.set_volume(volume)
 
-    def has_sound(self, name:str):
+    def has_sound(self, name):
         return name in self.sounds
 
     def load_sound(self, name, path, persistent=False) -> pygame.mixer.Sound:
         if name in self.sounds:
             return self.sounds[name]["sound"]
-        path = bf.ResourceManager().get_path(path)
+        path = bf.utils.get_path(path)
         self.sounds[name] = {
             "path": path,
             "sound": pygame.mixer.Sound(path),
-            "persistent": persistent
+            "persistent": persistent,
         }
         return self.sounds[name]["sound"]
 
-    def load_sounds(self,sound_data_list:list[tuple[str,str,bool]])->None:
-        for data in sound_data_list:
-            self.load_sound(*data)
-        return 
-        
     def play_sound(self, name, volume=1):
-        try:
-            self.sounds[name]["sound"].set_volume(volume * self.sound_volume)
-            self.sounds[name]["sound"].play()
-        except KeyError:
-            print(f"Sound '{name}' not loaded in AudioManager.")
+        self.sounds[name]["sound"].set_volume(volume * self.sound_volume)
+        self.sounds[name]["sound"].play()
 
     def stop_sound(self, name):
-        try:
+        if name in self.sounds:
             self.sounds[name]["sound"].stop()
-        except KeyError:
-            
-            print(f"Sound '{name}' not loaded in AudioManager.")
+
     def load_music(self, name, path):
-        self.musics[name] = bf.ResourceManager().get_path(path)
-        return
-        
-    def load_musics(self,music_data_list:list[tuple[str,str]]):
-        for data in music_data_list:
-            self.load_music(*data)
-        return
-        
+        self.musics[name] = bf.utils.get_path(path)
+
     def play_music(self, name, loop=0, fade=500):
-        try:
+        if name in self.musics:
             pygame.mixer_music.load(self.musics[name])
             pygame.mixer_music.play(loop, fade_ms=fade)
             self.current_music = name
-        except KeyError:
-            print(f"Music '{name}' not loaded in AudioManager.")
+        else:
+            print(f"Music '{name}' not found in AudioManager.")
 
     def stop_music(self):
         if not self.current_music:
@@ -94,6 +83,3 @@ class AudioManager(metaclass=bf.Singleton):
         if not self.current_music:
             return
         pygame.mixer_music.unpause()
-
-    def get_current_music(self)->str|None:
-        return self.current_music