shinyshell
_{The Most Feature-Rich Zero-Dependency Python Terminal Library}

130+ features. 0 dependencies. Pure Python stdlib.
Tables, charts, progress bars, games, QR codes, code highlighting, HTTP client,
JSON/YAML/XML formatters, and much more — all in one import.

✨ Why shinyshell?

from shinyshell import Shell
sh = Shell()

sh.success("Deployed!")            # ✨ Green success
sh.table(users, title="Team")      # 📊 Professional table
sh.pie({"Python": 45, "JS": 30})   # 📈 ASCII chart
sh.qr("https://github.com")        # 📱 Terminal QR code
sh.progress("Uploading")           # 🔄 Animated progress
sh.confetti(5)                     # 🎉 Confetti!

One import. Zero dependencies. All the pretty your terminal deserves.

✦ Key Selling Points

📊 Feature Distribution

🆚 vs Alternatives

shinyshell = Rich's features + Colorama's portability + 80 extra features — all with zero deps.

🚀 Quick Start

Install

pip install shinyshell

Hello World

from shinyshell import Shell

sh = Shell()
sh.success("Hello, shiny terminal! ✨")

5-Second Tour

sh = Shell()

# Messages
sh.success("Done!") · sh.error("Failed!") · sh.warning("Careful!") · sh.info("Running...")

# Tables & Charts
sh.table([{"Name": "Ada", "Lang": "Python"}], title="Team")
sh.bar({"A": 85, "B": 62, "C": 45})
sh.radar_chart({"Speed": 80, "Power": 60, "Range": 90}, "Robot")

# Progress
sh.progress("Uploading")

# Games & Fun
sh.magic8() · sh.dice(6, 2) · sh.matrix(5) · sh.confetti(3)

# Data
sh.json({"hello": "world"}) · sh.qr("https://github.com")

📚 Complete Feature Reference

💬 Messages & Status

sh.success("Done!")       # ✨ Green success
sh.error("Failed!")       # 💥 Red error
sh.warning("Careful!")    # ⚠️ Yellow warning
sh.info("Running...")     # ℹ️ Cyan info

📐 Layout & Headers

sh.header("MY APP")        # ╔═ Boxed header
sh.banner("SHINY")         # ASCII art banner
sh.hr()                    # ─── Horizontal rule
sh.box("content", "Title") # ╭─ Boxed content
sh.rule()                  # Gradient rule

📊 Tables & Data

sh.table(users, title="Team")          # Professional tables
sh.metrics({"CPU":"45%","RAM":"8GB"})  # Key-value dashboard
sh.timeline(events)                     # Vertical timeline
sh.columns(items, cols=3)              # Side-by-side columns
sh.grid(items, cols=2)                 # Grid layout

📈 Charts & Visualizations

sh.pie({"Python":45,"JS":30,"Go":25})        # ASCII pie chart
sh.bar({"A":85,"B":62,"C":45})                 # Bar chart
sh.line_chart([1,5,2,8,3,9])                   # Line chart
sh.histogram([1,2,2,3,3,3,4,5])               # Histogram
sh.scatter([(1,2),(3,5),(4,3)])                # Scatter plot
sh.waterfall([("Start",100),("+Sales",50)])    # Waterfall chart
sh.donut({"A":30,"B":70})                       # Donut chart
sh.bullet_graph("Revenue", 75, 90)              # Bullet graph
sh.heatmap([[1,2,3],[4,5,6],[7,8,9]])          # Heatmap
sh.sparkline([1,5,2,8,3,9])                    # ▁▃▁▆▂█
sh.gauge(75, 100, "CPU")                       # Gauge meter
sh.radar_chart({"Spd":80,"Pwr":60}, "Robot")   # 🕸️ Radar chart
sh.funnel_chart([("Visit",1000),("Paid",100)]) # Funnel chart

🔄 Progress & Loading

sh.spinner("Loading...", 3.0)         # Animated spinner
sh.progress("Uploading")              # Progress bar
sh.countdown(5, "Launching")          # 5...4...3...
sh.benchmark("Processing")            # ⏱️ Timed context
sh.live()                             # Live-updating display
sh.steps("Deploy", total=5)           # Step tracker
sh.timer(30, "Break")                 # Countdown timer
sh.pomodoro(25, 5, 4)                 # 🍅 Pomodoro timer

💻 Code & Development

sh.code(python_source)                # Syntax highlighting
sh.diff(old, new)                     # Colored git diff
sh.git_log(10)                        # Pretty git log
sh.git_status()                       # Pretty git status
sh.stack_trace()                      # Pretty stack trace
sh.process_info()                     # Process metrics
sh.pip_list("django")                 # Pretty pip list
sh.filewatch("app.py")                # File change watcher

🌐 Network & Web

sh.http("GET", "https://api.example.com")  # HTTP viewer
sh.network_ping("google.com")              # Ping with visuals
sh.network_status("https://example.com")   # HTTP status check
sh.dns_lookup("google.com")                # DNS lookup
sh.ip_info("8.8.8.8")                      # IP geolocation

📁 Files & System

sh.tree("./src")                      # Directory tree
sh.disk_usage("/")                    # Disk usage gauge
sh.file_permissions("app.py")         # Permission viewer
sh.checksum("file.bin", "sha256")     # File hash
sh.config(".env")                     # Config file viewer
sh.csv("data.csv")                    # CSV viewer
sh.sql_table(rows)                    # SQL result viewer
sh.env("PYTHON")                      # Environment viewer

📄 Data Formats

sh.json(data)                         # Colored JSON
sh.markdown(text)                     # Terminal markdown
sh.xml("<root><item/></root>")        # Colored XML
sh.yaml_view(yaml_text)               # YAML viewer
sh.hexdump(b"hello world")            # Hex dump
sh.jwt_decode(token)                  # JWT decoder
sh.url_parse(url)                     # URL parser
sh.base64_encode("hello")             # Base64 encode
sh.uuid_gen(5)                        # UUID generator

🔐 Security & Debug

sh.secret("sk-abc123")                # sk-****123
sh.password("Enter key:")             # Masked input + strength
sh.debug(user, status)                # Type + value + location
sh.trace                              # @sh.trace decorator
sh.dict_diff(old, new)                # Deep dict comparison

🎮 Games & Fun

sh.slot(5)                            # 🍒 Slot machine
sh.coin_flip()                        # 🪙 Coin flip
sh.magic8()                           # 🎱 Magic 8 ball
sh.dice(6, 2)                         # 🎲 Dice roller
sh.spin_wheel(["A","B","C"])          # 🎡 Spin wheel
sh.matrix(10)                         # Matrix rain
sh.confetti(5)                        # 🎉 Confetti
sh.marquee("Breaking News!")          # Scrolling text
sh.particles(5)                       # Particle animation
sh.tic_tac_toe()                      # 🎮 Tic-Tac-Toe (2-player)
sh.wordle()                           # 🟩 Terminal Wordle

🎨 Visual Effects

sh.rainbow("Hello World")             # 🌈 Rainbow text
sh.gradient_text("Gradient")          # Color gradient
sh.neon("NEON")                       # Neon glow
sh.typewrite("Hello...")              # Typewriter effect
sh.color_picker()                     # ANSI color browser
sh.color_grid()                       # RGB color grid

📝 Text Utilities

sh.wrap_text(long_text, width=60)     # Word wrap
sh.truncate(text, 50)                 # Smart truncation
sh.align_text("Hi", 40, "center")     # Text alignment
sh.highlight(text, "keyword")         # Keyword highlight
sh.ordinal(42)                        # → "42nd"
sh.pluralize("file", 3)               # → "files"
sh.camel_case("hello world")          # → "helloWorld"
sh.snake_case("HelloWorld")           # → "hello_world"
sh.strip_ansi(escaped)                # Remove ANSI
sh.slugify("Hello World!")            # → "hello-world"
sh.bytes_format(1536)                 # → "1.5 KB"
sh.duration(3661)                     # → "1h 1m 1s"
sh.percent(45, 200)                   # → "22.5%"

🖼️ Images & QR

sh.qr("https://github.com")           # Terminal QR code
sh.image("photo.jpg", width=80)       # Image → ASCII (needs Pillow)
sh.screenshot("output.txt")           # Capture terminal

⌨️ Interactive

sh.confirm("Deploy?")                 # Yes/No prompt
sh.choice("Select:", ["A","B","C"])   # Pick from list
sh.input("Name:", default="World")    # Styled input
sh.form([("Name:",str),("Age:",int)]) # Multi-field form
sh.toggle("Dark Mode", True)          # Toggle switch
sh.autocomplete("Search:", options)   # Filter-as-you-type
sh.menu(["Deploy","Rollback"])        # Arrow-key menu

🎧 Audio & Clipboard

sh.audio_beep(3)                      # Terminal beep
sh.audio_ding()                       # System ding
sh.clipboard_copy("Hello")            # Copy to clipboard
sh.notify("Build complete")           # Desktop notification

🔧 Decorators & Utils

@sh.trace                             # Auto-log function calls
@sh.retry(3)                          # Auto-retry on failure
@sh.throttle(1.0)                     # Rate limiting
@sh.background                        # Run in background thread

sh.batch(items, 10, callback=fn)      # Batch processor
sh.sleep(5, "Cooling down")           # Pretty sleep
sh.password_generate(16)              # Secure random password
sh.hash_text("hello")                 # → sha256 hex

🔗 Utility Methods

sh.link("GitHub", url)                # Clickable link
sh.badge("v7.0", "green")             # Colored badge
sh.emoji("rocket")                    # → 🚀
sh.venn({1,2,3}, {2,3,4})             # Set comparison
sh.calendar(2026, 7)                  # Monthly calendar
sh.pipe(data).table().metrics()       # Chained output

📼 Session

sh.session_start("debug")             # Record session
# ... your code ...
sh.session_stop()                     # Stop recording

📈 Growth & Stats

🤝 Contributing

Pull requests are welcome! See CONTRIBUTING.md for guidelines.

git clone https://github.com/adnanahamed66772ndpc/shinyshell.git
cd shinyshell
python -m pytest tests/

⭐ Support

If this library saved you time, star the repo and share it!

pip install shinyshell --upgrade

_{MIT © 2026 Adnan Ahamed Himal · Crafted with ✨ in Bangladesh}