pyllo-greeting 0.0.1__py3-none-any.whl

pyllo_greeting/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.0.1"

pyllo_greeting/commands/__init__.py

@@ -0,0 +1,8 @@
+from .greet import greet
+from .meta import version, credits
+
+__all__ = [
+    "greet",
+    "version",
+    "credits",
+]

pyllo_greeting/commands/greet.py

@@ -0,0 +1,19 @@
+from typing import Literal
+
+def greet(
+    name: str = None,
+    tone: Literal["quick", "normal", "fancy"] = "normal"
+) -> int:
+    if tone == "quick":
+        if name: print(f"Hi, {name}")
+        else: print("Hi")
+
+    elif tone == "fancy":
+        if name: print(f"Greetings. It is truly a pleasure to acknowledge your existence, {name}")
+        else: print("Greetings. It is truly a pleasure to acknowledge your existence")
+
+    else:
+        if name: print(f"Hello there, {name}")
+        else: print("Hello there")
+        
+    return 0

pyllo_greeting/commands/meta.py

@@ -0,0 +1,20 @@
+from importlib import metadata
+
+def version():
+    """Prints out the project's current version."""
+    print(metadata.version("pyllo_greeting"))
+    
+    return 0
+
+def credits():
+    """Print's out the credits of the ones involved in the project."""
+    print("Project created by:")
+    print("\tJoão Antônio")
+
+    print("\nAuthor's GitHub:")
+    print("\thttps://github.com/joao-antonio-la")
+
+    print("\nProject's Repository:")
+    print("\thttps://github.com/joao-antonio-la/pyllo_greeting")
+
+    return 0

pyllo_greeting/main.py

@@ -0,0 +1,9 @@
+import sys
+from pyllo_greeting.parser import run
+
+def main():
+    """App's entry point."""
+    sys.exit(run())
+
+if __name__ == "__main__": 
+    main()

pyllo_greeting/parser.py

@@ -0,0 +1,36 @@
+from argparse import ArgumentParser
+from pyllo_greeting.commands import credits, version
+from pyllo_greeting.commands import greet 
+
+app_parser = ArgumentParser(
+    prog="pyllo",
+    description="A simple CLI tool to test Python distribution."
+)
+
+# Positional argument: name. Whatever the app will greet.
+app_parser.add_argument("name", type=str, nargs="?", help="Name of the person to greet")
+
+# Separate flags for tones
+app_parser.add_argument("-q", "--quick", action="store_true", help="Greet with a quick tone")
+app_parser.add_argument("-f", "--fancy", action="store_true", help="Greet with a fancy tone")
+
+# Meta flags
+app_parser.add_argument("-v", "--version", action="store_true", help="Show the app version")
+app_parser.add_argument("-c", "--credits", action="store_true", help="Show project credits")
+
+def run():
+    """Command's execution based on user's inputs."""
+    args = app_parser.parse_args()
+    
+    if args.version:
+        return version()
+    elif args.credits:
+        return credits()
+    
+    tone = "normal"
+    if args.quick:
+        tone = "quick"
+    elif args.fancy:
+        tone = "fancy"
+    
+    return greet(name=args.name, tone=tone)

pyllo_greeting-0.0.1.dist-info/METADATA

@@ -0,0 +1,134 @@
+Metadata-Version: 2.4
+Name: pyllo_greeting
+Version: 0.0.1
+Summary: CLI application for testing Python distribution methods
+Author: João Antônio
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/joao-antonio-la/pyllo_greeting
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# pyllo_greeting
+
+Simple CLI application created for studying Python apps distribution methods.
+
+## Installation
+
+> ⚠️ You must have python installed to use this application.
+
+1. Clone the repository:
+
+``` sh
+git clone https://github.com/joao-antonio-la/pyllo_greeting.git
+```
+
+- After cloning the repo, you are ready to use the application.
+
+## Usage
+
+With the application locally into your machine, you can use it by following the steps bellow:
+
+1. Enter the project folder:
+
+``` sh
+cd pyllo_greeting
+```
+
+2. Create the virtual environment:
+
+``` sh
+python -m venv .venv  # Windows
+python3 -m venv .venv # MacOS and Linux
+```
+
+3. Activate the venv:
+
+``` sh
+.venv\Scripts\activate    # Windows
+source .venv/bin/activate # MacOS and Linux
+```
+
+4. Install the project locally:
+
+``` sh
+pip install .
+```
+
+5. Use the CLI:
+
+``` sh
+pyllo
+# Output: Hello there
+```
+
+### Options
+
+#### Name and Tones
+
+- It is possible to pass a name/word to be greeted by the app:
+
+``` sh
+pyllo John
+# Hello there, John
+```
+
+``` sh
+pyllo everyone
+# Hello there, everyone
+```
+
+- Secondly, there is also the possibity of informing a tone. The default tone is "normal":
+
+1. `Normal/Default`:
+
+``` sh
+pyllo Alice
+# Hello there, Alice
+```
+
+2. `Quick`:
+
+``` sh
+pyllo Theresa --quick
+# Hi, Theresa
+
+pyllo Matthew -q
+# Hi, Matthew
+```
+
+3. `Fancy`:
+
+``` sh
+pyllo Leticia --fancy
+# Greetings. It is truly a pleasure to acknowledge your existence, Leticia
+
+pyllo Beatrice -f
+# Greetings. It is truly a pleasure to acknowledge your existence, Beatrice
+```
+
+#### Meta Options
+
+There are currently two `meta` options:
+
+1. `App Version (--version | -v)`:
+
+``` sh
+pyllo -v
+# 0.1.0
+```
+
+2. `App's Credits (--credits | -c)`:
+
+``` sh
+pyllo -c
+# Project created by:
+#         João Antônio
+
+# Author's GitHub:
+#         https://github.com/joao-antonio-la
+
+# Project's Repository:
+#         https://github.com/joao-antonio-la/pyllo
+```

pyllo_greeting-0.0.1.dist-info/RECORD

@@ -0,0 +1,12 @@
+pyllo_greeting/__init__.py,sha256=ugyuFliEqtAwQmH4sTlc16YXKYbFWDmfyk87fErB8-8,21
+pyllo_greeting/main.py,sha256=oG42FGb3McW3ytxEuFB9RVE7olc4st-KwoNqHLtmDL4,158
+pyllo_greeting/parser.py,sha256=yjZFwJqphpLqLu7eau3zM69VLmbGG3mnbQgDkvyl6aI,1205
+pyllo_greeting/commands/__init__.py,sha256=TtDQgphd3Lz8xXQrPrXWFQ5Ix8KIlkJ_oy8A7pPbQhE,124
+pyllo_greeting/commands/greet.py,sha256=PffRo1SjZBPNHxd8Azi5GhlK95l-pKZIoWaeqqURuCo,561
+pyllo_greeting/commands/meta.py,sha256=WfNEkW-a5qb_kCu6tVx-Dcsv7VO_OKQiUzua4F3D0kA,531
+pyllo_greeting-0.0.1.dist-info/licenses/LICENSE,sha256=ZfoWB0-4MTlkEeA9xUYTCienqA6uVwaWDCS86r6RZE0,1090
+pyllo_greeting-0.0.1.dist-info/METADATA,sha256=YE5AaFczgtIbl97MQWMBk1HJWW-zoAPYWlVtZ3IU92U,2381
+pyllo_greeting-0.0.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+pyllo_greeting-0.0.1.dist-info/entry_points.txt,sha256=W_FsYtMClFodzagTzyg0yNJu9ZdS9r_mCZSwMDzf_w0,51
+pyllo_greeting-0.0.1.dist-info/top_level.txt,sha256=FIDF4hzd9CQdlEBq8Ae3z9Vbbwo7n5C1cvrbYKC7-yA,15
+pyllo_greeting-0.0.1.dist-info/RECORD,,

pyllo_greeting-0.0.1.dist-info/WHEEL

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

pyllo_greeting-0.0.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pyllo = pyllo_greeting.main:main

pyllo_greeting-0.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 João Antônio
+
+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.

pyllo_greeting-0.0.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+pyllo_greeting