haraka 0.2.6__py3-none-any.whl → 0.2.7__py3-none-any.whl

haraka/post_gen/config/config.py

@@ -1,5 +1,10 @@
 from dataclasses import dataclass
 from pathlib import Path
+from typing import Iterable
+import yaml
+from pathspec import PathSpec
+
+_MANIFEST_DIR = Path(__file__).resolve().parent.parent.parent / "manifests"
 
 @dataclass(frozen=True, slots=True)
 class PostGenConfig:
@@ -8,4 +13,25 @@ class PostGenConfig:
     author: str
     description: str
     project_dir: Path
-    swagger: bool
+
+
+def load_manifest(variant: str) -> list[str]:
+    """Return the `keep:` pattern list from `<variant>.yml`."""
+    manifest_path = _MANIFEST_DIR / f"{variant}.yml"
+    if not manifest_path.exists():
+        raise FileNotFoundError(
+            f"No manifest found for variant '{variant}' "
+            f"(expected {manifest_path})"
+        )
+    doc = yaml.safe_load(manifest_path.read_text())
+    if not isinstance(doc, dict) or "keep" not in doc:
+        raise ValueError(f"Manifest {manifest_path} missing a `keep:` section")
+    keep_patterns = doc["keep"]
+    if not isinstance(keep_patterns, Iterable):
+        raise TypeError(f"`keep` section in {manifest_path} must be a list")
+    return list(keep_patterns)
+
+
+def build_spec(patterns: Iterable[str]) -> PathSpec:
+    """Compile patterns using git-style wildmatch syntax."""
+    return PathSpec.from_lines("gitwildmatch", patterns)

haraka/post_gen/runner.py

@@ -4,10 +4,10 @@ from haraka.art.create import Create
 from haraka.art.ascii.assets import *
 from .config import PostGenConfig
 from haraka.utils import divider, Logger
-from haraka.post_gen.utils.command import CommandRunner
-from haraka.post_gen.utils.files import FileOps
-from haraka.post_gen.utils.purge import ResourcePurger
-from haraka.post_gen.utils.gitops import GitOps
+from haraka.post_gen.service.command import CommandRunner
+from haraka.post_gen.service.files import FileOps
+from haraka.post_gen.service.purge import ResourcePurger
+from haraka.post_gen.service.gitops import GitOps
 
 
 def main(cfg: PostGenConfig) -> None:
@@ -38,7 +38,7 @@ def main(cfg: PostGenConfig) -> None:
 
     divider("🎉 Project generation complete 🎉")
 
-    if cfg.language == "go" and not cfg.swagger:
+    if cfg.language == "go-grpc-protoc":
         go_emoji_logo = [emoji["go"]]
         go_performance_mode = [
             goLang, divider_xl, performance_mode, divider_l, tools, divider_s,

haraka/post_gen/service/purge.py

@@ -0,0 +1,85 @@
+#!/usr/bin/env python3
+"""
+haraka.post_gen.utils.purge
+
+Delete all template artefacts that are **not** required for the chosen
+variant, as defined by a YAML manifest in `haraka/manifests/<variant>.yml`.
+
+Manifest format (git-wildmatch globs):
+
+    variant: python-fastapi
+    keep:
+      - src/app/**
+      - tests/**
+      - Dockerfile
+      - chart/**
+
+Anything matching a `keep:` pattern survives. Everything else is removed.
+
+Requires:  pip install pathspec PyYAML
+"""
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Iterable
+
+import yaml
+from pathspec import PathSpec
+
+from .files import FileOps
+from haraka.utils import Logger, divider
+from ..config import config
+
+_MANIFEST_DIR = Path(__file__).resolve().parent.parent.parent / "manifests"
+
+
+# --------------------------------------------------------------------------- #
+# main purger                                                                 #
+# --------------------------------------------------------------------------- #
+class ResourcePurger:
+    """Filesystem cleaner driven by variant manifest files."""
+
+    def __init__(self, fops: FileOps, logger: Logger | None = None) -> None:
+        self._f = fops
+        self._log = logger or Logger("ResourcePurger")
+
+    # ------------------------------ public API ----------------------------- #
+    def purge(self, variant: str, project_dir: Path) -> None:
+        """
+        Remove everything outside the manifest’s `keep:` patterns.
+
+        Parameters
+        ----------
+        variant
+            Variant key, e.g. ``python-fastapi`` or ``go-grpc-protoc``.
+        project_dir
+            Root of the freshly generated Cookiecutter project.
+        """
+        variant = variant.lower()
+        self._log.info(f"Starting purge for variant: {variant}")
+
+        keep_patterns = config.load_manifest(variant)
+        spec = config.build_spec(keep_patterns)
+
+        self._log.info(f"Keeping {len(keep_patterns)} pattern(s)")
+
+        self._purge_unrelated(project_dir, spec)
+
+        divider("Project tree after purge…")
+        self._f.print_tree(project_dir)
+
+    # ----------------------------- internals ------------------------------ #
+    def _purge_unrelated(self, root: Path, spec: PathSpec) -> None:
+        """
+        Walk the project tree; delete every path NOT matched by *spec*.
+        """
+        for path in root.rglob("*"):
+            rel = path.relative_to(root).as_posix()
+
+            if spec.match_file(rel):
+                continue  # keep it
+
+            if path.is_dir():
+                self._f.remove_dir(path)
+            else:
+                self._f.remove_file(path)

haraka/utils/__init__.py

@@ -1,5 +1,5 @@
 from haraka.post_gen.config import PostGenConfig
 from .logging.log_util import Logger
 from .common.utils import *
-from haraka.post_gen.utils.assets import *
+from haraka.post_gen.service.assets import *
 __all__ = ["PostGenConfig", "", "divider", "Logger", "LANGUAGE_ASSETS", "GLOBAL_ASSETS"]

{haraka-0.2.6.dist-info → haraka-0.2.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: haraka
-Version: 0.2.6
+Version: 0.2.7
 Summary: Reusable post-generation helper for Cookiecutter micro-service templates
 Author-email: Will Burks <will@example.com>
 License: MIT

{haraka-0.2.6.dist-info → haraka-0.2.7.dist-info}/RECORD

@@ -8,21 +8,21 @@ haraka/art/ascii/frame/border.py,sha256=n7qaLxzzBmf8ewatbe5gN97DO4afZM67bBjpU1Oq
 haraka/art/ascii/frame/framer.py,sha256=s_-lsb-hGhlH_73q5iTtk8KHW0MSeSHSAvNFVmL1c9A,3951
 haraka/art/ascii/frame/width_utils.py,sha256=in4AV3gTBBXUX6N01j67Icu9vsHFomybBN8rpL3sQ5s,810
 haraka/post_gen/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-haraka/post_gen/runner.py,sha256=HuWKMoHVcF-SLZK9HYLb1NLO1sqnl9Sr92xmFqWbOR4,1816
+haraka/post_gen/runner.py,sha256=a5S3OfOcjv1p5NX5y_XHWRWDENBilsjvbSFayOILj9s,1816
 haraka/post_gen/config/__init__.py,sha256=-_XkJ_Dni28yJCMfIceQSiH1wa_hHsZMoBTyvR9Ikbc,62
-haraka/post_gen/config/config.py,sha256=VpRgp_-dU1sJd3Jow3MAOeerqElzBcHdkSqvgd1bkwk,234
-haraka/post_gen/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-haraka/post_gen/utils/assets.py,sha256=UARi1iDczVHoNGm5FpKkSXCk-yvnzyMMtSJM1SxMRSA,6157
-haraka/post_gen/utils/command.py,sha256=5yxPSQmQpzAyPNoLtzxaUz1VWgPnTfD7XlkBUu5rIeI,1672
-haraka/post_gen/utils/files.py,sha256=1hPHn_nYI5A2JKJqxmNFK5fpo9DNPcGR4K7qCPOO5GE,1993
-haraka/post_gen/utils/gitops.py,sha256=hRnztg_5yW3L_bdh05gcgGQ25wwjSTn8pX1sja-m91s,2434
-haraka/post_gen/utils/purge.py,sha256=9EQg-CdFVnjEo-KY9_Au_emicpZId7z2-QyWFPLty-M,2633
-haraka/utils/__init__.py,sha256=dqjKz10MTfH6fFl68cu_giWYYZ41HAUDg_0-OwC1qjE,246
+haraka/post_gen/config/config.py,sha256=-2L_VXRHCioT6nNrCMGYzfJIGrYCjpf33aRhCukJEaM,1253
+haraka/post_gen/service/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+haraka/post_gen/service/assets.py,sha256=UARi1iDczVHoNGm5FpKkSXCk-yvnzyMMtSJM1SxMRSA,6157
+haraka/post_gen/service/command.py,sha256=5yxPSQmQpzAyPNoLtzxaUz1VWgPnTfD7XlkBUu5rIeI,1672
+haraka/post_gen/service/files.py,sha256=1hPHn_nYI5A2JKJqxmNFK5fpo9DNPcGR4K7qCPOO5GE,1993
+haraka/post_gen/service/gitops.py,sha256=hRnztg_5yW3L_bdh05gcgGQ25wwjSTn8pX1sja-m91s,2434
+haraka/post_gen/service/purge.py,sha256=cNs2pHkXN1EJS7RIGR7pAmqJcyQ4eUbhkGpPqrq0Zv4,2656
+haraka/utils/__init__.py,sha256=3WDKxExMNfIrsYqnO0somSJavCJc5_s56S7ffbnXmzc,248
 haraka/utils/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 haraka/utils/common/utils.py,sha256=kMnMXe_hcxGkD0MKGmR1lIwsRND7BaFPRbGN4PwonfM,360
 haraka/utils/logging/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 haraka/utils/logging/log_util.py,sha256=rl-VnSPns84MPDp7SwArtrO4oPHUPUiRNdkp0NBvxsY,778
-haraka-0.2.6.dist-info/METADATA,sha256=eas99sXOXhJe9zPkVz3XI_qo3e-RyifQBmeLp6vvYmg,578
-haraka-0.2.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-haraka-0.2.6.dist-info/top_level.txt,sha256=1khpwypLKWoklVd_CgFiwAfcctVSXRoRPc3BI9lyIXo,7
-haraka-0.2.6.dist-info/RECORD,,
+haraka-0.2.7.dist-info/METADATA,sha256=3jnqlwSLI-7_43h7Mal44W977NZZWqACzx8EXbx7QV4,578
+haraka-0.2.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+haraka-0.2.7.dist-info/top_level.txt,sha256=1khpwypLKWoklVd_CgFiwAfcctVSXRoRPc3BI9lyIXo,7
+haraka-0.2.7.dist-info/RECORD,,

haraka/post_gen/utils/purge.py

@@ -1,70 +0,0 @@
-# haraka/post_gen/utils/purge.py
-from pathlib import Path
-from typing import Dict, Set
-
-from .files import FileOps
-from haraka.utils import Logger, divider
-from haraka.post_gen.utils.assets import LANGUAGE_ASSETS, GLOBAL_ASSETS
-
-
-class ResourcePurger:
-    """Delete template artefacts not relevant to the selected language."""
-
-    def __init__(self, fops: FileOps, logger: Logger | None = None) -> None:
-        self._f = fops
-        self._log = logger or Logger("ResourcePurger")
-
-        # Build a quick lookup: language → {"files": set, "dirs": set}
-        self._index: Dict[str, Dict[str, Set[str]]] = {
-            spec["language"]: {
-                "files": set(spec["files"]),
-                # store directory names *without* trailing “/”
-                "dirs": {d.rstrip("/") for d in spec["dirs"]},
-            }
-            for spec in LANGUAGE_ASSETS
-        }
-
-    # ------------------------------------------------------------------ #
-    # public API                                                          #
-    # ------------------------------------------------------------------ #
-    def purge(self, language: str, project_dir: Path) -> None:
-        language = language.lower()
-        if language not in self._index:
-            self._log.warn(f"Unrecognised language '{language}'; skipping purge.")
-            return
-
-        self._log.info(f"Starting purge for language: {language}")
-
-        keep_files = self._index[language]["files"] | set(GLOBAL_ASSETS["files"])
-        keep_dirs  = self._index[language]["dirs"]  | {
-            d.rstrip("/") for d in GLOBAL_ASSETS["dirs"]
-        }
-
-        self._log.info(f"Keeping {len(keep_files)} files & {len(keep_dirs)} dirs")
-
-        self._purge_unrelated(project_dir, keep_files, keep_dirs)
-
-        divider("Project tree after purge…")
-        self._f.print_tree(project_dir)
-
-    # ------------------------------------------------------------------ #
-    # internals                                                           #
-    # ------------------------------------------------------------------ #
-    def _purge_unrelated(
-        self,
-        root: Path,
-        keep_files: Set[str],
-        keep_dirs: Set[str],
-    ) -> None:
-        for path in root.rglob("*"):
-            rel = path.relative_to(root).as_posix()
-
-            inside_kept_dir = any(rel.startswith(d + "/") for d in keep_dirs)
-
-            if rel in keep_files or rel in keep_dirs or inside_kept_dir:
-                continue  # safe
-
-            if path.is_dir():
-                self._f.remove_dir(path)
-            else:
-                self._f.remove_file(path)