animpy 1.2__tar.gz → 1.3__tar.gz

{animpy-1.2 → animpy-1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: animpy
-Version: 1.2
+Version: 1.3
 Summary: A simple terminal animation library
 Author: Samin Riyaz
 License: MIT License
@@ -47,11 +47,11 @@ Animpy is a simple animation library for creating cool terminal animations. It g
 
 The particle simulator shown above was made entirely with Animpy.
 
-## What's New in 1.2
+## What's New in 1.3
 
-- **Type Out Effect** – New `type_out()` method for animated text typing effect
-- **Gravity/Fall Effect** – New `fall()` method to create gravity and falling text animations
-- **Improved Render Graphics** – Optimized rendering using buffered output to eliminate ghosting effects and improve animation smoothness; now uses efficient ANSI escape sequences for RGB color rendering
+- **Enhanced RGB Color Effects** – Improved support for vibrant RGB color animations; new examples show how to create gradient and rainbow text effects
+- **Audio Support** – New Audio class for loading and playing sound effects with pygame mixer integration
+- **Clean Ctrl+C Exit** – Graceful interrupt handling that cleanly exits without showing messy error messages
 
 ## What Can You Do?
 
@@ -212,6 +212,44 @@ scene.render()
   scene.render()  # Shows everything on screen
   ```
 
+### The `Audio` Class
+
+The Audio class lets you load and play sound effects in your animations using pygame mixer.
+
+**Creating and using:**
+```python
+audio = animpy.Audio()
+
+# Load sound files
+audio.load("jump", "sounds/jump.wav")
+audio.load("background", "sounds/music.mp3")
+
+# Play sounds
+audio.play("jump")  # Play once
+audio.play("background", loop=-1)  # Loop infinitely
+
+# Stop all sounds
+audio.stop_all()
+```
+
+**Methods:**
+
+- **`load(name, file_path)`** – Load a sound file and give it a name
+  ```python
+  audio.load("explosion", "sounds/boom.wav")
+  ```
+
+- **`play(name, loop=0)`** – Play a loaded sound (loop=0 plays once, loop=-1 loops infinitely)
+  ```python
+  audio.play("explosion")  # Play once
+  audio.play("background", loop=-1)  # Loop infinitely
+  ```
+
+- **`stop_all()`** – Stop all currently playing sounds
+  ```python
+  audio.stop_all()
+  ```
+
 ## Full Animation Example
 
 Here's a complete example showing how to create animations with the new v1.2 features:
@@ -252,6 +290,39 @@ for i in range(20):
     time.sleep(0.2)
 ```
 
+## Rainbow Text Example
+
+Here's a fun example creating rainbow-colored text using RGB values:
+
+```python
+import animpy
+import time
+
+scene = animpy.Scene()
+
+# Rainbow colors (RGB)
+rainbow_colors = [
+    (255, 0, 0),      # Red
+    (255, 127, 0),    # Orange
+    (255, 255, 0),    # Yellow
+    (0, 255, 0),      # Green
+    (0, 0, 255),      # Blue
+    (75, 0, 130),     # Indigo
+    (148, 0, 211),    # Violet
+]
+
+# Create rainbow text - each character in a different color
+text_str = "Rainbow!!!!!"
+for i, char in enumerate(text_str):
+    color = rainbow_colors[i % len(rainbow_colors)]
+    char_text = animpy.Text(char, i, 0, r=color[0], g=color[1], b=color[2])
+    scene.add(char_text)
+
+# Render the rainbow text
+scene.render()
+time.sleep(2)
+```
+
 ## License
 
 See LICENSE for details.

{animpy-1.2 → animpy-1.3}/README.md

@@ -12,11 +12,11 @@ Animpy is a simple animation library for creating cool terminal animations. It g
 
 The particle simulator shown above was made entirely with Animpy.
 
-## What's New in 1.2
+## What's New in 1.3
 
-- **Type Out Effect** – New `type_out()` method for animated text typing effect
-- **Gravity/Fall Effect** – New `fall()` method to create gravity and falling text animations
-- **Improved Render Graphics** – Optimized rendering using buffered output to eliminate ghosting effects and improve animation smoothness; now uses efficient ANSI escape sequences for RGB color rendering
+- **Enhanced RGB Color Effects** – Improved support for vibrant RGB color animations; new examples show how to create gradient and rainbow text effects
+- **Audio Support** – New Audio class for loading and playing sound effects with pygame mixer integration
+- **Clean Ctrl+C Exit** – Graceful interrupt handling that cleanly exits without showing messy error messages
 
 ## What Can You Do?
 
@@ -177,6 +177,44 @@ scene.render()
   scene.render()  # Shows everything on screen
   ```
 
+### The `Audio` Class
+
+The Audio class lets you load and play sound effects in your animations using pygame mixer.
+
+**Creating and using:**
+```python
+audio = animpy.Audio()
+
+# Load sound files
+audio.load("jump", "sounds/jump.wav")
+audio.load("background", "sounds/music.mp3")
+
+# Play sounds
+audio.play("jump")  # Play once
+audio.play("background", loop=-1)  # Loop infinitely
+
+# Stop all sounds
+audio.stop_all()
+```
+
+**Methods:**
+
+- **`load(name, file_path)`** – Load a sound file and give it a name
+  ```python
+  audio.load("explosion", "sounds/boom.wav")
+  ```
+
+- **`play(name, loop=0)`** – Play a loaded sound (loop=0 plays once, loop=-1 loops infinitely)
+  ```python
+  audio.play("explosion")  # Play once
+  audio.play("background", loop=-1)  # Loop infinitely
+  ```
+
+- **`stop_all()`** – Stop all currently playing sounds
+  ```python
+  audio.stop_all()
+  ```
+
 ## Full Animation Example
 
 Here's a complete example showing how to create animations with the new v1.2 features:
@@ -217,6 +255,39 @@ for i in range(20):
     time.sleep(0.2)
 ```
 
+## Rainbow Text Example
+
+Here's a fun example creating rainbow-colored text using RGB values:
+
+```python
+import animpy
+import time
+
+scene = animpy.Scene()
+
+# Rainbow colors (RGB)
+rainbow_colors = [
+    (255, 0, 0),      # Red
+    (255, 127, 0),    # Orange
+    (255, 255, 0),    # Yellow
+    (0, 255, 0),      # Green
+    (0, 0, 255),      # Blue
+    (75, 0, 130),     # Indigo
+    (148, 0, 211),    # Violet
+]
+
+# Create rainbow text - each character in a different color
+text_str = "Rainbow!!!!!"
+for i, char in enumerate(text_str):
+    color = rainbow_colors[i % len(rainbow_colors)]
+    char_text = animpy.Text(char, i, 0, r=color[0], g=color[1], b=color[2])
+    scene.add(char_text)
+
+# Render the rainbow text
+scene.render()
+time.sleep(2)
+```
+
 ## License
 
 See LICENSE for details.

{animpy-1.2 → animpy-1.3}/animpy.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: animpy
-Version: 1.2
+Version: 1.3
 Summary: A simple terminal animation library
 Author: Samin Riyaz
 License: MIT License
@@ -47,11 +47,11 @@ Animpy is a simple animation library for creating cool terminal animations. It g
 
 The particle simulator shown above was made entirely with Animpy.
 
-## What's New in 1.2
+## What's New in 1.3
 
-- **Type Out Effect** – New `type_out()` method for animated text typing effect
-- **Gravity/Fall Effect** – New `fall()` method to create gravity and falling text animations
-- **Improved Render Graphics** – Optimized rendering using buffered output to eliminate ghosting effects and improve animation smoothness; now uses efficient ANSI escape sequences for RGB color rendering
+- **Enhanced RGB Color Effects** – Improved support for vibrant RGB color animations; new examples show how to create gradient and rainbow text effects
+- **Audio Support** – New Audio class for loading and playing sound effects with pygame mixer integration
+- **Clean Ctrl+C Exit** – Graceful interrupt handling that cleanly exits without showing messy error messages
 
 ## What Can You Do?
 
@@ -212,6 +212,44 @@ scene.render()
   scene.render()  # Shows everything on screen
   ```
 
+### The `Audio` Class
+
+The Audio class lets you load and play sound effects in your animations using pygame mixer.
+
+**Creating and using:**
+```python
+audio = animpy.Audio()
+
+# Load sound files
+audio.load("jump", "sounds/jump.wav")
+audio.load("background", "sounds/music.mp3")
+
+# Play sounds
+audio.play("jump")  # Play once
+audio.play("background", loop=-1)  # Loop infinitely
+
+# Stop all sounds
+audio.stop_all()
+```
+
+**Methods:**
+
+- **`load(name, file_path)`** – Load a sound file and give it a name
+  ```python
+  audio.load("explosion", "sounds/boom.wav")
+  ```
+
+- **`play(name, loop=0)`** – Play a loaded sound (loop=0 plays once, loop=-1 loops infinitely)
+  ```python
+  audio.play("explosion")  # Play once
+  audio.play("background", loop=-1)  # Loop infinitely
+  ```
+
+- **`stop_all()`** – Stop all currently playing sounds
+  ```python
+  audio.stop_all()
+  ```
+
 ## Full Animation Example
 
 Here's a complete example showing how to create animations with the new v1.2 features:
@@ -252,6 +290,39 @@ for i in range(20):
     time.sleep(0.2)
 ```
 
+## Rainbow Text Example
+
+Here's a fun example creating rainbow-colored text using RGB values:
+
+```python
+import animpy
+import time
+
+scene = animpy.Scene()
+
+# Rainbow colors (RGB)
+rainbow_colors = [
+    (255, 0, 0),      # Red
+    (255, 127, 0),    # Orange
+    (255, 255, 0),    # Yellow
+    (0, 255, 0),      # Green
+    (0, 0, 255),      # Blue
+    (75, 0, 130),     # Indigo
+    (148, 0, 211),    # Violet
+]
+
+# Create rainbow text - each character in a different color
+text_str = "Rainbow!!!!!"
+for i, char in enumerate(text_str):
+    color = rainbow_colors[i % len(rainbow_colors)]
+    char_text = animpy.Text(char, i, 0, r=color[0], g=color[1], b=color[2])
+    scene.add(char_text)
+
+# Render the rainbow text
+scene.render()
+time.sleep(2)
+```
+
 ## License
 
 See LICENSE for details.

{animpy-1.2 → animpy-1.3}/animpy.py

@@ -3,6 +3,7 @@ import os, sys, time, atexit, shutil
 sys.stdout.write("\033[?25l")
 atexit.register(lambda: (sys.stdout.write("\033[?25h"), sys.stdout.flush()))
 terminal_size = shutil.get_terminal_size()
+os.environ['PYGAME_HIDE_SUPPORT_PROMPT'] = "hide"
 
 def addFrame():
     return "\033[2J\033[H"
@@ -65,22 +66,37 @@ ANSI = {
 sys.stdout.write("\033[?25l")
 atexit.register(lambda: (sys.stdout.write("\033[?25h"), sys.stdout.flush()))
 
-class Text:
-    def __init__(self, text: str | list[str], x: int, y: int, r=255, g=255, b=255) -> None:
-        self.x = x
-        self.y = y
+from pygame import mixer
 
-        self.r = r
-        self.g = g
-        self.b = b
+class Audio:
+    def __init__(self):
+        mixer.init()
+        self.sounds = {}
 
-        if isinstance(text, list):
-            self.text_list = text      # store the list
-            self.current_frame = 0
-            self.text = text[0]        # current visible text
-        else:
-            self.text_list = None
-            self.text = text
+    def load(self, name, file_path):
+        self.sounds[name] = mixer.Sound(file_path)
+
+    def play(self, name, loop=0):
+        if name in self.sounds:
+            self.sounds[name].play(loops=loop)
+
+    def stop_all(self):
+        mixer.stop()
+
+class Text:
+    def __init__(self, text, x, y, r=255, g=255, b=255):
+        # If 'text' is a list, we store it for frames; otherwise, it's just a string
+        self.frames = text if isinstance(text, list) else [text]
+        self.current_frame_idx = 0
+        self.text = self.frames[0] # The current string for the renderer
+        
+        self.x, self.y = x, y
+        self.r, self.g, self.b = r, g, b
+
+    def change_frame(self):
+        """Cycles through the list of frames"""
+        self.current_frame_idx = (self.current_frame_idx + 1) % len(self.frames)
+        self.text = self.frames[self.current_frame_idx]
 
     def moveX(self, newX: int) -> None:
         self.x = newX
@@ -94,11 +110,6 @@ class Text:
     def centerY(self):
         self.y = terminal_size.lines // 2
 
-    def change_frame(self) -> None:
-        if self.text_list:
-            self.current_frame = (self.current_frame + 1) % len(self.text_list)
-            self.text = self.text_list[self.current_frame]
-
     def change_rgb_values(self, r, g, b):
         self.r = r
         self.g = g
@@ -127,14 +138,18 @@ class Scene:
             self.items.append(item)
 
     def render(self):
-        buf = []
-        buf.append("\033[2J\033[H") 
-        
-        for item in self.items:
-            color_code = f"\033[38;2;{item.r};{item.g};{item.b}m"
-            reset_code = "\033[0m"
-            # Move cursor to Y, X and print
-            buf.append(f"\033[{item.y+1};{item.x+1}H{color_code}{item.text}{reset_code}")
-            
-        sys.stdout.write("".join(buf))
-        sys.stdout.flush()
+        try:
+            buf = []
+            buf.append("\033[H") 
+            buf.append("\033[J") 
+
+            for item in self.items:
+                color = f"\033[38;2;{item.r};{item.g};{item.b}m"
+                # Standard X, Y positioning
+                pos = f"\033[{int(item.y)+1};{int(item.x)+1}H"
+                buf.append(f"{pos}{color}{item.text}\033[0m")
+                
+            sys.stdout.write("".join(buf))
+            sys.stdout.flush()
+        except KeyboardInterrupt:
+            sys.exit()

{animpy-1.2 → animpy-1.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "animpy"
-version = "1.2"
+version = "1.3"
 description = "A simple terminal animation library"
 authors = [
   {name = "Samin Riyaz"}
@@ -10,7 +10,7 @@ requires-python = ">=3.8"
 license = {file = "LICENSE"}
 
 [build-system]
-requires = ["setuptools"]
+requires = ["setuptools", "wheel", "pygame-ce"]
 build-backend = "setuptools.build_meta"
 
 [project.urls]