forgepy-cli 1.0.0__py3-none-any.whl

templates/library/library_files.py

@@ -0,0 +1,28 @@
+"""
+==================================================
+ForgePy
+Library Template Files
+==================================================
+"""
+
+from templates.template_manager import TemplateManager
+
+
+class LibraryFiles:
+    """Build the minimal file mapping for a Python library project."""
+
+    @staticmethod
+    def build(
+        project_name: str,
+        package_name: str,
+    ) -> dict[str, str]:
+        template_manager = TemplateManager()
+
+        return {
+            "README.md": template_manager.get_readme(project_name),
+            ".gitignore": template_manager.get_gitignore(),
+            "requirements.txt": "",
+            "pyproject.toml": template_manager.get_pyproject(project_name),
+            f"{package_name}/__init__.py": "",
+            "tests/__init__.py": "",
+        }

templates/library/library_template.py

@@ -0,0 +1,56 @@
+"""
+==================================================
+ForgePy
+Library Template
+==================================================
+"""
+
+from pathlib import Path
+
+from templates.library.library_files import LibraryFiles
+from templates.template_engine.file_template import FileTemplate
+from templates.template_engine.package_name import normalize_package_name
+from templates.template_engine.template_context import TemplateContext
+from templates.template_engine.template_metadata import TemplateMetadata
+
+
+class LibraryTemplate(FileTemplate):
+    """Generate a minimal reusable Python package project."""
+
+    _METADATA = TemplateMetadata(
+        name="library",
+        description="Reusable Python package template.",
+        version="0.1.0",
+        author="Rendy Zou",
+        tags=("python", "library", "package"),
+    )
+
+    _DEFAULT_VSCODE_ENTRY_POINT = None
+
+    def _build_context(
+        self,
+        project_path: Path,
+    ) -> TemplateContext:
+        return TemplateContext(
+            project_path=project_path,
+            package_name=self._normalize_package_name(project_path.name),
+        )
+
+    def _folders(self, context: TemplateContext) -> tuple[str, ...]:
+        return (
+            context.require_package_name(),
+            "tests",
+        )
+
+    def _files(self, context: TemplateContext) -> dict[str, str]:
+        return LibraryFiles.build(
+            project_name=context.project_name,
+            package_name=context.require_package_name(),
+        )
+
+    @staticmethod
+    def _normalize_package_name(project_name: str) -> str:
+        return normalize_package_name(
+            project_name,
+            package_label="library",
+        )

templates/license_template.py

@@ -0,0 +1,21 @@
+"""
+==================================================
+ForgePy
+License Template
+==================================================
+"""
+
+
+def get_license(author: str = "Your Name") -> str:
+    return f"""MIT License
+
+Copyright (c) 2026 {author}
+
+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.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.
+"""

templates/pyproject_template.py

@@ -0,0 +1,15 @@
+"""
+==================================================
+ForgePy
+PyProject Template
+==================================================
+"""
+
+
+def get_pyproject(project_name: str) -> str:
+    return f"""[project]
+name = "{project_name}"
+version = "0.1.0"
+description = ""
+requires-python = ">=3.12"
+"""

templates/readme_template.py

@@ -0,0 +1,15 @@
+"""
+==================================================
+ForgePy
+Readme Template
+==================================================
+"""
+
+
+def get_readme(project_name: str) -> str:
+    return f"""# {project_name}
+
+Generated by ForgePy.
+
+Version: 0.1
+"""

templates/requirements_template.py

@@ -0,0 +1,13 @@
+"""
+==================================================
+ForgePy
+Requirements Template
+==================================================
+"""
+
+
+def get_requirements() -> str:
+    return """PySide6
+pandas
+openpyxl
+"""

templates/template_engine/base_template.py

@@ -0,0 +1,58 @@
+"""
+==================================================
+ForgePy
+Base Template
+==================================================
+"""
+
+from abc import ABC, abstractmethod
+from pathlib import Path
+
+from templates.template_engine.template_metadata import TemplateMetadata
+
+
+class BaseTemplate(ABC):
+    """
+    Seluruh template harus mewarisi class ini.
+    """
+
+    @property
+    @abstractmethod
+    def name(self) -> str:
+        """
+        Nama template.
+        """
+        pass
+
+    @property
+    def metadata(self) -> TemplateMetadata:
+        """Return compatibility metadata for legacy template subclasses."""
+
+        return TemplateMetadata(
+            name=self.name,
+            description="",
+            version="",
+            author="",
+            tags=(),
+        )
+
+    @property
+    def vscode_entry_point(self) -> str | None:
+        """Return the file VS Code should launch for this template."""
+
+        return "app.py"
+
+    def preflight(self, project_path: Path) -> None:
+        """Validate template-specific inputs before project creation."""
+
+        del project_path
+
+    @abstractmethod
+    def create(
+        self,
+        project_path: Path,
+    ) -> None:
+        """
+        Membuat project.
+        """
+        pass

templates/template_engine/file_template.py

@@ -0,0 +1,76 @@
+"""Shared execution for templates backed by folders and file mappings."""
+
+from abc import abstractmethod
+from pathlib import Path
+from typing import ClassVar
+
+from builders.file_builder import FileBuilder
+from builders.folder_builder import FolderBuilder
+from templates.template_engine.base_template import BaseTemplate
+from templates.template_engine.template_context import TemplateContext
+from templates.template_engine.template_metadata import TemplateMetadata
+
+
+class FileTemplate(BaseTemplate):
+    """Write template-owned folders and files from focused subclass hooks."""
+
+    _METADATA: ClassVar[TemplateMetadata]
+    _DEFAULT_VSCODE_ENTRY_POINT: ClassVar[str | None]
+
+    def __init__(self) -> None:
+        self._vscode_entry_point: str | None = (
+            self._DEFAULT_VSCODE_ENTRY_POINT
+        )
+
+    @property
+    def metadata(self) -> TemplateMetadata:
+        return self._METADATA
+
+    @property
+    def name(self) -> str:
+        return self.metadata.name
+
+    @property
+    def vscode_entry_point(self) -> str | None:
+        return self._vscode_entry_point
+
+    def preflight(self, project_path: Path) -> None:
+        """Build context to validate template-specific inputs."""
+
+        self._build_context(project_path)
+
+    def create(self, project_path: Path) -> None:
+        context = self._build_context(project_path)
+
+        FolderBuilder().create(
+            context.project_path,
+            list(self._folders(context)),
+        )
+
+        file_builder = FileBuilder()
+
+        for filename, content in self._files(context).items():
+            file_builder.write(
+                context.project_path / filename,
+                content,
+            )
+
+        self._vscode_entry_point = self._vscode_entry_point_for(context)
+
+    def _build_context(self, project_path: Path) -> TemplateContext:
+        return TemplateContext(project_path=project_path)
+
+    @abstractmethod
+    def _folders(self, context: TemplateContext) -> tuple[str, ...]:
+        """Return template-owned folders in creation order."""
+
+    @abstractmethod
+    def _files(self, context: TemplateContext) -> dict[str, str]:
+        """Return template-owned file content in write order."""
+
+    def _vscode_entry_point_for(
+        self,
+        context: TemplateContext,
+    ) -> str | None:
+        del context
+        return self._DEFAULT_VSCODE_ENTRY_POINT

templates/template_engine/package_name.py

@@ -0,0 +1,30 @@
+import keyword
+import re
+
+
+def normalize_package_name(
+    project_name: str,
+    *,
+    package_label: str,
+) -> str:
+    """Return a stable ASCII Python package name for a project."""
+
+    package_name = re.sub(
+        r"[^a-z0-9_]+",
+        "_",
+        project_name.lower(),
+    ).strip("_")
+
+    if not package_name:
+        raise ValueError(
+            "Project name must contain letters or digits for the "
+            f"{package_label} package."
+        )
+
+    if package_name[0].isdigit():
+        package_name = f"_{package_name}"
+
+    if keyword.iskeyword(package_name):
+        package_name = f"{package_name}_"
+
+    return package_name

templates/template_engine/template_context.py

@@ -0,0 +1,24 @@
+"""Per-generation data used by file-based templates."""
+
+from dataclasses import dataclass
+from pathlib import Path
+
+
+@dataclass(frozen=True, slots=True)
+class TemplateContext:
+    """Keep project and optional package names together during generation."""
+
+    project_path: Path
+    package_name: str | None = None
+
+    @property
+    def project_name(self) -> str:
+        return self.project_path.name
+
+    def require_package_name(self) -> str:
+        """Return the package name for package-oriented templates."""
+
+        if self.package_name is None:
+            raise ValueError("Template context does not define a package name.")
+
+        return self.package_name

templates/template_engine/template_files.py

@@ -0,0 +1,10 @@
+"""Compatibility facade for the original basic-template file API."""
+
+from templates.basic.basic_files import BasicFiles
+
+
+class TemplateFiles:
+
+    @staticmethod
+    def basic(project_name: str) -> dict[str, str]:
+        return BasicFiles.build(project_name)

templates/template_engine/template_metadata.py

@@ -0,0 +1,59 @@
+"""
+==================================================
+ForgePy
+Template Metadata
+==================================================
+"""
+
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True, slots=True)
+class TemplateMetadata:
+    """Describe a registered project template."""
+
+    name: str
+    description: str
+    version: str
+    author: str
+    tags: tuple[str, ...]
+
+    def __post_init__(self) -> None:
+        for field_name in (
+            "name",
+            "description",
+            "version",
+            "author",
+        ):
+            if not isinstance(getattr(self, field_name), str):
+                raise TypeError(
+                    f"Template metadata {field_name} must be a string."
+                )
+
+        if not self.name.strip():
+            raise ValueError(
+                "Template metadata name must not be empty."
+            )
+
+        if isinstance(self.tags, (str, bytes)):
+            raise TypeError(
+                "Template metadata tags must be an iterable of strings."
+            )
+
+        try:
+            normalized_tags = tuple(self.tags)
+        except TypeError as error:
+            raise TypeError(
+                "Template metadata tags must be an iterable of strings."
+            ) from error
+
+        if not all(isinstance(tag, str) for tag in normalized_tags):
+            raise TypeError(
+                "Template metadata tags must contain only strings."
+            )
+
+        object.__setattr__(
+            self,
+            "tags",
+            normalized_tags,
+        )

templates/template_engine/template_registry.py

@@ -0,0 +1,107 @@
+"""
+==================================================
+ForgePy
+Template Registry
+==================================================
+"""
+
+from dataclasses import dataclass
+
+from templates.basic.basic_template import BasicTemplate
+from templates.cli.cli_template import CliTemplate
+from templates.library.library_template import LibraryTemplate
+from templates.template_engine.base_template import BaseTemplate
+from templates.template_engine.template_metadata import TemplateMetadata
+
+
+@dataclass(frozen=True, slots=True)
+class _TemplateRegistration:
+    template: BaseTemplate
+    metadata: TemplateMetadata
+
+
+class TemplateRegistry:
+
+    def __init__(self) -> None:
+
+        self._registrations: dict[str, _TemplateRegistration] = {}
+
+        self.register(BasicTemplate())
+        self.register(LibraryTemplate())
+        self.register(CliTemplate())
+
+    @property
+    def templates(self) -> dict[str, BaseTemplate]:
+        """Return a compatibility snapshot of registered templates."""
+
+        return {
+            name: registration.template
+            for name, registration in self._registrations.items()
+        }
+
+    def register(
+        self,
+        template: BaseTemplate,
+    ) -> None:
+        """Register a template using its metadata name as the lookup key."""
+
+        if not isinstance(template, BaseTemplate):
+            raise TypeError("Template must inherit from BaseTemplate.")
+
+        template_name = template.name
+
+        if not isinstance(template_name, str):
+            raise TypeError("Template name must be a string.")
+
+        if not template_name.strip():
+            raise ValueError("Template name must not be empty.")
+
+        metadata = template.metadata
+
+        if not isinstance(metadata, TemplateMetadata):
+            raise TypeError("Template metadata must be TemplateMetadata.")
+
+        if not metadata.name.strip():
+            raise ValueError("Template metadata name must not be empty.")
+
+        if template_name != metadata.name:
+            raise ValueError(
+                "Template name and metadata name must match."
+            )
+
+        if metadata.name in self._registrations:
+            raise ValueError(
+                f"Template '{metadata.name}' is already registered."
+            )
+
+        self._registrations[metadata.name] = _TemplateRegistration(
+            template=template,
+            metadata=metadata,
+        )
+
+    def get(
+        self,
+        name: str,
+    ) -> BaseTemplate:
+
+        return self._registrations[name].template
+
+    def get_metadata(
+        self,
+        name: str,
+    ) -> TemplateMetadata:
+        """Return metadata for one registered template."""
+
+        return self._registrations[name].metadata
+
+    def list_templates(self) -> dict[str, BaseTemplate]:
+
+        return self.templates
+
+    def list_metadata(self) -> tuple[TemplateMetadata, ...]:
+        """Return registered metadata in registration order."""
+
+        return tuple(
+            registration.metadata
+            for registration in self._registrations.values()
+        )

templates/template_manager.py

@@ -0,0 +1,58 @@
+"""
+==================================================
+ForgePy
+Template Manager
+==================================================
+"""
+
+from templates.app_template import get_app
+from templates.gitignore_template import get_gitignore
+from templates.readme_template import get_readme
+from templates.requirements_template import get_requirements
+
+from templates.license_template import get_license
+from templates.changelog_template import get_changelog
+from templates.env_template import (
+    get_env,
+    get_env_example,
+)
+from templates.pyproject_template import get_pyproject
+
+
+class TemplateManager:
+
+    def get_app(
+        self,
+        project_name: str,
+    ) -> str:
+        return get_app(project_name)
+
+    def get_gitignore(self) -> str:
+        return get_gitignore()
+
+    def get_readme(
+        self,
+        project_name: str,
+    ) -> str:
+        return get_readme(project_name)
+
+    def get_requirements(self) -> str:
+        return get_requirements()
+
+    def get_license(self) -> str:
+        return get_license()
+
+    def get_changelog(self) -> str:
+        return get_changelog()
+
+    def get_env(self) -> str:
+        return get_env()
+
+    def get_env_example(self) -> str:
+        return get_env_example()
+
+    def get_pyproject(
+        self,
+        project_name: str,
+    ) -> str:
+        return get_pyproject(project_name)

templates/vscode/extensions_template.py

@@ -0,0 +1,32 @@
+"""
+==================================================
+ForgePy
+Author  : Rendy Zou
+Module  : VSCode Extensions Template
+==================================================
+
+Deskripsi:
+- Merekomendasikan extension Visual Studio Code.
+"""
+
+import json
+
+
+def build() -> str:
+
+    extensions = {
+        "recommendations": [
+            "ms-python.python",
+            "ms-python.debugpy",
+            "ms-python.vscode-pylance",
+            "ms-python.black-formatter",
+            "charliermarsh.ruff",
+            "eamodio.gitlens"
+        ]
+    }
+
+    return json.dumps(
+        extensions,
+        indent=4,
+        ensure_ascii=False,
+    )

templates/vscode/launch_template.py

@@ -0,0 +1,41 @@
+"""
+==================================================
+ForgePy
+Author  : Rendy Zou
+Module  : VSCode Launch Template
+==================================================
+
+Deskripsi:
+- Template launch.json untuk Visual Studio Code.
+- Menambahkan konfigurasi F5 hanya jika template memiliki entry point.
+"""
+
+import json
+
+
+def build(entry_point: str | None = "app.py") -> str:
+
+    configurations = []
+
+    if entry_point is not None:
+        configurations.append(
+            {
+                "name": f"Python: {entry_point}",
+                "type": "debugpy",
+                "request": "launch",
+                "program": f"${{workspaceFolder}}/{entry_point}",
+                "console": "integratedTerminal",
+                "justMyCode": True,
+            }
+        )
+
+    launch = {
+        "version": "0.2.0",
+        "configurations": configurations,
+    }
+
+    return json.dumps(
+        launch,
+        indent=4,
+        ensure_ascii=False,
+    )