kovy 0.1.0__tar.gz

kovy-0.1.0/PKG-INFO

@@ -0,0 +1,56 @@
+Metadata-Version: 2.4
+Name: kovy
+Version: 0.1.0
+Summary: Rust Cargo-like project manager for Python
+Project-URL: Homepage, https://github.com/Kopihue/kovy/
+Author-email: Kopihue <kopihuegit@gmail.com>
+Requires-Python: >=3.14
+Requires-Dist: paintmystring
+Description-Content-Type: text/markdown
+
+# Cargopy 🚀
+
+**Cargopy** es una herramienta ligera inspirada en **cargo** de Rust para gestionar proyectos de Python de manera rápida y eficiente, desde la creación hasta la ejecución de scripts y manejo de paquetes.
+
+---
+
+## 🛠️ Uso
+
+### Opciones disponibles
+
+| Opción | Descripción |
+|--------|-------------|
+| `new <nombre>` | Crea un nuevo proyecto con el nombre indicado. |
+| `cd` | Muestra la ruta raíz de tu proyecto. |
+| `venv` | Inicializa un entorno virtual en tu proyecto. |
+| `run <script>` | Ejecuta el script indicado (solo si existe). |
+| `install <paquete>` | Instala el paquete de Python especificado. |
+| `upgrade <paquete>` | Actualiza el paquete especificado. |
+| `uninstall <paquete>` | Desinstala el paquete especificado. |
+
+---
+
+## ⚡ Ejemplos
+
+```bash
+# Crear un proyecto llamado "mi_proyecto"
+cargopy new mi_proyecto
+
+# Inicializar entorno virtual
+cargopy venv
+
+# Instalar requests
+cargopy install requests
+
+# Ejecutar script principal
+cargopy run main.py
+```
+
+💡 Notas
+
+- Asegúrate de tener Python instalado en tu sistema.
+- run solo ejecutará scripts que existan dentro de tu proyecto.
+- Maneja tus paquetes directamente desde Cargopy para mantener tu proyecto limpio y organizado.
+
+¡Disfruta usando Cargopy! 🎉
+

kovy-0.1.0/README.md

@@ -0,0 +1,46 @@
+# Cargopy 🚀
+
+**Cargopy** es una herramienta ligera inspirada en **cargo** de Rust para gestionar proyectos de Python de manera rápida y eficiente, desde la creación hasta la ejecución de scripts y manejo de paquetes.
+
+---
+
+## 🛠️ Uso
+
+### Opciones disponibles
+
+| Opción | Descripción |
+|--------|-------------|
+| `new <nombre>` | Crea un nuevo proyecto con el nombre indicado. |
+| `cd` | Muestra la ruta raíz de tu proyecto. |
+| `venv` | Inicializa un entorno virtual en tu proyecto. |
+| `run <script>` | Ejecuta el script indicado (solo si existe). |
+| `install <paquete>` | Instala el paquete de Python especificado. |
+| `upgrade <paquete>` | Actualiza el paquete especificado. |
+| `uninstall <paquete>` | Desinstala el paquete especificado. |
+
+---
+
+## ⚡ Ejemplos
+
+```bash
+# Crear un proyecto llamado "mi_proyecto"
+cargopy new mi_proyecto
+
+# Inicializar entorno virtual
+cargopy venv
+
+# Instalar requests
+cargopy install requests
+
+# Ejecutar script principal
+cargopy run main.py
+```
+
+💡 Notas
+
+- Asegúrate de tener Python instalado en tu sistema.
+- run solo ejecutará scripts que existan dentro de tu proyecto.
+- Maneja tus paquetes directamente desde Cargopy para mantener tu proyecto limpio y organizado.
+
+¡Disfruta usando Cargopy! 🎉
+

kovy-0.1.0/pyproject.toml

@@ -0,0 +1,25 @@
+[project]
+name = "kovy"
+version = "0.1.0"
+description = "Rust Cargo-like project manager for Python"
+readme = "README.md"
+requires-python = ">= 3.14"
+authors = [
+{ name = "Kopihue", email = "kopihuegit@gmail.com" }
+]
+dependencies = [
+    "PaintMyString",
+]
+
+[project.scripts]
+kovy = "kovy.main:main"
+
+[project.urls]
+Homepage = "https://github.com/Kopihue/kovy/"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/kovy"]

kovy-0.1.0/src/kovy/help_panel.py

@@ -0,0 +1,65 @@
+import os
+import time
+from paintmystring.paint import paint
+
+def clear(lazy: float):
+    time.sleep(lazy)
+    os.system("clear")
+
+def help_panel():
+    clear(0)
+
+    paint(
+        paint("*"),
+        paint("Help panel deployed").bright_yellow().bold(),
+        paint("*"),
+    ).show()
+
+    paint("*" * 23).show()
+    print()
+    
+    paint(
+        paint("Usage:"),
+        paint("cargopy").bright_red().bold(),
+        paint("<option>").bright_green().bold(),
+        paint("<parameter>").bright_blue().bold(),
+    ).show()
+    print()
+
+    paint("Options: ").bright_green().bold().show()
+    paint(
+        paint("\tnew <parameter> ->").bright_magenta(),
+        paint("Creates a new project named as <parameter>").bold()
+    ).show()
+
+    paint(
+        paint("\tcd ->").bright_magenta(),
+        paint("Prints the path of the root of your project").bold()
+    ).show()
+
+    paint(
+        paint("\tvenv ->").bright_magenta(),
+        paint("Initializes a virtual env in your project").bold()
+    ).show()
+
+    paint(
+        paint("\trun <parameter> ->").bright_magenta(),
+        paint("Runs the script named <parameter> just if it exists").bold()
+    ).show()
+
+    paint(
+        paint("\tinstall <parameter> ->").bright_magenta(),
+        paint("Installs the package named <parameter>").bold()
+    ).show()
+
+    paint(
+        paint("\tupgrade <parameter> ->").bright_magenta(),
+        paint("Upgrades the package named <parameter>").bold()
+    ).show()
+
+    paint(
+        paint("\tuninstall <parameter> ->").bright_magenta(),
+        paint("Uninstalls the package named <parameter>").bold()
+    ).show()
+
+    print()

kovy-0.1.0/src/kovy/main.py

@@ -0,0 +1,162 @@
+from paintmystring.paint import paint
+from .help_panel import help_panel
+from .structure import Structure
+from .utils import Utils
+import sys
+
+def main():
+    args = sys.argv[1:]
+
+    new = False
+    dir_name = None
+
+    cd = False
+
+    venv = False
+
+    run = False
+    file_name = None
+    file_args = None
+
+    pip = None
+    package = None
+    install = False
+    upgrade = False
+    uninstall = False
+    listed = False
+
+    build = None
+    upload = None
+
+    while args:
+        arg = args.pop(0)
+
+        match arg:
+            case "help" | "--help":
+                help_panel()
+
+            case "new":
+                new = True
+                try:
+                    dir_name = args.pop(0)
+                except IndexError:
+                    paint(
+                        paint("New").bright_red().bold(),
+                        paint("action requires an argument...").bold(),
+                    ).show()
+
+            case "cd":
+                cd = True
+
+            case "venv":
+                venv = True
+
+            case "run":
+                run = True
+                try:
+                    file_name = args.pop(0)
+                except IndexError:
+                    paint(
+                        paint("Run").bright_red().bold(),
+                        paint("action requires an argument...").bold(),
+                    ).show()
+
+                try:
+                    are_there_arguments = args.pop(0)
+                    if are_there_arguments == "--":
+                        pass
+
+                    else:
+                        raise ValueError("Invalid action")
+                except IndexError:
+                    file_args = []
+                else:
+                    file_args = args
+
+            case "install":
+                pip = True
+                install = True
+                try:
+                    package = args.pop(0)
+                except IndexError:
+                    paint(
+                        paint("Install").bright_red().bold(),
+                        paint("action requires an argument...").bold(),
+                    ).show()
+
+            case "upgrade":
+                pip = True
+                upgrade = True
+                try:
+                    package = args.pop(0)
+                except IndexError:
+                    paint(
+                        paint("Upgrade").bright_red().bold(),
+                        paint("action requires an argument...").bold(),
+                    ).show()
+
+            case "uninstall":
+                pip = True
+                uninstall = True
+                try:
+                    package = args.pop(0)
+                except IndexError:
+                    paint(
+                        paint("Uninstall").bright_red().bold(),
+                        paint("action requires an argument...").bold(),
+                    ).show()
+
+            case "list":
+                pip = True
+                listed = True
+                package = "list"
+
+            case _:
+                paint("Unknown option...").bold().red().show()
+                paint(
+                    paint("Try:").bright_cyan().bold(),
+                    paint("help").bright_yellow(),
+                ).show()
+
+    if new or cd:
+        struct = Structure()
+
+        if new:
+            if dir_name is None:
+                sys.exit(1)
+
+            struct.new(dir_name)
+
+        elif cd:
+            print(struct.cd())
+
+    if venv or run or pip:
+        project_utils = Utils()
+
+        if venv:
+            project_utils.venv()
+
+        elif run:
+            if file_name is None:
+                sys.exit(1)
+
+            project_utils.run(file_name, file_args)
+
+        elif pip:
+            if package is None:
+                sys.exit(1)
+
+            if install:
+                project_utils.pip("install", package)
+
+            elif upgrade:
+                project_utils.pip("upgrade", package)
+
+            elif uninstall:
+                project_utils.pip("uninstall", package)
+
+            elif listed:
+                project_utils.pip("list")
+
+if __name__ == "__main__":
+    main()

kovy-0.1.0/src/kovy/project.py

@@ -0,0 +1,50 @@
+from pathlib import Path
+import sys
+
+class Project:
+    @staticmethod
+    def get_project_root() -> Path | None:
+        pwd = Path.cwd()
+
+        while True:
+            if pwd == pwd.parent:
+                return None
+
+            if (pwd / "pyproject.toml").exists():
+                return pwd
+
+            else:
+                pwd = pwd.parent
+
+    @staticmethod
+    def check_venv_existence() -> bool | None:
+        pwd = Project.get_project_root()
+        if pwd is None:
+            return None
+        
+        if (pwd / ".venv").exists():
+            return True
+
+        else:
+            return False
+
+    @staticmethod
+    def get_isolated_python() -> Path | None:
+        root_project = Project.get_project_root()
+
+        if root_project is None:
+            return None
+
+        isolated_python = (
+            root_project
+            / ".venv" 
+            / "bin" 
+            / "python"
+        )
+
+        if not isolated_python.exists():
+            print("Virtual Python doesn't exists")
+            print("Try running again \"cargopy venv\"")
+            sys.exit(1)
+
+        return isolated_python

kovy-0.1.0/src/kovy/structure.py

@@ -0,0 +1,83 @@
+from pathlib import Path
+from .project import Project
+from paintmystring.paint import paint
+import sys
+import shutil
+import subprocess
+
+class Structure(Project):
+    def __init__(self):
+        self.pwd = Path.cwd()
+        self.root_project = self.get_project_root()
+
+    def new(self, dir_name: str):
+        py_project = """[project]
+name = ""
+version = "0.1.0"
+description = ""
+readme = "README.md"
+requires-python = ">= 3.14"
+authors = [
+{ name = "Kopihue", email = "kopihuegit@gmail.com" }
+]
+
+[project.urls]
+Homepage = ""
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+        """
+
+        dir_path = self.pwd / dir_name
+
+        if dir_path.exists():
+            paint("Project already exists...").bright_magenta().bold().show()
+            sys.exit(1)
+
+        try:
+            dir_path.mkdir(exist_ok=True)
+        except Exception as e:
+            paint(
+                paint("Exception").bright_red().bold(),
+                paint(e).bold(),
+            ).show()
+
+        (dir_path / "README.md").touch()
+        (dir_path / "pyproject.toml").touch()
+        with open(dir_path / "pyproject.toml", "w") as f:
+            f.write(py_project)
+
+        src_dir = dir_path / "src"
+        tests_dir = dir_path / "tests"
+        src_dir.mkdir()
+        tests_dir.mkdir()
+
+        package_dir = src_dir / dir_name
+        package_dir.mkdir()
+        (package_dir / "__init__.py").touch()
+
+        paint(
+            paint("Created project in ->").bold(),
+            paint(dir_name).bold().bright_blue(),
+        ).show()
+        if shutil.which("git") is not None:
+            subprocess.run(
+                "git init &>/dev/null",
+                cwd=dir_path,
+                shell=True,
+            )
+
+        else:
+            paint(
+                paint("Couldn't start git repository ->").bold(),
+                paint("git is not on your path").bright_magenta(),
+            ).show()
+
+    def cd(self) -> Path:
+        if self.root_project is None:
+            paint("Not a Python project!").bright_magenta().bold().show()
+            sys.exit(1)
+
+        else:
+            return self.root_project

kovy-0.1.0/src/kovy/utils.py

@@ -0,0 +1,147 @@
+from pathlib import Path
+from .structure import Structure
+from .project import Project
+from paintmystring.paint import paint
+import subprocess
+import sys
+
+class Utils(Project):
+    def __init__(self):
+        self.struct = Structure()
+
+        self.pwd = Path.cwd()
+        self.root_project = self.get_project_root()
+
+    def venv(self):
+        check_venv = self.check_venv_existence()
+        if check_venv is None:
+            paint("Not a Python project!").bright_magenta().bold().show()
+            sys.exit(1)
+
+        if check_venv:
+            paint(
+                paint(".venv").bright_cyan().bold(),
+                paint("already exists!").bold(),
+            ).show()
+            sys.exit(1)
+
+        else:
+            command = ["python", "-m", "venv", ".venv"]
+            result = subprocess.run(
+                command,
+                capture_output=True,
+                text=True,
+                cwd=self.root_project
+            )
+
+            self.pip("pip", "upgrade")
+
+            if result.returncode != 0:
+                paint("The command has failed.").bold().show()
+                print(result.stderr)
+
+            else:
+                paint(
+                    paint("Succesfully created venv in ->").bold(),
+                    paint(".venv").bright_cyan().bold(),
+                ).show()
+
+    def run(self, file_name: str, file_args: list[str] | None):
+        check_venv = self.check_venv_existence()
+        isolated_python = self.get_isolated_python()
+
+        if file_args is None:
+            sys.exit(1)
+
+        if (
+            check_venv is None 
+            or self.root_project is None 
+            or isolated_python is None
+        ):
+            paint("Not a Python project!").bright_magenta().bold().show()
+            sys.exit(1)
+
+        if not check_venv:
+            self.venv()
+            check_venv = True
+
+        if check_venv:
+            ignored_dirs = {".venv", "__pycache__"}
+            found_scripts = []
+            for path in self.root_project.rglob(file_name):
+                if not any(
+                    ignored in path.parts
+                    for ignored in ignored_dirs
+                ):
+                    found_scripts.append(path.resolve())
+
+            if not found_scripts:
+                paint(
+                    paint("Didn't find script in ->").bold(),
+                    paint(file_name).blue(),
+                ).show()
+                sys.exit(1)
+
+            command = [isolated_python, found_scripts[0], *file_args]
+            subprocess.run(
+                command,
+            )
+
+    def pip(self, action: str, package: str | None = None):
+        check_venv = self.check_venv_existence()
+        isolated_python = self.get_isolated_python()
+
+        if check_venv is None or isolated_python is None:
+            paint("Not a Python project!").bright_magenta().bold().show()
+            sys.exit(1)
+
+        if not check_venv:
+            self.venv()
+            check_venv = True
+
+        if check_venv:
+            if action == "install" and package is not None:
+                command = [
+                    isolated_python,
+                    "-m",
+                    "pip",
+                    action,
+                    package,
+                ]
+
+            elif action == "upgrade" and package is not None:
+                command = [
+                    isolated_python,
+                    "-m",
+                    "pip",
+                    "install",
+                    "--upgrade",
+                    package,
+                ]
+
+            elif action == "uninstall" and package is not None:
+                command = [
+                    isolated_python,
+                    "-m",
+                    "pip",
+                    action,
+                    "-y",
+                    package
+                ]
+
+            elif action == "list":
+                command = [
+                    isolated_python,
+                    "-m",
+                    "pip",
+                    action,
+                ]
+
+            else:
+                paint("Not a pip command!").bright_magenta().bold().show()
+                sys.exit(1)
+
+
+            subprocess.run(
+                command,
+            )