forgepy-cli 1.0.0__py3-none-any.whl

builders/base_builder.py

@@ -0,0 +1,17 @@
+"""
+==================================================
+ForgePy
+Module  : Base Builder
+==================================================
+"""
+
+
+class BaseBuilder:
+    """
+    Parent class seluruh Builder ForgePy.
+
+    Digunakan sebagai parent agar seluruh Builder
+    mempunyai struktur yang konsisten.
+    """
+
+    pass

builders/file_builder.py

@@ -0,0 +1,31 @@
+"""
+==================================================
+ForgePy
+Module  : File Builder
+==================================================
+"""
+
+from pathlib import Path
+
+from builders.base_builder import BaseBuilder
+
+
+class FileBuilder(BaseBuilder):
+
+    def write(
+        self,
+        path: Path,
+        content: str,
+    ) -> None:
+
+        path.parent.mkdir(
+            parents=True,
+            exist_ok=True,
+        )
+
+        path.write_text(
+            content,
+            encoding="utf-8",
+        )
+
+        print(f"[OK] File dibuat : {path}")

builders/folder_builder.py

@@ -0,0 +1,30 @@
+"""
+==================================================
+ForgePy
+Module  : Folder Builder
+==================================================
+"""
+
+from pathlib import Path
+
+from builders.base_builder import BaseBuilder
+
+
+class FolderBuilder(BaseBuilder):
+
+    def create(
+        self,
+        root: Path,
+        folders: list[str],
+    ) -> None:
+
+        for folder in folders:
+
+            path = root / folder
+
+            path.mkdir(
+                parents=True,
+                exist_ok=True,
+            )
+
+            print(f"[OK] Folder dibuat : {path}")

builders/python_tools_builder.py

@@ -0,0 +1,64 @@
+"""
+==================================================
+ForgePy
+Module  : Python Tools Builder
+==================================================
+"""
+
+import subprocess
+from pathlib import Path
+
+from builders.base_builder import BaseBuilder
+
+
+PACKAGE_TOOL_UPDATE_TIMEOUT_SECONDS = 300
+
+
+class PythonToolsBuilder(BaseBuilder):
+    """
+    Mengupdate pip, setuptools, dan wheel
+    pada Virtual Environment.
+    """
+
+    def update(
+        self,
+        project_path: Path,
+    ) -> None:
+
+        python = project_path / ".venv" / "Scripts" / "python.exe"
+
+        if not python.exists():
+            print("[WARNING] Virtual Environment belum tersedia.")
+            return
+
+        packages = [
+            "pip",
+            "setuptools",
+            "wheel",
+        ]
+
+        for package in packages:
+
+            print(f"[INFO] Mengupdate {package}...")
+
+            try:
+                subprocess.run(
+                    [
+                        str(python),
+                        "-m",
+                        "pip",
+                        "install",
+                        "--upgrade",
+                        package,
+                    ],
+                    check=True,
+                    timeout=PACKAGE_TOOL_UPDATE_TIMEOUT_SECONDS,
+                )
+            except subprocess.SubprocessError as error:
+                print(
+                    "[ERROR] Packaging-tool update failed for "
+                    f"'{package}': {error}"
+                )
+                raise
+
+            print(f"[OK] {package} berhasil diupdate.")

cli/__init__.py

@@ -0,0 +1,3 @@
+"""
+ForgePy CLI Package
+"""

cli/command.py

@@ -0,0 +1,52 @@
+"""
+==================================================
+ForgePy
+Module  : Base Command
+==================================================
+"""
+
+from abc import ABC, abstractmethod
+from argparse import ArgumentParser, Namespace
+
+
+class Command(ABC):
+    """
+    Kontrak dasar untuk seluruh command ForgePy.
+    """
+
+    name: str = ""
+    summary: str = ""
+    description: str = ""
+
+    def validate_registration(self) -> None:
+        """
+        Memastikan metadata command lengkap sebelum didaftarkan.
+        """
+
+        for field in (
+            "name",
+            "summary",
+            "description",
+        ):
+            if not getattr(self, field):
+                raise ValueError(
+                    f"Command '{type(self).__name__}' harus memiliki {field}."
+                )
+
+    def configure_parser(
+        self,
+        parser: ArgumentParser,
+    ) -> None:
+        """
+        Mendaftarkan argumen khusus command.
+
+        Command tanpa argumen dapat menggunakan implementasi default.
+        """
+        del parser
+
+    @abstractmethod
+    def execute(self, args: Namespace) -> int:
+        """
+        Menjalankan command dan mengembalikan status proses CLI.
+        """
+        raise NotImplementedError

cli/commands/__init__.py

@@ -0,0 +1,32 @@
+"""
+ForgePy Commands
+
+Seluruh command bawaan didaftarkan pada module ini.
+"""
+
+from cli.command import Command
+from cli.commands.component_command import ComponentCommand
+from cli.commands.config_command import ConfigCommand
+from cli.commands.create_command import CreateCommand
+from cli.commands.list_command import ListCommand
+from cli.commands.version_command import VersionCommand
+
+
+DEFAULT_COMMAND = "create"
+
+
+def create_commands() -> tuple[Command, ...]:
+    """
+    Membuat seluruh command bawaan dalam urutan tampilan CLI.
+
+    Command baru hanya perlu ditambahkan pada catalog ini agar parser
+    dan dispatcher menggunakan registrasi yang sama.
+    """
+
+    return (
+        CreateCommand(),
+        VersionCommand(),
+        ListCommand(),
+        ConfigCommand(),
+        ComponentCommand(),
+    )

cli/commands/component_command.py

@@ -0,0 +1,177 @@
+"""CLI access to registered ForgePy components."""
+
+from argparse import ArgumentParser, Namespace
+from pathlib import Path
+
+from cli.command import Command
+from components.component_installer import (
+    ComponentAlreadyInstalledError,
+    ComponentInstaller,
+)
+from components.component_registry import ComponentRegistry
+from components.component_state import (
+    ComponentStateStore,
+    ForgePyComponentStateError,
+)
+from components.component_validation import ComponentValidationError
+
+
+class ComponentCommand(Command):
+    """List available or installed components, or install one."""
+
+    name = "component"
+    summary = "List, inspect, or add ForgePy components."
+    description = (
+        "List registered ForgePy components, inspect project-local installed "
+        "state, or add one to an existing project."
+    )
+
+    def __init__(self, registry: ComponentRegistry | None = None) -> None:
+        self._registry = registry
+
+    def configure_parser(self, parser: ArgumentParser) -> None:
+        actions = parser.add_subparsers(
+            dest="component_action",
+            title="component actions",
+            description="Available component actions",
+            metavar="ACTION",
+            required=True,
+        )
+
+        actions.add_parser(
+            "list",
+            help="List registered built-in components.",
+            description=(
+                "List registered built-in component names and descriptions."
+            ),
+        )
+
+        installed_parser = actions.add_parser(
+            "installed",
+            help="List components recorded as installed in a project.",
+            description=(
+                "List component names recorded in an explicitly supplied "
+                "existing project directory."
+            ),
+        )
+        installed_parser.add_argument(
+            "--project",
+            required=True,
+            type=Path,
+            metavar="PATH",
+            help="Path to an existing project directory.",
+        )
+
+        add_parser = actions.add_parser(
+            "add",
+            help="Add a registered component to an existing project.",
+            description=(
+                "Add a registered component to an explicitly supplied "
+                "existing project directory."
+            ),
+        )
+        add_parser.add_argument(
+            "component_name",
+            metavar="NAME",
+            help="Registered component name.",
+        )
+        add_parser.add_argument(
+            "--project",
+            required=True,
+            type=Path,
+            metavar="PATH",
+            help="Path to an existing project directory.",
+        )
+
+    def execute(self, args: Namespace) -> int:
+        action = getattr(args, "component_action", None)
+
+        if action == "list":
+            self._list()
+            return 0
+        elif action == "installed":
+            return self._installed(args.project)
+        elif action == "add":
+            return self._add(args.component_name, args.project)
+        else:
+            print(f"[ERROR] Unknown component action: '{action}'.")
+            return 1
+
+    def _list(self) -> None:
+        print("=" * 40)
+        print(" ForgePy Components ")
+        print("=" * 40)
+
+        for component in self._get_registry().list_components():
+            metadata = component.metadata
+            print(f"- {metadata.name}: {metadata.description}")
+
+    @staticmethod
+    def _installed(project_path: Path) -> int:
+        try:
+            installed_components = ComponentStateStore(project_path).load()
+        except ForgePyComponentStateError as error:
+            print(f"[ERROR] {error}")
+            return 1
+        except (TypeError, ValueError) as error:
+            print(f"[ERROR] Invalid project path '{project_path}': {error}")
+            return 1
+
+        if not installed_components:
+            print("No installed components.")
+            return 0
+
+        print("Installed components:")
+        for component_name in sorted(installed_components):
+            print(f"- {component_name}")
+
+        return 0
+
+    def _add(self, name: str, project_path: Path) -> int:
+        try:
+            self._get_registry().get(name)
+        except KeyError:
+            print(f"[ERROR] Unknown ForgePy component: '{name}'.")
+            return 1
+
+        try:
+            ComponentInstaller(
+                registry=self._get_registry(),
+            ).install(
+                name=name,
+                project_path=project_path,
+            )
+        except ComponentAlreadyInstalledError as error:
+            print(f"[ERROR] {error}")
+            return 1
+        except ComponentValidationError as error:
+            print(f"[ERROR] {error}")
+            return 1
+        except ForgePyComponentStateError as error:
+            print(f"[ERROR] {error}")
+            return 1
+        except (TypeError, ValueError) as error:
+            print(f"[ERROR] Invalid project path '{project_path}': {error}")
+            return 1
+        except FileExistsError as error:
+            target = error.filename or str(project_path)
+            print(
+                "[ERROR] Component installation refused because the target "
+                f"already exists: '{target}'."
+            )
+            return 1
+        except OSError as error:
+            print(f"[ERROR] Component installation failed: {error}")
+            return 1
+
+        print(
+            f"[OK] Component '{name}' added to project "
+            f"'{project_path}'."
+        )
+        return 0
+
+    def _get_registry(self) -> ComponentRegistry:
+        if self._registry is None:
+            self._registry = ComponentRegistry()
+
+        return self._registry

cli/commands/config_command.py

@@ -0,0 +1,174 @@
+"""
+==================================================
+ForgePy
+Module  : Config Command
+==================================================
+"""
+
+import json
+from argparse import ArgumentParser, Namespace
+
+from cli.command import Command
+from config.user_config import (
+    ConfigStore,
+    ForgePyConfigError,
+    UnknownConfigSettingError,
+)
+
+
+class ConfigCommand(Command):
+    """
+    Manage persistent ForgePy user configuration.
+    """
+
+    name = "config"
+    summary = "Show or update ForgePy user configuration."
+    description = (
+        "Inspect or update the persistent ForgePy configuration stored "
+        "under the current user's home directory."
+    )
+
+    def __init__(
+        self,
+        store: ConfigStore | None = None,
+    ) -> None:
+        self._store = store
+
+    def configure_parser(
+        self,
+        parser: ArgumentParser,
+    ) -> None:
+        actions = parser.add_subparsers(
+            dest="config_action",
+            title="config actions",
+            description="Available configuration actions",
+            metavar="ACTION",
+            required=True,
+        )
+
+        actions.add_parser(
+            "show",
+            help="Show every supported configuration setting.",
+            description=(
+                "Show the effective ForgePy user configuration. "
+                "Missing files use safe defaults without being created."
+            ),
+        )
+
+        set_parser = actions.add_parser(
+            "set",
+            help="Set and persist one supported configuration value.",
+            description=(
+                "Update one supported ForgePy configuration setting "
+                "while preserving all other values."
+            ),
+        )
+        set_parser.add_argument(
+            "setting",
+            metavar="KEY",
+            help=(
+                "Setting to update. Supported keys: "
+                f"{self._supported_settings_text()}."
+            ),
+        )
+        set_parser.add_argument(
+            "value",
+            metavar="VALUE",
+            help="String value to persist for the selected setting.",
+        )
+
+        actions.add_parser(
+            "reset",
+            help="Reset and persist all settings to their defaults.",
+            description=(
+                "Replace the persisted ForgePy user configuration "
+                "with the safe defaults."
+            ),
+        )
+
+    def execute(self, args: Namespace) -> int:
+        action = getattr(
+            args,
+            "config_action",
+            None,
+        )
+
+        try:
+            if action == "show":
+                self._show()
+            elif action == "set":
+                self._set(
+                    setting=args.setting,
+                    value=args.value,
+                )
+            elif action == "reset":
+                self._reset()
+            else:
+                print(
+                    "[ERROR] Unknown ForgePy configuration action: "
+                    f"'{action}'."
+                )
+                return 1
+        except UnknownConfigSettingError as error:
+            print(f"[ERROR] {error}")
+            print(
+                "Supported settings: "
+                f"{self._supported_settings_text()}."
+            )
+            return 1
+        except ForgePyConfigError as error:
+            print(f"[ERROR] {error}")
+            return 1
+
+        return 0
+
+    def _show(self) -> None:
+        config = self._get_store().load()
+
+        print("=" * 40)
+        print(" ForgePy Configuration ")
+        print("=" * 40)
+
+        for setting, value in config.items():
+            print(
+                f"{setting} = "
+                f"{self._display_value(value)}"
+            )
+
+    def _set(
+        self,
+        setting: str,
+        value: str,
+    ) -> None:
+        updated = self._get_store().update(
+            setting,
+            value,
+        )
+
+        print(
+            "[OK] ForgePy configuration updated: "
+            f"{setting} = {self._display_value(updated[setting])}"
+        )
+
+    def _reset(self) -> None:
+        self._get_store().reset()
+        print("[OK] ForgePy configuration reset to defaults.")
+
+    def _get_store(self) -> ConfigStore:
+        if self._store is None:
+            self._store = ConfigStore()
+
+        return self._store
+
+    @staticmethod
+    def _display_value(value: str) -> str:
+        return json.dumps(
+            value,
+            ensure_ascii=False,
+        )
+
+    @staticmethod
+    def _supported_settings_text() -> str:
+        return ", ".join(
+            ConfigStore.defaults()
+        )