phi-hippo 0.1.0__py3-none-any.whl

phi_hippo/__init__.py

@@ -0,0 +1,12 @@
+"""
+phi_hippo - A fun greeting utility package.
+
+Generate personalized greetings, motivational quotes, and ASCII art banners.
+"""
+
+from .greetings import greet, motivate, banner, random_greeting
+from .colors import colorize
+
+__version__ = "0.1.0"
+__author__ = "Your Name"
+__all__ = ["greet", "motivate", "banner", "random_greeting", "colorize"]

phi_hippo/cli.py

@@ -0,0 +1,66 @@
+"""Command-line interface for phi_hippo."""
+
+import argparse
+from . import greet, motivate, banner, colorize, __version__
+
+
+def main():
+    """Entry point for the phi_hippo CLI."""
+    parser = argparse.ArgumentParser(
+        prog="phi_hippo",
+        description="🎉 phi_hippo - Generate fun greetings from your terminal!",
+    )
+    parser.add_argument(
+        "-v", "--version", action="version", version=f"phi_hippo {__version__}"
+    )
+
+    subparsers = parser.add_subparsers(dest="command", help="Available commands")
+
+    # greet command
+    greet_parser = subparsers.add_parser("hello", help="Greet someone")
+    greet_parser.add_argument("name", help="Name of the person to greet")
+    greet_parser.add_argument(
+        "-s",
+        "--style",
+        choices=["friendly", "formal", "enthusiastic", "pirate"],
+        default="friendly",
+        help="Greeting style (default: friendly)",
+    )
+    greet_parser.add_argument(
+        "-c", "--color", default=None, help="Colorize the output"
+    )
+
+    # motivate command
+    subparsers.add_parser("motivate", help="Get a motivational quote")
+
+    # banner command
+    banner_parser = subparsers.add_parser("banner", help="Create an ASCII banner")
+    banner_parser.add_argument("text", help="Text for the banner")
+    banner_parser.add_argument(
+        "-w", "--width", type=int, default=50, help="Banner width (default: 50)"
+    )
+    banner_parser.add_argument(
+        "--char", default="=", help="Border character (default: =)"
+    )
+
+    args = parser.parse_args()
+
+    if args.command is None:
+        parser.print_help()
+        return
+
+    if args.command == "hello":
+        result = greet(args.name, args.style)
+        if args.color:
+            result = colorize(result, args.color)
+        print(result)
+
+    elif args.command == "motivate":
+        print(motivate())
+
+    elif args.command == "banner":
+        print(banner(args.text, char=args.char, width=args.width))
+
+
+if __name__ == "__main__":
+    main()

phi_hippo/colors.py

@@ -0,0 +1,42 @@
+"""Terminal color utilities for greetify."""
+
+
+# ANSI escape codes for terminal colors
+COLORS = {
+    "red": "\033[91m",
+    "green": "\033[92m",
+    "yellow": "\033[93m",
+    "blue": "\033[94m",
+    "magenta": "\033[95m",
+    "cyan": "\033[96m",
+    "white": "\033[97m",
+    "reset": "\033[0m",
+    "bold": "\033[1m",
+    "dim": "\033[2m",
+    "underline": "\033[4m",
+}
+
+
+def colorize(text: str, color: str = "green", bold: bool = False) -> str:
+    """
+    Add terminal color to text using ANSI escape codes.
+
+    Args:
+        text: The text to colorize.
+        color: The color name. Options: red, green, yellow, blue, magenta, cyan, white.
+        bold: If True, make the text bold.
+
+    Returns:
+        The text wrapped in ANSI color codes.
+
+    Example:
+        >>> from greetify import colorize
+        >>> print(colorize("Hello!", "cyan", bold=True))
+    """
+    if color not in COLORS:
+        raise ValueError(
+            f"Unknown color '{color}'. Choose from: {', '.join(c for c in COLORS if c not in ('reset', 'bold', 'dim', 'underline'))}"
+        )
+
+    prefix = COLORS.get("bold", "") if bold else ""
+    return f"{prefix}{COLORS[color]}{text}{COLORS['reset']}"

phi_hippo/greetings.py

@@ -0,0 +1,131 @@
+"""Core greeting functions for the greetify package."""
+
+import random
+from datetime import datetime
+
+
+def greet(name: str, style: str = "friendly") -> str:
+    """
+    Generate a personalized greeting.
+
+    Args:
+        name: The name of the person to greet.
+        style: The style of greeting. Options: 'friendly', 'formal', 'enthusiastic', 'pirate'.
+
+    Returns:
+        A greeting string.
+
+    Example:
+        >>> from greetify import greet
+        >>> greet("Alice")
+        'Hey Alice! 👋 Hope you're having an awesome day!'
+    """
+    styles = {
+        "friendly": f"Hey {name}! 👋 Hope you're having an awesome day!",
+        "formal": f"Good day, {name}. It is a pleasure to make your acquaintance.",
+        "enthusiastic": f"OMG {name}!!! 🎉🎉🎉 SO GREAT TO SEE YOU!!!",
+        "pirate": f"Ahoy, {name}! 🏴‍☠️ Welcome aboard, ye scallywag!",
+    }
+
+    if style not in styles:
+        raise ValueError(
+            f"Unknown style '{style}'. Choose from: {', '.join(styles.keys())}"
+        )
+
+    return styles[style]
+
+
+def random_greeting(name: str) -> str:
+    """
+    Generate a random-style greeting.
+
+    Args:
+        name: The name of the person to greet.
+
+    Returns:
+        A randomly styled greeting string.
+    """
+    style = random.choice(["friendly", "formal", "enthusiastic", "pirate"])
+    return greet(name, style)
+
+
+def motivate() -> str:
+    """
+    Get a random motivational quote.
+
+    Returns:
+        A motivational quote string.
+
+    Example:
+        >>> from greetify import motivate
+        >>> print(motivate())
+    """
+    quotes = [
+        "🚀 You're capable of amazing things!",
+        "💪 Every expert was once a beginner. Keep going!",
+        "🌟 The only limit is the one you set yourself.",
+        "🔥 Code like nobody's watching, deploy like everybody is.",
+        "✨ Bugs are just features waiting to be understood.",
+        "🎯 One commit at a time, you'll build something incredible.",
+        "🧠 Your potential is infinite. Compile and run!",
+        "🌈 Every error message is a step closer to success.",
+    ]
+    return random.choice(quotes)
+
+
+def banner(text: str, char: str = "=", width: int = 50) -> str:
+    """
+    Create an ASCII art banner around text.
+
+    Args:
+        text: The text to display in the banner.
+        char: The character to use for the border (default: '=').
+        width: The width of the banner (default: 50).
+
+    Returns:
+        A formatted banner string.
+
+    Example:
+        >>> from greetify import banner
+        >>> print(banner("Hello World"))
+    """
+    if width < len(text) + 4:
+        width = len(text) + 4
+
+    border = char * width
+    padding = width - 2
+    centered_text = text.center(padding)
+
+    return f"""
+{border}
+{char}{centered_text}{char}
+{border}
+""".strip()
+
+
+def time_greeting(name: str) -> str:
+    """
+    Generate a time-appropriate greeting.
+
+    Args:
+        name: The name of the person to greet.
+
+    Returns:
+        A greeting based on the current time of day.
+    """
+    hour = datetime.now().hour
+
+    if 5 <= hour < 12:
+        period = "Good morning"
+        emoji = "🌅"
+    elif 12 <= hour < 17:
+        period = "Good afternoon"
+        emoji = "☀️"
+    elif 17 <= hour < 21:
+        period = "Good evening"
+        emoji = "🌆"
+    else:
+        period = "Hello, night owl"
+        emoji = "🌙"
+
+    return f"{emoji} {period}, {name}!"

phi_hippo-0.1.0.dist-info/METADATA

@@ -0,0 +1,93 @@
+Metadata-Version: 2.4
+Name: phi_hippo
+Version: 0.1.0
+Summary: A fun greeting utility — generate personalized greetings, motivational quotes, and ASCII banners!
+Author-email: Your Name <your.email@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/yourusername/phi_hippo
+Project-URL: Issues, https://github.com/yourusername/phi_hippo/issues
+Keywords: greetings,fun,cli,utility,motivation
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+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: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# 🦛 phi_hippo
+
+A fun Python package that generates personalized greetings, motivational quotes, and ASCII art banners!
+
+## Installation
+
+```bash
+pip install phi_hippo
+```
+
+## Quick Start
+
+### Python API
+
+```python
+from phi_hippo import greet, motivate, banner, colorize
+
+# Generate a greeting
+print(greet("Alice"))
+# Hey Alice! 👋 Hope you're having an awesome day!
+
+# Try different styles
+print(greet("Bob", style="pirate"))
+# Ahoy, Bob! 🏴‍☠️ Welcome aboard, ye scallywag!
+
+# Get motivated
+print(motivate())
+# 🚀 You're capable of amazing things!
+
+# Create a banner
+print(banner("Hello World"))
+# ==================================================
+# =                  Hello World                   =
+# ==================================================
+
+# Add color to terminal output
+print(colorize("Success!", "green", bold=True))
+```
+
+### Command Line
+
+```bash
+# Greet someone
+phi_hippo hello Alice
+phi_hippo hello Bob --style pirate --color cyan
+
+# Get a motivational quote
+phi_hippo motivate
+
+# Create a banner
+phi_hippo banner "My Project" --width 60 --char "*"
+```
+
+## Available Greeting Styles
+
+| Style          | Example                                              |
+|----------------|------------------------------------------------------|
+| `friendly`     | Hey Alice! 👋 Hope you're having an awesome day!     |
+| `formal`       | Good day, Alice. It is a pleasure to make your acquaintance. |
+| `enthusiastic` | OMG Alice!!! 🎉🎉🎉 SO GREAT TO SEE YOU!!!         |
+| `pirate`       | Ahoy, Alice! 🏴‍☠️ Welcome aboard, ye scallywag!    |
+
+## Available Colors
+
+`red`, `green`, `yellow`, `blue`, `magenta`, `cyan`, `white`
+
+## License
+
+MIT License — see [LICENSE](LICENSE) for details.

phi_hippo-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+phi_hippo/__init__.py,sha256=Sy3kbrW6V7jO80ztlHpAhEEOls_OfkwvMwBNjEfgyg0,345
+phi_hippo/cli.py,sha256=TDApmibjiGIdMGsn9PNByrIyvR6ca1MYRDNorgSn7sQ,1991
+phi_hippo/colors.py,sha256=S9ceGODOYrvLFMf1QSpHJDIZXQgttIYV4RxiPE32NTU,1182
+phi_hippo/greetings.py,sha256=TYsuEruTmwbjX1dOags8UF9M2cTvyFM6gTBNNRe3NgY,3432
+phi_hippo-0.1.0.dist-info/licenses/LICENSE,sha256=v2spsd7N1pKFFh2G8wGP_45iwe5S0DYiJzG4im8Rupc,1066
+phi_hippo-0.1.0.dist-info/METADATA,sha256=EnERy0WBCv1zedXM5Kw8OIg6R6lN5jX91DrPy46YUEw,2812
+phi_hippo-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+phi_hippo-0.1.0.dist-info/entry_points.txt,sha256=rgIbrtsHBChrMSD5k33bB0u0RPOhixGxDdO0qILcd1g,49
+phi_hippo-0.1.0.dist-info/top_level.txt,sha256=z0Z6UXhZKQWL24XdSt2Ly9P7byZaBJZc-2_RMyho3Hk,10
+phi_hippo-0.1.0.dist-info/RECORD,,

phi_hippo-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
+

phi_hippo-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+phi_hippo = phi_hippo.cli:main

phi_hippo-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Your Name
+
+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.

phi_hippo-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+phi_hippo