python-vibe 0.1.2

make your boring python scripts look like a movie

⚡ PYTHON_VIBE

██████╗░██╗░░░██╗████████╗██╗░░██╗░█████╗░███╗░░██╗  ██╗░░░██╗██╗██████╗░███████╗
██╔══██╗╚██╗░██╔╝╚══██╔══╝██║░░██║██╔══██╗████╗░██║  ██║░░░██║██║██╔══██╗██╔════╝
██████╔╝░╚████╔╝░░░░██║░░░███████║██║░░██║██╔██╗██║  ╚██╗░██╔╝██║██████╦╝█████╗░░
██╔═══╝░░░╚██╔╝░░░░░██║░░░██╔══██║██║░░██║██║╚████║  ░╚████╔╝░██║██╔══██╗██╔══╝░░
██║░░░░░░░░██║░░░░░░██║░░░██║░░██║╚█████╔╝██║░╚███║  ░░╚██╔╝░░██║██████╦╝███████╗
╚═╝░░░░░░░░╚═╝░░░░░░╚═╝░░░╚═╝░░╚═╝░╚════╝░╚═╝░░╚══╝  ░░░╚═╝░░░╚═╝╚═════╝░╚══════╝

Make your boring Python scripts look like a fucking movie 🎬

---

🤔 WHAT IS THIS

You write Python. Your terminal output looks like dogwater. python_vibe fixes that. With zero effort.

Two lines. That’s it.

import python_vibe
python_vibe.enable()

Now every print, every loop, every error, every table — automatic cinema. No rewrites. No boilerplate. Your existing code just... glows up.

---

📦 INSTALL

pip install python-vibe

Want the full dashboard mode (Textual TUI)?

pip install python-vibe[full]

---

🚀 QUICK START

BEFORE python_vibe 😭

data = {"name": "rahul", "score": 99, "city": "bhopal"}
print(data)
# {'name': 'rahul', 'score': 99, 'city': 'bhopal'}

for i in range(100):
    process(i)
# [nothing. just cursor blinking. you questioning your life choices.]

---

AFTER python_vibe 🔥

import python_vibe
python_vibe.enable()

data = {"name": "rahul", "score": 99, "city": "bhopal"}
print(data)
# ┌─────────────────────────────────┐
# │  name   │  score  │    city    │
# ├─────────┼─────────┼────────────┤
# │  rahul  │   99    │  bhopal    │
# └─────────────────────────────────┘

for i in python_vibe.track(range(100)):
    process(i)
# ⠿ Processing  ████████████░░░░  73%  [0:00:02] item 73/100

---

🎬 DEMO

📸 [GIF PLACEHOLDER] — imagine a dark terminal with neon green animations, animated progress bars, beautiful tables, glowing error panels. yeah. that’s this. gif coming soon.

---

📋 TABLE OF CONTENTS

• Install
• Quick Start
• Theme Gallery
• Features
• API Reference
• Why It Slaps
• Examples
• Contributing

---

🎨 THEME GALLERY

python_vibe ships with 10 handcrafted themes. pick your vibe.

theme	description	feel
cyber	neon blue + electric green	hacker movie protagonist
masala	warm oranges, saffron, reds	chai, spice, chaos
chai_mode	earthy browns, soft gold	2am chai and chill
neon	rgb overload	synthwave fever dream
retro	amber/green CRT vibes	old-school cool
dracula	purple + pink	dev classic
ocean	cool blues	clean + focused
desi_chaos	random colours	pure anarchy
minimal	no colors	boss walked in
midnight	navy + lavender	3am grind

python_vibe.set_theme("masala")
python_vibe.set_theme("cyber")
python_vibe.set_theme("chai_mode")

---

✨ FEATURES

• 🖨️ Auto pretty print — dicts, lists, dataframes → instant tables
• 📊 Smart progress — wrap any loop with track()
• 💥 Cinematic errors — styled exceptions with context
• 🎨 10 themes — swap instantly
• 📋 Auto tables — list-of-dicts → table
• 🧰 Logging takeover — beautifies logging output
• ⏱️ @vibe decorator — timing + logs
• 🖥️ Live dashboard — optional TUI ([full])
• 🏥 Error doctor — smart hints (WIP)
• ☕ Masala mode — because bhopal

---

📖 API REFERENCE

import python_vibe

# core
python_vibe.enable()
python_vibe.disable()
python_vibe.set_theme("cyber")

# progress
for item in python_vibe.track(data, desc="crunching"):
    process(item)

# decorators
@python_vibe.vibe
def my_function():
    ...

# logs
python_vibe.log("something happened")
python_vibe.success("it worked!")
python_vibe.warn("hmm")
python_vibe.error("oh no")

# tables
python_vibe.table(list_of_dicts)
python_vibe.inspect(obj)

# dashboard
python_vibe.start_dashboard()

---

🔥 WHY IT SLAPS

rich is great — but you rewrite everything loguru is cool — but it’s just logs textual is powerful — but it’s a framework

python_vibe → zero effort, instant upgrade

your existing code. no changes. just vibes.

---

📁 EXAMPLES

check the examples/ folder:

• simple_script.py
• data_pipeline.py
• training_loop.py
• fastapi_demo.py

cd examples
python training_loop.py

---

🤝 CONTRIBUTING

PRs welcome. issues welcome. vibes mandatory.

git clone https://github.com/Nightmare-De9/python_vibe
cd python_vibe
pip install -e ".[dev]"
pytest tests/

ideas:

• new themes
• better error suggestions
• jupyter support
• smarter detection

---

📜 LICENSE

MIT — do whatever. just don’t remove the chai ☕

---

If this made your terminal less ugly, smash that ⭐ Built with ☕ chai and sleep deprivation in Bhopal