zenith-greeter 0.1.0__py3-none-any.whl

zenith_greeter/__init__.py

@@ -0,0 +1,5 @@
+"""A small reusable greeting package."""
+
+from .greeter import Greeter
+
+__all__ = ["Greeter"]

zenith_greeter/greeter.py

@@ -0,0 +1,45 @@
+"""Greeting utilities for Python applications."""
+
+
+class Greeter:
+    """Build consistent greetings with optional custom wording.
+
+    Args:
+        name: Person to greet. Empty or whitespace-only names become ``"there"``.
+        greeting: Opening word or phrase, such as ``"Hello"`` or ``"Welcome"``.
+        welcome_message: Optional message appended after the greeting.
+
+    Example:
+        >>> Greeter("Awwal").greet()
+        'Hello, Awwal! Welcome to Python packages.'
+        >>> Greeter("Ada", greeting="Hi", welcome_message="Good to see you.").greet()
+        'Hi, Ada! Good to see you.'
+    """
+
+    def __init__(
+        self,
+        name: str = "there",
+        greeting: str = "Hello",
+        welcome_message: str = "Welcome to Python packages.",
+    ) -> None:
+        if not isinstance(name, str):
+            raise TypeError("name must be a string")
+        if not isinstance(greeting, str):
+            raise TypeError("greeting must be a string")
+        if not isinstance(welcome_message, str):
+            raise TypeError("welcome_message must be a string")
+
+        greeting = greeting.strip()
+        if not greeting:
+            raise ValueError("greeting cannot be empty")
+
+        self.name = name.strip() or "there"
+        self.greeting = greeting
+        self.welcome_message = welcome_message.strip()
+
+    def greet(self) -> str:
+        """Return the configured greeting as a string."""
+        message = f"{self.greeting}, {self.name}!"
+        if self.welcome_message:
+            message += f" {self.welcome_message}"
+        return message

zenith_greeter-0.1.0.dist-info/METADATA

@@ -0,0 +1,68 @@
+Metadata-Version: 2.4
+Name: zenith-greeter
+Version: 0.1.0
+Summary: A small example Python package with a reusable Greeter class
+Author: Zenith OX
+License-Expression: MIT
+Keywords: greeting,example,zenith
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Zenith Greeter
+
+A small, dependency-free Python package demonstrating how to build, test, and publish a reusable class.
+
+## Installation
+
+After the package is published to PyPI:
+
+```bash
+python -m pip install zenith-greeter
+```
+
+For local development from the project directory:
+
+```bash
+python -m pip install -e .
+```
+
+## Quick start
+
+```python
+from zenith_greeter import Greeter
+
+person = Greeter("Awwal")
+print(person.greet())
+# Hello, Awwal! Welcome to Python packages.
+```
+
+## Customize the greeting
+
+```python
+from zenith_greeter import Greeter
+
+person = Greeter(
+    name="Ada",
+    greeting="Hi",
+    welcome_message="Good to see you.",
+)
+print(person.greet())
+# Hi, Ada! Good to see you.
+```
+
+A missing or blank name defaults to `there`. The greeting phrase must not be blank. Set `welcome_message=""` to omit the final message. Non-string arguments raise `TypeError` rather than failing later in the program.
+
+## Run the tests
+
+From the project root, install the package in editable mode and run the tests:
+
+```bash
+python -m pip install -e .
+python -m unittest discover -s tests -v
+```
+
+The package uses Python's built-in `unittest` framework and has no runtime dependencies.

zenith_greeter-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+zenith_greeter/__init__.py,sha256=h_Psuqg6fPp5WEfeTeIEIsOBQImDh1D6EP5dR11hGMc,99
+zenith_greeter/greeter.py,sha256=3DgG480RqVYbEGHTx9QSN3f29n0-rGVCxznVFRJvkkM,1624
+zenith_greeter-0.1.0.dist-info/licenses/LICENSE,sha256=Qt9uuGW3WrjBxWe1f-yjg-xNoMxmHFitpTnDv3s0ndc,824
+zenith_greeter-0.1.0.dist-info/METADATA,sha256=nkZC95ZkxTdmI7758oQtgvzikNeQ8_EWCDu0b6PAvWA,1664
+zenith_greeter-0.1.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+zenith_greeter-0.1.0.dist-info/top_level.txt,sha256=e77hsRLWAKs7TvPgtwRFNI4fqaqltVcpDWiLI6Tnhlc,15
+zenith_greeter-0.1.0.dist-info/RECORD,,

zenith_greeter-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

zenith_greeter-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,17 @@
+MIT License
+
+Copyright (c) 2026 Zenith OX
+
+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.

zenith_greeter-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+zenith_greeter