nametitleapp 0.1.0__tar.gz

nametitleapp-0.1.0/LICENSE

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

nametitleapp-0.1.0/PKG-INFO

@@ -0,0 +1,17 @@
+Metadata-Version: 2.4
+Name: nametitleapp
+Version: 0.1.0
+Summary: 
+License-File: LICENSE
+Author: CiszukoAntony
+Author-email: fplayersoffcial@gmail.com
+Requires-Python: >=3.14
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: keyboard (>=0.13.5)
+Requires-Dist: rich (>=15.0.0)
+Requires-Dist: typer (>=0.27.2,<0.28.0)
+Description-Content-Type: text/markdown
+
+README
+

nametitleapp-0.1.0/README.md

@@ -0,0 +1 @@
+README

nametitleapp-0.1.0/pyproject.toml

@@ -0,0 +1,18 @@
+[project]
+name = "nametitleapp"
+version = "0.1.0"
+description = ""
+authors = [{ name = "CiszukoAntony", email = "fplayersoffcial@gmail.com" }]
+readme = "README.md"
+requires-python = ">=3.14"
+dependencies = ["keyboard>=0.13.5", "rich>=15.0.0", "typer (>=0.27.2,<0.28.0)"]
+
+[tool.poetry]
+packages = [{ include = "*", from = "src" }]
+
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.poetry.scripts]
+nametitleapp = "main:app"

nametitleapp-0.1.0/src/main.py

@@ -0,0 +1,104 @@
+# ruff: noqa: I001
+# ruff: noqa: BLE001
+
+# Imports
+import os
+import sys
+import threading as thr
+import time
+import typing
+import keyboard as kb
+import typer
+from modules import clear_cls_command, hotkeys, install_libs
+from rich import print
+
+install_libs.installlibs("rich", "keyboard", "typer")
+clear_cls_command.clear_cls()
+
+# Inicializamos la aplicación Typer
+app = typer.Typer(help="NameTitleApp CLI con Typer")
+
+
+def run_app(name: str) -> None:
+    """
+    Logica central de la aplicacion que ejecuta los hilos y espera la salida.
+    """
+    thr_clearcls = thr.Thread(target=clear_cls_command.clear_cls)
+    thr_inithotkeys = thr.Thread(target=hotkeys.init_hotkeys)
+
+    thr_clearcls.start()
+    time.sleep(0.1)
+    thr_inithotkeys.start()
+    time.sleep(0.1)
+
+    print(f"Bienvenido. {name}.")
+
+    print("Presiona [ESC] para terminar.")
+    kb.wait("esc")
+
+
+# Callback principal: Maneja el comando base, argumentos de nombre y la flag --debug
+@app.callback(invoke_without_command=True)
+def main(
+    ctx: typer.Context,
+    name_arg: str | None = typer.Argument(
+        None, help="Nombre ingresado directamente por argumento"
+    ),
+    debug: bool = typer.Option(
+        False,
+        "--debug",
+        help="Activa el modo debug (asigna nombre admin automáticamente)",
+    ),
+) -> typing.Any:
+    """
+    Funcion principal con soporte para argumentos directos y flags.
+    """
+    # Si el usuario ejecuta un subcomando (ej. 'init' o 'run'), dejamos que actúe dicho subcomando
+    if ctx.invoked_subcommand is not None:
+        return
+
+    # Evaluamos la logica de negocio
+    if debug:
+        name = "Admin"
+    elif name_arg:
+        name = name_arg.strip().title()
+    else:
+        name = str(input("Ingresa tu nombre: ")).strip().title()
+
+    run_app(name)
+
+
+# Subcomando 'init' (ej: nametitleapp init)
+@app.command()
+def init(
+    debug: bool = typer.Option(False, "--debug", help="Activa el modo debug en init"),
+) -> None:
+    """Subcomando init."""
+    name = (
+        "Admin"
+        if debug
+        else str(input("Ingresa tu nombre para init: ")).strip().title()
+    )
+    run_app(name)
+
+
+# Subcomando 'run' (ej: nametitleapp run)
+@app.command()
+def run(
+    debug: bool = typer.Option(False, "--debug", help="Activa el modo debug en run"),
+) -> None:
+    """Subcomando run."""
+    name = (
+        "Admin" if debug else str(input("Ingresa tu nombre para run: ")).strip().title()
+    )
+    run_app(name)
+
+
+if __name__ == "__main__":
+    try:
+        app()
+    except Exception as exc:
+        print(
+            f"\n[ERROR CRÍTICO]: {os.strerror(exc.errno) if hasattr(exc, 'errno') else exc}"
+        )
+        sys.exit(1)

nametitleapp-0.1.0/src/modules/clear_cls_command.py

@@ -0,0 +1,27 @@
+# ruff: noqa: RUF100
+# ruff: noqa: I001
+# ruff:noqa: BLE001
+
+# Imports
+import os
+import sys
+
+from rich import print
+
+
+def clear_cls() -> None:
+    """
+    Borra la consola.
+    """
+    clear_command = "cls" if os.name == "nt" else "clear"
+    os.system(clear_command)
+
+
+if __name__ == "__main__":
+    try:
+        print("No se puede ejecutar este modulo por separado.")
+    except Exception as exc:
+        print(
+            f"\n[ERROR CRÍTICO]: {os.strerror(exc.errno) if hasattr(exc, 'errno') else exc}"
+        )
+        sys.exit(1)

nametitleapp-0.1.0/src/modules/hotkeys.py

@@ -0,0 +1,33 @@
+# ruff: noqa: RUF100
+# ruff: noqa: I001
+# ruff:noqa: BLE001
+
+# Imports
+import os
+import sys
+
+import keyboard as kb
+from rich import print
+
+
+def init_hotkeys() -> None:
+    """
+    Funcion que inicializa los hotkeys.
+    """
+    print("Usa CONTROL+Z para Cerrar la App")
+
+    def ctrl_z_func():
+        print("\nCerrado App...")
+        os._exit(1)
+
+    kb.add_hotkey(hotkey="ctrl+z", callback=ctrl_z_func)
+
+
+if __name__ == "__main__":
+    try:
+        print("No se puede ejecutar este modulo por separado.")
+    except Exception as exc:
+        print(
+            f"\n[ERROR CRÍTICO]: {os.strerror(exc.errno) if hasattr(exc, 'errno') else exc}"
+        )
+        sys.exit(1)

nametitleapp-0.1.0/src/modules/install_libs.py

@@ -0,0 +1,44 @@
+# ruff: noqa: RUF100
+# ruff: noqa: I001
+# ruff:noqa: BLE001
+
+# Imports
+import importlib
+import os
+import subprocess
+import sys
+
+from rich import print
+
+
+def installlibs(*librerias: str) -> None:
+    """
+    Verifica e instala dinámicamente las librerías que falten.
+    """
+    for lib in librerias:
+        nombre_paquete = lib.split(".")[0]
+
+        try:
+            importlib.import_module(nombre_paquete)
+            print(f"[OK] La librería '{lib}' ya está instalada.")
+        except ImportError:
+            print(f"[AVISO] La librería '{lib}' no está instalada. Instalando...")
+            try:
+                subprocess.check_call(
+                    [sys.executable, "-m", "pip", "install", nombre_paquete]
+                )
+                print(f"[ÉXITO] '{nombre_paquete}' se instaló correctamente.")
+            except Exception as e:
+                raise ImportError(
+                    f"[ERROR CRÍTICO] No se pudo instalar '{nombre_paquete}'. Motivo: {e}"
+                )
+
+
+if __name__ == "__main__":
+    try:
+        print("No se puede ejecutar este modulo por separado.")
+    except Exception as exc:
+        print(
+            f"\n[ERROR CRÍTICO]: {os.strerror(exc.errno) if hasattr(exc, 'errno') else exc}"
+        )
+        sys.exit(1)