🌸 mathiarasi

A secret, personalized interactive terminal surprise experience made specifically for Mathiarasi.

╔══════════════════════════════════════════════════════╗
║                                                      ║
║                  M A T H I A R A S I                 ║
║                                                      ║
║              This terminal is only for you.          ║
║                                                      ║
╚══════════════════════════════════════════════════════╝

---

✨ Features

• 💫 Cinematic Opening: Smooth typewriter boot sequence, progress bars, and dramatic letter-by-letter name reveal.
• 💌 Heartfelt Letter: Slow typewriter-style personal letter.
• 🌟 Why You Are Special: Interactive page-by-page reveal of special memories and reasons.
• ⚡ Friendship.exe: Technical diagnostic simulation with compatibility scan, progress indicators, and playful warning.
• 🎲 Random Surprises: Over 20+ playful, uplifting, randomized messages.
• 😊 Smile Generator: Interactive smile probability scanner with real-time percentage progress.
• 🗝️ Secret Easter Eggs: Hidden codes and keywords (try entering 42 or mathiarasi) that unlock a secret appreciation screen.
• 🪶 Zero External Dependencies: Built 100% with the Python standard library. No network requests, no logins, no telemetry.
• 🖥️ Cross-Platform: Works smoothly on Windows PowerShell, Command Prompt, macOS Terminal, and Linux. Gracefully falls back to ASCII on older terminals.

---

🚀 Quickstart

1. Installation

Install via pip:

pip install mathiarasi

Or install locally in development mode:

git clone https://github.com/yourusername/mathiarasi.git
cd mathiarasi
pip install .

2. Launch

Simply type:

mathiarasi

---

🎮 Interactive Menu

Once launched, the terminal presents an interactive menu:

╭──────────────────────────────────────────────╮
│              WHAT DO YOU WANT TO DO?         │
├──────────────────────────────────────────────┤
│  [1] Open a little message                   │
│  [2] Why you are special                     │
│  [3] Friendship.exe                          │
│  [4] Random surprise                         │
│  [5] Make me smile                           │
│  [6] Exit                                    │
╰──────────────────────────────────────────────╯

Type a number (1-6) to explore each scene, or enter a secret code to unlock hidden surprises.

---

🎨 Customization

Every single word, message, reason, and easter egg lives in one easy-to-edit file:

📁 src/mathiarasi/messages.py

Changing the Name or Tagline:

NAME = "Mathiarasi"
TAGLINE = "This terminal is only for you."

Adding or Modifying Reasons:

REASONS_SPECIAL = [
    ("Reason #01", "You make ordinary conversations memorable."),
    ("Reason #02", "Your presence can completely change the mood."),
    # Add your own personal reasons here!
]

Modifying Random Surprises:

RANDOM_SURPRISES = [
    "Today's reminder: You are someone's favorite notification.",
    "Plot twist: You were supposed to smile after reading this.",
    # Add your own surprises here!
]

Changing Secret Easter Egg Triggers:

SECRET_TRIGGERS = ["42", "mathiarasi", "mathia", "mathi", "secret", "smile"]

---

⚙️ Environment Variables

You can control animation speed and behavior using environment variables:

Variable	Description	Example
MATHIARASI_FAST	Skip all typing animations (useful for quick testing)	set MATHIARASI_FAST=1
MATHIARASI_SPEED	Animation speed multiplier (0.5 runs twice as fast)	set MATHIARASI_SPEED=0.5
NO_COLOR	Disables ANSI color output	set NO_COLOR=1

---

📦 Building and Publishing to PyPI

If you want Mathiarasi to be able to run pip install mathiarasi directly from anywhere in the world:

1. Install Build Tools

python -m pip install --upgrade build twine

2. Build Wheel and Source Distribution

python -m build

This generates .whl and .tar.gz distribution packages in the dist/ directory.

3. Check Package Validity

python -m twine check dist/*

4. Upload to PyPI

Create an API token at pypi.org and run:

python -m twine upload dist/*

Enter __token__ as the username and your PyPI token as the password.

Tip: If the name mathiarasi is already registered on PyPI by another user, you can change name = "mathiarasi-cli" in pyproject.toml. The executable command mathiarasi will remain exactly the same!

---

🧪 Running Tests

To run the automated test suite:

python -m pytest tests/ -v

---

📄 License

MIT License. Crafted with thought and care.