greetron 0.1.2

A lightweight library to generate formal and informal greetings and goodbyes.

---

🤖 Greetron

Greetron is a lightweight Python package designed for chatbots and virtual assistants that need friendly, professional, or informal greetings and goodbyes — with optional personalization via the user's name.

---

✨ Features

• ✅ Randomized greetings and goodbyes
• ✅ Supports formal and informal tones
• ✅ Adds the user’s name naturally into responses
• ✅ Lightweight and dependency-free

---

📦 Installation

If published to PyPI:

pip install greetron

For local usage:

# Clone this repository or copy the greetron directory
cd your_project/
pip install -e .

---

🚀 Usage

from greetron import get_random_greeting, get_random_goodbye

print(get_random_greeting())  # Informal greeting
print(get_random_greeting("Aryan"))  # Informal greeting with name
print(get_random_greeting("Aryan", mode="formal"))  # Formal greeting with name

print(get_random_goodbye())  # Informal goodbye
print(get_random_goodbye("Aryan"))  # Informal goodbye with name
print(get_random_goodbye("Aryan", mode="formal"))  # Formal goodbye with name

---

📂 Greeting Modes

Mode	Description
formal	Professional tone (e.g., business/chatbots)
informal	Friendly/casual tone for personal bots

---

🔧 Function Signatures

get_random_greeting(name: str = None, mode: str = "informal") -> str
get_random_goodbye(name: str = None, mode: str = "informal") -> str

• name: Optional — A user’s name to personalize the message
• mode: Optional — "formal" or "informal" tone

---

🧠 Example Output

get_random_greeting("Aryan", mode="formal")
# "Hello, Aryan! How may I assist you today?"

get_random_goodbye("Aryan", mode="informal")
# "Catch ya later, Aryan!"

---

📘 License

MIT License

---

Let me know if you'd like:

• Badge support (e.g., version, build)
• GitHub Actions setup for publishing to PyPI
• CLI or Streamlit demo interface