prank 0.1.0__py3-none-any.whl

prank/__init__.py

@@ -0,0 +1,142 @@
+"""Turns every uncaught exception into emotional damage."""
+
+import sys
+import random
+
+__version__ = "0.1.0"
+__all__ = ["install", "uninstall", "is_installed"]
+
+random_messages = [
+	"Stack Overflow is waiting for you.",
+	"git blame won't save you this time.",
+	"Expected behavior.",
+	"Feature, not a bug.",
+	"I'm disappointed in you.",
+	"Fucking bug.",
+	"It worked yesterday.",
+	"Congratulations, you found another bug.",
+	"Skill issue.",
+	"Have you tried turning it off and on again?",
+	"Who wrote this code?",
+]
+
+rare_messages = [
+	"This message has a 1% drop rate.",
+	"The debugger is judging you.",
+	"Congratulations, you found the developer's secret.",
+	"Error successfully generated.",
+	"Please don't report this.",
+	"The universe has decided against your code today.",
+	"Trust me, it's not DNS... probably.",
+	"This exception is sponsored by coffee.",
+	"404: Motivation not found.",
+	"Your bug has evolved.",
+	"Congratulations. This bug unlocks the secret ending.",
+	"You weren't supposed to see this.",
+	"Developer mode activated.",
+	"The bug is now self-aware.",
+	"Achievement unlocked: Segmentation Imagination.",
+]
+
+ultra_rare_messages = [
+	"You have been chosen.",
+	"Developer console unlocked.",
+	"Thanks for finding me.",
+	"This line exists solely for people with terrible luck.",
+]
+
+exception_messages = {
+	ZeroDivisionError: "Math is hard.",
+	FileNotFoundError: "The file has successfully escaped.",
+	KeyboardInterrupt: "Coward.",
+	MemoryError: "Have you considered downloading more RAM?",
+	RecursionError: "Have you tried recursing less?",
+	PermissionError: "The OS said no.",
+	AttributeError: "Maybe None isn't what you thought it was.",
+	KeyError: "The key has gone on vacation.",
+	(ImportError, ModuleNotFoundError): "pip install hope",
+	AssertionError: "Your assumptions were... optimistic.",
+	TypeError: "Those types were never meant to be together.",
+	IndexError: "That index is beyond the horizon.",
+	(NameError, UnboundLocalError): "Did you forget to introduce yourself?",
+	NotImplementedError: "Future you will deal with this.",
+	TimeoutError: "Patience.exe has stopped responding.",
+	UnicodeDecodeError: "Your bytes are speaking another language.",
+	UnicodeEncodeError: "Unicode strikes again.",
+	UnicodeTranslateError: "Lost in translation.",
+	UnicodeError: "Unicode is once again reminding us who's boss.",
+	ValueError: "Right type. Wrong value.",
+	BrokenPipeError: "The pipe has retired.",
+	OSError: "The operating system chose violence.",
+	RuntimeError: "Runtime had a bad day.",
+	EOFError: "The input gave up.",
+	OverflowError: "Congratulations, you found infinity.",
+	SyntaxError: "Python couldn't even parse your creativity.",
+	(IndentationError, TabError): "Tabs and spaces have declared war.",
+	StopIteration: "Nothing more to iterate. Literally.",
+	StopAsyncIteration: "The async universe has ended.",
+	ConnectionRefusedError: "The server left you on read.",
+	ConnectionResetError: "Connection rage-quit.",
+	ConnectionAbortedError: "The connection changed its mind.",
+	ConnectionError: "Have you tried blaming the internet?",
+	IsADirectoryError: "That's a folder. Nice try.",
+	NotADirectoryError: "Folders don't work that way.",
+	FileExistsError: "That file already exists. Like your bugs.",
+	InterruptedError: "Something interrupted your masterpiece.",
+	ProcessLookupError: "The process vanished into thin air.",
+	ChildProcessError: "The child process has run away.",
+	LookupError: "Whatever you wanted isn't here.",
+	ReferenceError: "That object has moved on.",
+	BufferError: "The buffer is buffering... too much.",
+	ArithmeticError: "Math has filed a complaint.",
+	FloatingPointError: "Floating point strikes again.",
+	BlockingIOError: "The operation is taking a coffee break.",
+	GeneratorExit: "The generator has retired peacefully.",
+	SystemError: "Congratulations. You confused Python itself.",
+	SystemExit: "See you next execution.",
+}
+
+old_hook = None
+_installed = False
+
+def my_hook(exc_type, exc_value, exc_tb):
+	if old_hook is not None:
+		old_hook(exc_type, exc_value, exc_tb)
+	msg = random.choice(random_messages)
+	for exception, message in exception_messages.items():
+		if issubclass(exc_type, exception):
+			msg = message
+			break
+	bad_luck = random.random()
+	if bad_luck < 0.001:
+		msg = random.choice(ultra_rare_messages)
+	elif bad_luck < 0.01:
+		msg = random.choice(rare_messages)
+	print(msg, file=sys.stderr)
+
+def install():
+	global _installed
+	if not _installed:
+		global old_hook
+		old_hook = sys.excepthook
+		sys.excepthook = my_hook
+		_installed = True
+		if random.random() < 0.01:
+			print("You shouldn't have installed me.", file=sys.stderr)
+		else:
+			print("Welcome, hope the bug comes your way.", file=sys.stderr)
+
+def uninstall():
+	global _installed
+	if _installed:
+		global old_hook
+		sys.excepthook = old_hook
+		old_hook = None
+		_installed = False
+		if random.random() < 0.001:
+			print("Goodbye. See you after the next bug.", file=sys.stderr)
+		else:
+			print("Goodbye, hope you had fun.", file=sys.stderr)
+
+def is_installed():
+	return _installed

prank-0.1.0.dist-info/METADATA

@@ -0,0 +1,167 @@
+Metadata-Version: 2.4
+Name: prank
+Version: 0.1.0
+Summary: Turns every uncaught exception into emotional damage.
+Author-email: Hoàng Long <hoanglongcodes@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Hoang-Long2012/Prank
+Project-URL: Repository, https://github.com/Hoang-Long2012/Prank
+Project-URL: Issues, https://github.com/Hoang-Long2012/Prank/issues
+Project-URL: Changelog, https://github.com/Hoang-Long2012/Prank/blob/main/CHANGELOG.md
+Keywords: prank,troll,traceback,exception,excepthook,debug,humor,fun,sarcasm
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# prank
+
+Turns every uncaught exception into emotional damage.
+
+> Tested on countless unfortunate exceptions.
+>
+> Side effects may include laughter, frustration, and questioning your life choices.
+
+> ⚠️ If you use this in production, we need to have a serious talk, dude.
+
+## Features
+
+- Does absolutely nothing useful.
+- Compatible with your worst debugging session.
+- Zero dependencies.
+- Zero configuration.
+- Zero benefits.
+- Maximum emotional damage.
+- Rare (1%) and Ultra Rare (0.1%) messages.
+- Makes every crash a little more memorable.
+- Makes Python just a little bit more sarcastic.
+
+## Installation
+
+```bash
+pip install prank
+```
+
+No restart required.
+
+Emotional damage starts immediately.
+
+## Usage
+
+```python
+import prank
+
+prank.install()
+```
+
+Congratulations.
+
+Your future exceptions are no longer alone.
+
+Now wait for your next bug.
+
+## Example
+
+Possible outputs:
+
+```text
+Traceback (most recent call last):
+...
+ZeroDivisionError: division by zero
+
+Math is hard.
+```
+
+```text
+RuntimeError: Oops
+
+Who wrote this code?
+```
+
+Or maybe...
+
+```text
+AttributeError: ...
+
+Maybe None isn't what you thought it was.
+```
+
+Or, if you're incredibly lucky...
+
+```text
+Developer console unlocked.
+```
+
+## API
+
+```python
+prank.install()
+```
+
+Enable prank mode.
+
+```python
+prank.uninstall()
+```
+
+Disable prank mode.
+
+```python
+prank.is_installed()
+```
+
+Returns whether prank is currently installed.
+
+## FAQ
+
+**Does it fix bugs?**
+
+No.
+
+**Does it improve debugging?**
+
+Also no.
+
+**Then what's the point?**
+
+Because debugging is already painful. It might as well be funny.
+
+**Is this a serious project?**
+
+No.
+
+**Is this a joke?**
+
+Yes.
+
+**Then why is the code actually well-written?**
+
+...
+
+**Can I disable it?**
+
+Yes.
+
+```python
+prank.uninstall()
+```
+
+## License
+
+Licensed under the [MIT License](LICENSE).
+
+No warranty.
+
+Especially emotional warranty.

prank-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+prank/__init__.py,sha256=A0C2aPf0ks39QyJAnkjmhGxyOAUNmJFALXjRqPIO5XI,5156
+prank-0.1.0.dist-info/licenses/LICENSE,sha256=c1qSpYLFRd3y_-AO7xnys7ntD8rcvVy7_E5Ue5-QIBo,1068
+prank-0.1.0.dist-info/METADATA,sha256=JjO7P5CysnU2JrQPm8QJLjqt9I9KUs7BCmEAanp6qSI,3309
+prank-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+prank-0.1.0.dist-info/top_level.txt,sha256=gIR3-0qiK0D_GuYWL58xHEDkalMMnqtz_OFEPpjPgLo,6
+prank-0.1.0.dist-info/RECORD,,

prank-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

prank-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hoàng Long
+
+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.

prank-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+prank