suserror 0.2.0__tar.gz

suserror-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ketan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

suserror-0.2.0/PKG-INFO

@@ -0,0 +1,123 @@
+Metadata-Version: 2.4
+Name: suserror
+Version: 0.2.0
+Summary: A lightweight developer utility that plays professional/chaotic sound effects on Python exceptions.
+Author-email: Ketan <dev@example.com>
+Project-URL: Homepage, https://github.com/Ketan6969/suserror
+Project-URL: Bug Tracker, https://github.com/Ketan6969/suserror/issues
+Keywords: error,sound,utility,debugging,fun,exception
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Debuggers
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pygame>=2.0.0
+Dynamic: license-file
+
+# 🚨 suserror
+
+[![PyPI version](https://img.shields.io/pypi/v/suserror.svg)](https://pypi.org/project/suserror/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python Versions](https://img.shields.io/pypi/pyversions/suserror.svg)](https://pypi.org/project/suserror/)
+
+**suserror** is a lightweight, fun developer utility that turns your Python exceptions into an auditory experience. Whether you want a subtle alert or total chaos, `suserror` ensures you *hear* your mistakes.
+
+---
+
+## ✨ Features
+
+- 🎧 **Instant Feedback**: Plays a random sound whenever an exception goes uncaught.
+- ⚡ **Non-blocking**: Sound playback happens in a daemon thread; your program won't freeze.
+- 🎭 **Sound Modes**: Choose between `subtle` for a quick heads-up or `chaotic` for maximum impact.
+- 🛠️ **Customizable**: Drop your own `.mp3` files into the `sounds/` folder to personalize your errors.
+- 🐍 **Universal**: Works seamlessly with any Python 3.8+ project.
+
+---
+
+## 🚀 Installation
+
+For the best experience, install `suserror` in a virtual environment:
+
+```bash
+# Create a virtual environment
+python3 -m venv venv
+source venv/bin/activate
+
+# Install suserror
+pip install .
+```
+
+*Note: Depends on `pygame` for high-quality audio handling.*
+
+---
+
+## 📖 Usage
+
+### 🧙‍♂️ Automatic Mode (The "Set and Forget")
+Just one line at the top of your script, and you're good to go. All uncaught exceptions will trigger a random sound.
+
+```python
+import suserror
+
+# Start the auto-hook (default mode is 'all')
+suserror.auto()
+
+# Any error below will trigger a sound
+1 / 0 
+```
+
+### 🎭 Switching Modes
+You can control the vibe of your errors by passing a `mode` to `auto()`.
+
+```python
+# For a more professional/minimalist feel
+suserror.auto(mode="subtle")
+
+# For when you really messed up
+suserror.auto(mode="chaotic")
+```
+
+### 🕹️ Manual Mode
+Trigger a sound effect programmatically whenever you want.
+
+```python
+import suserror
+
+try:
+    process_sensitive_data()
+except DataError:
+    suserror.play_error(mode="chaotic")
+    # Log the error or handle it
+```
+
+---
+
+## 📂 Sound Categories
+
+The package comes with several pre-bundled sounds categorized as follows:
+
+- **Subtle**: Minimalist pings and short alerts (e.g., `anime-ahh.mp3`).
+- **Chaotic**: Longer, louder, or more "sus" sounds (e.g., `among-us-role-reveal-sound.mp3`, `fahhhhhhhhhhhhhh.mp3`).
+
+---
+
+## 🛠️ Development & Customization
+
+To add your own sound effects:
+1. Navigate to the `suserror/sounds/` directory.
+2. Drop your `.mp3` files there.
+3. (Optional) Update `SOUND_MODES` in `player.py` to categorize them.
+
+---
+
+## 📜 License
+
+Distributed under the MIT License. See `LICENSE` for more information.
+
+---
+
+<p align="center">Made with ❤️ for the Python community</p>

suserror-0.2.0/README.md

@@ -0,0 +1,103 @@
+# 🚨 suserror
+
+[![PyPI version](https://img.shields.io/pypi/v/suserror.svg)](https://pypi.org/project/suserror/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python Versions](https://img.shields.io/pypi/pyversions/suserror.svg)](https://pypi.org/project/suserror/)
+
+**suserror** is a lightweight, fun developer utility that turns your Python exceptions into an auditory experience. Whether you want a subtle alert or total chaos, `suserror` ensures you *hear* your mistakes.
+
+---
+
+## ✨ Features
+
+- 🎧 **Instant Feedback**: Plays a random sound whenever an exception goes uncaught.
+- ⚡ **Non-blocking**: Sound playback happens in a daemon thread; your program won't freeze.
+- 🎭 **Sound Modes**: Choose between `subtle` for a quick heads-up or `chaotic` for maximum impact.
+- 🛠️ **Customizable**: Drop your own `.mp3` files into the `sounds/` folder to personalize your errors.
+- 🐍 **Universal**: Works seamlessly with any Python 3.8+ project.
+
+---
+
+## 🚀 Installation
+
+For the best experience, install `suserror` in a virtual environment:
+
+```bash
+# Create a virtual environment
+python3 -m venv venv
+source venv/bin/activate
+
+# Install suserror
+pip install .
+```
+
+*Note: Depends on `pygame` for high-quality audio handling.*
+
+---
+
+## 📖 Usage
+
+### 🧙‍♂️ Automatic Mode (The "Set and Forget")
+Just one line at the top of your script, and you're good to go. All uncaught exceptions will trigger a random sound.
+
+```python
+import suserror
+
+# Start the auto-hook (default mode is 'all')
+suserror.auto()
+
+# Any error below will trigger a sound
+1 / 0 
+```
+
+### 🎭 Switching Modes
+You can control the vibe of your errors by passing a `mode` to `auto()`.
+
+```python
+# For a more professional/minimalist feel
+suserror.auto(mode="subtle")
+
+# For when you really messed up
+suserror.auto(mode="chaotic")
+```
+
+### 🕹️ Manual Mode
+Trigger a sound effect programmatically whenever you want.
+
+```python
+import suserror
+
+try:
+    process_sensitive_data()
+except DataError:
+    suserror.play_error(mode="chaotic")
+    # Log the error or handle it
+```
+
+---
+
+## 📂 Sound Categories
+
+The package comes with several pre-bundled sounds categorized as follows:
+
+- **Subtle**: Minimalist pings and short alerts (e.g., `anime-ahh.mp3`).
+- **Chaotic**: Longer, louder, or more "sus" sounds (e.g., `among-us-role-reveal-sound.mp3`, `fahhhhhhhhhhhhhh.mp3`).
+
+---
+
+## 🛠️ Development & Customization
+
+To add your own sound effects:
+1. Navigate to the `suserror/sounds/` directory.
+2. Drop your `.mp3` files there.
+3. (Optional) Update `SOUND_MODES` in `player.py` to categorize them.
+
+---
+
+## 📜 License
+
+Distributed under the MIT License. See `LICENSE` for more information.
+
+---
+
+<p align="center">Made with ❤️ for the Python community</p>

suserror-0.2.0/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "suserror"
+version = "0.2.0"
+authors = [
+  { name="Ketan", email="dev@example.com" },
+]
+description = "A lightweight developer utility that plays professional/chaotic sound effects on Python exceptions."
+readme = "README.md"
+requires-python = ">=3.8"
+keywords = ["error", "sound", "utility", "debugging", "fun", "exception"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Debuggers",
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "pygame>=2.0.0",
+]
+
+[project.urls]
+"Homepage" = "https://github.com/Ketan6969/suserror"
+"Bug Tracker" = "https://github.com/Ketan6969/suserror/issues"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["suserror*"]
+
+[tool.setuptools.package-data]
+suserror = ["sounds/*.mp3"]

suserror-0.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

suserror-0.2.0/suserror/__init__.py

@@ -0,0 +1,35 @@
+import sys
+from .player import play_error
+
+__all__ = ["play_error", "auto"]
+
+_original_excepthook = None
+_current_mode = "all"
+
+def _sus_excepthook(type, value, traceback):
+    """Custom excepthook that plays a sound and then calls the original hook."""
+    play_error(mode=_current_mode)
+    if _original_excepthook:
+        _original_excepthook(type, value, traceback)
+    else:
+        sys.__excepthook__(type, value, traceback)
+
+def auto(mode="all"):
+    """
+    Attaches suserror to sys.excepthook for automatic sound playback on uncaught exceptions.
+    
+    Args:
+        mode (str): 'subtle', 'chaotic', or 'all' (default).
+    """
+    global _original_excepthook, _current_mode
+    _current_mode = mode
+    if sys.excepthook is not _sus_excepthook:
+        _original_excepthook = sys.excepthook
+        sys.excepthook = _sus_excepthook
+
+def stop():
+    """Restores the original excepthook."""
+    global _original_excepthook
+    if _original_excepthook:
+        sys.excepthook = _original_excepthook
+        _original_excepthook = None

suserror-0.2.0/suserror/player.py

@@ -0,0 +1,83 @@
+import os
+import random
+import threading
+import pygame
+
+# Initialize pygame mixer
+try:
+    pygame.mixer.init()
+except Exception:
+    pass
+
+def _play_sound_sync(sound_path):
+    """Internal helper to play sound synchronously in a thread."""
+    try:
+        if not pygame.mixer.get_init():
+            pygame.mixer.init()
+        
+        sound = pygame.mixer.Sound(sound_path)
+        sound.play()
+        
+        # Wait for the sound to finish playing
+        while pygame.mixer.get_busy():
+            pygame.time.delay(100)
+    except Exception:
+        # Gracefully handle audio errors
+        pass
+
+# Sound categories based on user-provided files
+SOUND_MODES = {
+    "subtle": [
+        "anime-ahh.mp3",
+        "gopgopgop.mp3"
+    ],
+    "chaotic": [
+        "among-us-role-reveal-sound.mp3",
+        "fahhhhhhhhhhhhhh.mp3",
+        "jhinka-chika-jhinka-chika.mp3",
+        "kya-cheda-bhosdi.mp3"
+    ]
+}
+
+def play_error(mode="all"):
+    """
+    Plays a random sound from the bundled sounds directory in a non-blocking thread.
+    
+    Args:
+        mode (str): One of 'subtle', 'chaotic', or 'all' (default).
+    """
+    try:
+        # Get the path to the sounds directory relative to this file
+        current_dir = os.path.dirname(os.path.abspath(__file__))
+        sounds_dir = os.path.join(current_dir, "sounds")
+        
+        if not os.path.exists(sounds_dir):
+            return
+
+        # List all mp3 files in the sounds directory
+        all_sounds = [f for f in os.listdir(sounds_dir) if f.endswith(".mp3")]
+        
+        if not all_sounds:
+            return
+
+        # Filter sounds based on mode
+        if mode in SOUND_MODES:
+            # Use only sounds that exist in the directory AND are in the mode list
+            available_in_mode = [s for s in SOUND_MODES[mode] if s in all_sounds]
+            if available_in_mode:
+                sounds_to_choose = available_in_mode
+            else:
+                # Fallback to all sounds if mode exists but none of its sounds are found
+                sounds_to_choose = all_sounds
+        else:
+            sounds_to_choose = all_sounds
+
+        # Randomly select a sound
+        selected_sound = random.choice(sounds_to_choose)
+        sound_path = os.path.join(sounds_dir, selected_sound)
+
+        # Play sound in a new thread to avoid blocking
+        threading.Thread(target=_play_sound_sync, args=(sound_path,), daemon=True).start()
+    except Exception:
+        # Gracefully handle all errors to avoid crashing the main application
+        pass

suserror-0.2.0/suserror.egg-info/PKG-INFO

@@ -0,0 +1,123 @@
+Metadata-Version: 2.4
+Name: suserror
+Version: 0.2.0
+Summary: A lightweight developer utility that plays professional/chaotic sound effects on Python exceptions.
+Author-email: Ketan <dev@example.com>
+Project-URL: Homepage, https://github.com/Ketan6969/suserror
+Project-URL: Bug Tracker, https://github.com/Ketan6969/suserror/issues
+Keywords: error,sound,utility,debugging,fun,exception
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Debuggers
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pygame>=2.0.0
+Dynamic: license-file
+
+# 🚨 suserror
+
+[![PyPI version](https://img.shields.io/pypi/v/suserror.svg)](https://pypi.org/project/suserror/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python Versions](https://img.shields.io/pypi/pyversions/suserror.svg)](https://pypi.org/project/suserror/)
+
+**suserror** is a lightweight, fun developer utility that turns your Python exceptions into an auditory experience. Whether you want a subtle alert or total chaos, `suserror` ensures you *hear* your mistakes.
+
+---
+
+## ✨ Features
+
+- 🎧 **Instant Feedback**: Plays a random sound whenever an exception goes uncaught.
+- ⚡ **Non-blocking**: Sound playback happens in a daemon thread; your program won't freeze.
+- 🎭 **Sound Modes**: Choose between `subtle` for a quick heads-up or `chaotic` for maximum impact.
+- 🛠️ **Customizable**: Drop your own `.mp3` files into the `sounds/` folder to personalize your errors.
+- 🐍 **Universal**: Works seamlessly with any Python 3.8+ project.
+
+---
+
+## 🚀 Installation
+
+For the best experience, install `suserror` in a virtual environment:
+
+```bash
+# Create a virtual environment
+python3 -m venv venv
+source venv/bin/activate
+
+# Install suserror
+pip install .
+```
+
+*Note: Depends on `pygame` for high-quality audio handling.*
+
+---
+
+## 📖 Usage
+
+### 🧙‍♂️ Automatic Mode (The "Set and Forget")
+Just one line at the top of your script, and you're good to go. All uncaught exceptions will trigger a random sound.
+
+```python
+import suserror
+
+# Start the auto-hook (default mode is 'all')
+suserror.auto()
+
+# Any error below will trigger a sound
+1 / 0 
+```
+
+### 🎭 Switching Modes
+You can control the vibe of your errors by passing a `mode` to `auto()`.
+
+```python
+# For a more professional/minimalist feel
+suserror.auto(mode="subtle")
+
+# For when you really messed up
+suserror.auto(mode="chaotic")
+```
+
+### 🕹️ Manual Mode
+Trigger a sound effect programmatically whenever you want.
+
+```python
+import suserror
+
+try:
+    process_sensitive_data()
+except DataError:
+    suserror.play_error(mode="chaotic")
+    # Log the error or handle it
+```
+
+---
+
+## 📂 Sound Categories
+
+The package comes with several pre-bundled sounds categorized as follows:
+
+- **Subtle**: Minimalist pings and short alerts (e.g., `anime-ahh.mp3`).
+- **Chaotic**: Longer, louder, or more "sus" sounds (e.g., `among-us-role-reveal-sound.mp3`, `fahhhhhhhhhhhhhh.mp3`).
+
+---
+
+## 🛠️ Development & Customization
+
+To add your own sound effects:
+1. Navigate to the `suserror/sounds/` directory.
+2. Drop your `.mp3` files there.
+3. (Optional) Update `SOUND_MODES` in `player.py` to categorize them.
+
+---
+
+## 📜 License
+
+Distributed under the MIT License. See `LICENSE` for more information.
+
+---
+
+<p align="center">Made with ❤️ for the Python community</p>

suserror-0.2.0/suserror.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+LICENSE
+README.md
+pyproject.toml
+suserror/__init__.py
+suserror/player.py
+suserror.egg-info/PKG-INFO
+suserror.egg-info/SOURCES.txt
+suserror.egg-info/dependency_links.txt
+suserror.egg-info/requires.txt
+suserror.egg-info/top_level.txt
+suserror/sounds/among-us-role-reveal-sound.mp3
+suserror/sounds/anime-ahh.mp3
+suserror/sounds/fahhhhhhhhhhhhhh.mp3
+suserror/sounds/gopgopgop.mp3
+suserror/sounds/jhinka-chika-jhinka-chika.mp3
+suserror/sounds/kya-cheda-bhosdi.mp3

suserror-0.2.0/suserror.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

suserror-0.2.0/suserror.egg-info/requires.txt

@@ -0,0 +1 @@
+pygame>=2.0.0

suserror-0.2.0/suserror.egg-info/top_level.txt

@@ -0,0 +1 @@
+suserror