phi-hippo 0.1.0__tar.gz

phi_hippo-0.1.0/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/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,69 @@
+# 🦛 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/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "phi_hippo"
+version = "0.1.0"
+description = "A fun greeting utility — generate personalized greetings, motivational quotes, and ASCII banners!"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.8"
+authors = [
+    {name = "Your Name", email = "your.email@example.com"},
+]
+keywords = ["greetings", "fun", "cli", "utility", "motivation"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Utilities",
+]
+
+[project.urls]
+Homepage = "https://github.com/yourusername/phi_hippo"
+Issues = "https://github.com/yourusername/phi_hippo/issues"
+
+[project.scripts]
+phi_hippo = "phi_hippo.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

phi_hippo-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

phi_hippo-0.1.0/src/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-0.1.0/src/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-0.1.0/src/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-0.1.0/src/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/src/phi_hippo.egg-info/PKG-INFO

@@ -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/src/phi_hippo.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+README.md
+pyproject.toml
+src/phi_hippo/__init__.py
+src/phi_hippo/cli.py
+src/phi_hippo/colors.py
+src/phi_hippo/greetings.py
+src/phi_hippo.egg-info/PKG-INFO
+src/phi_hippo.egg-info/SOURCES.txt
+src/phi_hippo.egg-info/dependency_links.txt
+src/phi_hippo.egg-info/entry_points.txt
+src/phi_hippo.egg-info/top_level.txt
+tests/test_greetings.py

phi_hippo-0.1.0/src/phi_hippo.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

phi_hippo-0.1.0/src/phi_hippo.egg-info/entry_points.txt

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

phi_hippo-0.1.0/src/phi_hippo.egg-info/top_level.txt

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

phi_hippo-0.1.0/tests/test_greetings.py

@@ -0,0 +1,102 @@
+"""Tests for the phi_hippo package."""
+
+import pytest
+from phi_hippo import greet, motivate, banner, colorize
+from phi_hippo.greetings import time_greeting
+
+
+class TestGreet:
+    """Tests for the greet function."""
+
+    def test_friendly_greeting(self):
+        result = greet("Alice")
+        assert "Alice" in result
+        assert "👋" in result
+
+    def test_formal_greeting(self):
+        result = greet("Bob", style="formal")
+        assert "Bob" in result
+        assert "pleasure" in result
+
+    def test_enthusiastic_greeting(self):
+        result = greet("Charlie", style="enthusiastic")
+        assert "Charlie" in result
+        assert "🎉" in result
+
+    def test_pirate_greeting(self):
+        result = greet("Dave", style="pirate")
+        assert "Dave" in result
+        assert "Ahoy" in result
+
+    def test_invalid_style_raises_error(self):
+        with pytest.raises(ValueError, match="Unknown style"):
+            greet("Eve", style="robot")
+
+    def test_default_style_is_friendly(self):
+        result = greet("Frank")
+        assert "Hey Frank" in result
+
+
+class TestMotivate:
+    """Tests for the motivate function."""
+
+    def test_returns_string(self):
+        result = motivate()
+        assert isinstance(result, str)
+        assert len(result) > 0
+
+    def test_returns_different_quotes(self):
+        quotes = {motivate() for _ in range(50)}
+        assert len(quotes) > 1, "motivate() should return varied quotes"
+
+
+class TestBanner:
+    """Tests for the banner function."""
+
+    def test_basic_banner(self):
+        result = banner("Hello")
+        assert "Hello" in result
+        assert "=" in result
+
+    def test_custom_character(self):
+        result = banner("Test", char="*")
+        assert "*" in result
+        assert "=" not in result
+
+    def test_custom_width(self):
+        result = banner("Hi", width=30)
+        lines = result.strip().split("\n")
+        assert len(lines[0]) == 30
+
+    def test_auto_width_expansion(self):
+        long_text = "This is a very long banner text"
+        result = banner(long_text, width=10)
+        assert long_text in result
+
+
+class TestColorize:
+    """Tests for the colorize function."""
+
+    def test_basic_colorize(self):
+        result = colorize("Hello", "green")
+        assert "Hello" in result
+        assert "\033[92m" in result
+        assert "\033[0m" in result
+
+    def test_bold_colorize(self):
+        result = colorize("Bold", "red", bold=True)
+        assert "\033[1m" in result
+        assert "\033[91m" in result
+
+    def test_invalid_color_raises_error(self):
+        with pytest.raises(ValueError, match="Unknown color"):
+            colorize("Text", "rainbow")
+
+
+class TestTimeGreeting:
+    """Tests for the time_greeting function."""
+
+    def test_returns_string_with_name(self):
+        result = time_greeting("Alice")
+        assert "Alice" in result
+        assert isinstance(result, str)