haraka 0.2.5__py3-none-any.whl

haraka/__init__.py

@@ -0,0 +1,4 @@
+"""cookiecutter post-generation helper package."""
+from haraka.post_gen.runner import main
+from haraka.post_gen.config import PostGenConfig
+__all__ = ["main", "PostGenConfig"]

haraka/art/__init__.py

@@ -0,0 +1,3 @@
+from .ascii.frame import framer
+from haraka.art.ascii.frame import TextFramer
+__all__ = ["TextFramer", "framer"]

haraka/art/ascii/assets.py

@@ -0,0 +1,200 @@
+goLang = f"""
+\u200B   ____       _                       \u200B      
+\u200B  / ___| ___ | |    __ _ _ __   __ _  \u200B      
+\u200B | |  _ / _ \| |   / _` | '_ \ / _` | \u200B      
+\u200B | |_| | (_) | |__| (_| | | | | (_| | \u200B      
+\u200B  \____|\___/|_____\__,_|_| |_|\__, | \u200B      
+\u200B                               |___/  \u200B      
+"""
+protoC_Mode = """
+\u200B  ____            _         ____    __  __           _       \u200B
+\u200B |  _ \ _ __ ___ | |_ ___  / ___|  |  \/  | ___   __| | ___  \u200B
+\u200B | |_) | '__/ _ \| __/ _ \| |      | |\/| |/ _ \ / _` |/ _ \ \u200B
+\u200B |  __/| | | (_) | || (_) | |___   | |  | | (_) | (_| |  __/ \u200B
+\u200B |_|   |_|  \___/ \__\___/ \____|  |_|  |_|\___/ \__,_|\___| \u200B                                                    
+"""
+goFast = f"""
+\u200B  ____   ___     _____  _    ____  _____  \u200B
+\u200B / ___|/  _  \  |  ___|/ \  / ___| _   _| \u200B
+\u200B | |  _| | | |  | |__ / _ \ \___ \  | |   \u200B
+\u200B | |_| | |_| |  | |__/ ___ \ ___) | | |   \u200B
+\u200B  \___/ \___ /  |_| /_/   \_\____/  |_|   \u200B
+"""
+
+emoji = {
+    "goFast": f"""
+    \u200B 🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩 \u200B 
+    \u200B 🟩🟩⬜⬜⬜⬜🟩🟩🟩⬜⬜⬜🟩🟩🟩⬜⬜⬜⬜⬜🟩🟩🟩🟩⬜🟩🟩🟩🟩🟩⬜⬜⬜⬜🟩🟩⬜⬜⬜⬜⬜🟩 \u200B 
+    \u200B 🟩⬜🟩🟩🟩🟩🟩🟩⬜🟩🟩🟩⬜🟩🟩⬜🟩🟩🟩🟩🟩🟩🟩⬜🟩⬜🟩🟩🟩⬜🟩🟩🟩🟩🟩🟩🟩🟩⬜🟩🟩🟩 \u200B 
+    \u200B 🟩⬜🟩🟩⬜⬜🟩🟩⬜🟩🟩🟩⬜🟩🟩⬜⬜⬜⬜🟩🟩🟩⬜🟩🟩🟩⬜🟩🟩🟩⬜⬜⬜🟩🟩🟩🟩🟩⬜🟩🟩🟩 \u200B 
+    \u200B 🟩⬜🟩🟩🟩⬜🟩🟩⬜🟩🟩🟩⬜🟩🟩⬜🟩🟩🟩🟩🟩🟩⬜⬜⬜⬜⬜🟩🟩🟩🟩🟩🟩⬜🟩🟩🟩🟩⬜🟩🟩🟩 \u200B 
+    \u200B 🟩🟩⬜⬜⬜⬜🟩🟩🟩⬜⬜⬜🟩🟩🟩⬜🟩🟩🟩🟩🟩🟩⬜🟩🟩🟩⬜🟩🟩⬜⬜⬜⬜🟩🟩🟩🟩🟩⬜🟩🟩🟩 \u200B 
+    \u200B 🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩 \u200B 
+""",
+    "go": f"""
+    \u200B🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩\u200B
+    \u200B🟩🟩⬜⬜⬜⬜🟩🟩🟩⬜⬜⬜🟩🟩\u200B
+    \u200B🟩⬜🟩🟩🟩🟩🟩🟩⬜🟩🟩🟩⬜🟩\u200B
+    \u200B🟩⬜🟩🟩⬜⬜🟩🟩⬜🟩🟩🟩⬜🟩\u200B
+    \u200B🟩⬜🟩🟩🟩⬜🟩🟩⬜🟩🟩🟩⬜🟩\u200B
+    \u200B🟩🟩⬜⬜⬜⬜🟩🟩🟩⬜⬜⬜🟩🟩\u200B
+    \u200B🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩\u200B
+    """
+}
+
+gRpc_ProtoBuf = f"""
+\u200B        ____  ____   ____      ____            _        ____         __  \u200B
+\u200B   __ _|  _ \|  _ \ / ___|    |  _ \ _ __ ___ | |_ ___ | __ ) _   _ / _| \u200B
+\u200B  / _` | |_) | |_) | |   _____| |_) | '__/ _ \| __/ _ \|  _ \| | | | |_| \u200B
+\u200B | (_| |  _ <|  __/| |__|_____|  __/| | | (_) | || (_) | |_) | |_| |  _| \u200B
+\u200B \__,  |_| \_\_|    \____|    |_|   |_|  \___/ \__\___/|____/ \__,_|_|   \u200B
+\u200B |___/                                                                   \u200B                                                                    
+"""
+swaggerUI = """
+\u200B  ____                                     _   _ ___  \u200B
+\u200B / ___|_      ____ _  __ _  __ _  ___ _ __| | | |_ _| \u200B
+\u200B \___ \ \ /\ / / _` |/ _` |/ _` |/ _ \ '__| | | || |  \u200B
+\u200B  ___) \ V  V / (_| | (_| | (_| |  __/ |  | |_| || |  \u200B
+\u200B |____/ \_/\_/ \__,_|\__, |\__, |\___|_|   \___/|___| \u200B
+\u200B                     |___/ |___/                      \u200B
+"""
+server = """
+\u200B  ____                            \u200B
+\u200B / ___|  ___ _ ____   _____ _ __  \u200B
+\u200B \___ \ / _ \ '__\ \ / / _ \ '__| \u200B
+\u200B  ___) |  __/ |   \ V /  __/ |    \u200B
+\u200B |____/ \___|_|    \_/ \___|_|    \u200B
+"""
+divider_mono = f"""
+\u200B  _____  \u200B 
+\u200B |_____| \u200B 
+"""
+divider_xs = f"""
+\u200B  _____ _____  \u200B 
+\u200B |_____|_____| \u200B 
+"""
+divider_s = f"""
+\u200B  _____ _____ _____  \u200B 
+\u200B |_____|_____|_____| \u200B 
+"""
+divider_m = f"""
+\u200B  _____ _____ _____ _____ _____  \u200B 
+\u200B |_____|_____|_____|_____|_____| \u200B 
+"""
+divider_l = f"""
+\u200B  _____ _____ _____ _____ _____ _____ _____ _____  \u200B 
+\u200B |_____|_____|_____|_____|_____|_____|_____|_____| \u200B 
+"""
+divider_xl = f"""
+\u200B  _____ _____ _____ _____ _____ _____ _____ _____ _____ _____ _____ _____ _____  \u200B 
+\u200B |_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|_____| \u200B 
+"""
+by_google = f"""                                                                                                              
+\u200B  _               ____                   _       \u200B      
+\u200B | |__  _   _    / ___| ___   ___   __ _| | ___  \u200B      
+\u200B | '_ \| | | |  | |  _ / _ \ / _ \ / _` | |/ _ \ \u200B      
+\u200B | |_) | |_| |  | |_| | (_) | (_) | (_| | |  __/ \u200B      
+\u200B |_.__/ \__, |   \____|\___/ \___/ \__, |_|\___| \u200B      
+\u200B         |___/                     |___/         \u200B                                                                                                   
+"""
+by = """
+\u200B  _____ _   __ \u200B
+\u200B | __ )  \ / / \u200B
+\u200B |  _ \ \ V /  \u200B
+\u200B | |_) | | |   \u200B
+\u200B |____/  |_|   \u200B
+"""
+wjb_dev = f"""
+\u200B __        __  _ ____   ____  _______     __ \u200B
+\u200B \ \      / / | | __ ) |  _ \| ____\ \   / / \u200B
+\u200B  \ \ /\ / /  | |  _ \ | | | |  _|  \ \ / /  \u200B 
+\u200B   \ V  V / |_| | |_) || |_| | |___  \ V /   \u200B
+\u200B    \_/\_/ \___/|____(_)____/|_____|  \_/    \u200B
+"""
+
+gRPCurl = f"""
+\u200B        ____  ____   ____           _  \u200B
+\u200B   __ _|  _ \|  _ \ / ___|   _ _ __| | \u200B
+\u200B  / _` | |_) | |_) | |  | | | | '__| | \u200B
+\u200B | (_| |  _ <|  __/| |__| |_| | |  | | \u200B
+\u200B  \__, |_| \_\_|    \____\__,_|_|  |_| \u200B
+\u200B  |___/                                \u200B
+"""
+zeroLog = """
+\u200B  _____              _                 \u200B
+\u200B |__  /___ _ __ ___ | |    ___   __ _  \u200B
+\u200B   / // _ \ '__/ _ \| |   / _ \ / _` | \u200B
+\u200B  / /|  __/ | | (_) | |__| (_) | (_| | \u200B
+\u200B /____\___|_|  \___/|_____\___/ \__, | \u200B
+\u200B                                |___/  \u200B
+"""
+gRPC = f"""
+\u200B        ____  ____   ____  \u200B
+\u200B   __ _|  _ \|  _ \ / ___| \u200B
+\u200B  / _` | |_) | |_) | |     \u200B
+\u200B | (_| |  _ <|  __/| |___  \u200B
+\u200B \__, |_| \_\_|    \____|  \u200B
+\u200B  |___/                    \u200B
+"""
+autoMaxProcs = f"""
+\u200B     _         _        __  __            ____                      \u200B
+\u200B    / \  _   _| |_ ___ |  \/  | __ ___  _|  _ \ _ __ ___   ___ ___  \u200B
+\u200B   / _ \| | | | __/ _ \| |\/| |/ _` \ \/ / |_) | '__/ _ \ / __/ __| \u200B
+\u200B  / ___ \ |_| | || (_) | |  | | (_| |>  <|  __/| | | (_) | (__\__ \ \u200B
+\u200B /_/   \_\__,_|\__\___/|_|  |_|\__,_/_/\_\_|   |_|  \___/ \___|___/ \u200B                                                               
+"""
+ants = f"""
+\u200B     _          _        \u200B
+\u200B    / \   _ __ | |_ ___  \u200B
+\u200B   / _ \ | '_ \| __/ __| \u200B
+\u200B  / ___ \| | | | |_\__ \ \u200B
+\u200B /_/   \_\_| |_|\__|___/ \u200B                 
+"""
+protoC = f"""
+\u200B  ____            _         ____  \u200B
+\u200B |  _ \ _ __ ___ | |_ ___  / ___| \u200B
+\u200B | |_) | '__/ _ \| __/ _ \| |     \u200B
+\u200B |  __/| | | (_) | || (_) | |___  \u200B
+\u200B |_|   |_|  \___/ \__\___/ \____| \u200B                               
+"""
+performance_mode = """
+\u200B  ____            __                                             __  __           _       \u200B
+\u200B |  _ \ ___ _ __ / _| ___  _ __ _ __ ___   __ _ _ __   ___ ___  |  \/  | ___   __| | ___  \u200B
+\u200B | |_) / _ \ '__| |_ / _ \| '__| '_ ` _ \ / _` | '_ \ / __/ _ \ | |\/| |/ _ \ / _` |/ _ \ \u200B
+\u200B |  __/  __/ |  |  _| (_) | |  | | | | | | (_| | | | | (_|  __/ | |  | | (_) | (_| |  __/ \u200B
+\u200B |_|   \___|_|  |_|  \___/|_|  |_| |_| |_|\__,_|_| |_|\___\___| |_|  |_|\___/ \__,_|\___| \u200B                                                                                      
+"""
+tools = f"""
+\u200B  _____           _      \u200B 
+\u200B |_   _|__   ___ | |___  \u200B 
+\u200B   | |/ _ \ / _ \| / __| \u200B 
+\u200B   | | (_) | (_) | \__ \ \u200B 
+\u200B   |_|\___/ \___/|_|___/ \u200B                   
+"""
+
+__all__ = [
+    "goLang",
+    "protoC_Mode",
+    "goFast",
+    "gRpc_ProtoBuf",
+    "swaggerUI",
+    "server",
+    "divider_mono",
+    "divider_xs",
+    "divider_s",
+    "divider_m",
+    "divider_l",
+    "divider_xl",
+    "by_google",
+    "by",
+    "wjb_dev",
+    "emoji",
+    "gRPCurl",
+    "zeroLog",
+    "gRPC",
+    "autoMaxProcs",
+    "ants",
+    "protoC",
+    "performance_mode",
+    "tools",
+]

haraka/art/ascii/frame/__init__.py

@@ -0,0 +1,5 @@
+from .width_utils import WidthUtil
+from .border import BorderBuilder
+from .framer import TextFramer
+
+__all__ = ["WidthUtil", "BorderBuilder", "TextFramer"]

haraka/art/ascii/frame/border.py

@@ -0,0 +1,44 @@
+"""
+Everything about the **horizontal** border (top / bottom).
+"""
+import shutil
+
+
+class BorderBuilder:
+    """
+    Builds a single horizontal line – optionally centred – that is
+    `pattern`-wide and `fraction` of the terminal width.
+    """
+
+    def __init__(self, pattern: str = "=", fraction: float = 0.80, center: bool = True):
+        self.pattern = pattern
+        self.fraction = fraction
+        self.center = center
+
+    # ------- public API ------------------------------------------------ #
+
+    def build(self) -> str:
+        """Return the fully formed border line."""
+        horiz = self._repeat_pattern(self.width)
+
+        if not self.center:
+            return horiz
+
+        margin = (self.term_width - self.width) // 2
+        return " " * margin + horiz if margin > 0 else horiz
+
+    # ------- internals -------------------------------------------------- #
+
+    @property
+    def term_width(self) -> int:
+        return max(1, shutil.get_terminal_size(fallback=(80, 24)).columns)
+
+    @property
+    def width(self) -> int:
+        return max(1, int(self.term_width * self.fraction))
+
+    def _repeat_pattern(self, target: int) -> str:
+        if not self.pattern:
+            return " " * target
+        reps = (target // len(self.pattern)) + 1
+        return (self.pattern * reps)[:target]

haraka/art/ascii/frame/framer.py

@@ -0,0 +1,125 @@
+"""
+High-level «drop-in» that turns a list[str] into a fully framed banner.
+"""
+from __future__ import annotations
+
+import shutil
+import textwrap
+from typing import List
+
+from .border import BorderBuilder
+
+
+class TextFramer:
+    """
+    Build a rectangular frame:
+
+      • configurable borders (x / y chars)
+      • configurable padding and alignment
+      • automatically wraps lines to fit inside
+
+    Example
+    -------
+    >>> framer = TextFramer(border_char_x="=", border_char_y="|")
+    >>> print(framer.frame(["Hello", "world"]))
+    """
+
+    def __init__(
+        self,
+        *,
+        border_char_x: str = "=",
+        border_char_y: str = "|",
+        padding: int = 1,
+        align: str = "center",
+        border_fraction: float = 0.80,
+        center_border: bool = True,
+        flex: bool = False,
+        art: str = ""
+    ):
+        self.border_x = border_char_x
+        self.border_y = border_char_y
+        self.padding = max(0, padding)
+        self.align = align.lower()
+        self.border_fraction = border_fraction
+        self.center_border = center_border
+        self.flex = flex
+
+    # ---- public façade ----------------------------------------------- #
+
+    def frame(self, texts: List[str]) -> str:
+        """
+        Return one string with \n-separated lines ready for printing.
+        """
+        lines = self._normalise(texts)
+        if not lines:
+            return ""
+
+        # 1️⃣  build top/bottom borders once
+        bb = BorderBuilder(self.border_x, self.border_fraction, self.center_border)
+        top_border = bb.build()
+        bottom_border = top_border      # symmetrical
+        target_width = bb.width
+        if self.flex:
+            margin = (self.term_width - target_width) // 2 if self.center_border else 0
+        else :
+            margin = (110 - target_width) // 2 if self.center_border else 0
+
+        # 2️⃣  compute interior geometry
+        side = self.border_y or ""
+        side_w = len(side)
+        interior_w = max(1, target_width - 2 * side_w - 2 * self.padding)
+
+        # 3️⃣  iterate through wrapped chunks
+        frame: list[str] = [top_border]
+        for logical in lines:
+            chunks = textwrap.wrap(logical, width=interior_w) or [""]
+            for chunk in chunks:
+                frame.append(self._compose_line(chunk, interior_w, side, side_w, margin, target_width))
+
+        frame.append(bottom_border)
+        return "\n".join(frame)
+
+    # ---- helpers ------------------------------------------------------ #
+
+    @property
+    def term_width(self) -> int:
+        return max(1, shutil.get_terminal_size(fallback=(80, 24)).columns)
+
+    @staticmethod
+    def _normalise(texts: List[str]):
+        text = " ".join(texts)
+        return textwrap.dedent(text).strip("\n").splitlines()
+
+    # Build one interior line ------------------------------------------ #
+    def _compose_line(
+        self,
+        chunk: str,
+        interior_w: int,
+        side: str,
+        side_w: int,
+        margin: int,
+        target_w: int,
+    ) -> str:
+        extra = interior_w - len(chunk)
+        if self.align == "left":
+            left_x, right_x = 0, extra
+        elif self.align == "right":
+            left_x, right_x = extra, 0
+        else:                   # centre
+            left_x, right_x = divmod(extra, 2)
+
+        left_pad  = " " * (self.padding + left_x)
+        right_pad = " " * (self.padding + right_x)
+        body = f"{side}{left_pad}{chunk}{right_pad}{side}"
+
+        # pad / trim to exact width
+        if len(body) < target_w:
+            body = body[:-side_w] + " " * (target_w - len(body)) + body[-side_w:]
+        elif len(body) > target_w:
+            interior_allowed = target_w - 2 * side_w
+            body = f"{side}{body[side_w : side_w + interior_allowed]}{side}"
+
+        return " " * margin + body if margin else body
+
+    def generate(self, texts: List[str]):
+        return print(self.frame(texts))

haraka/art/ascii/frame/width_utils.py

@@ -0,0 +1,30 @@
+"""
+Helpers that deal with Unicode column widths and simple emoji detection.
+"""
+import logging
+from wcwidth import wcwidth as _wcwidth
+
+logger = logging.getLogger(__name__)
+
+
+class WidthUtil:
+    """Static helpers – no state required."""
+
+    @staticmethod
+    def wcwidth_narrow(ch: str) -> int:
+        """
+        Return wcwidth’s value for *ch* (0, 1, or 2).
+        Keeping the wrapper separate makes unit-testing easier.
+        """
+        return _wcwidth(ch)
+
+    @classmethod
+    def is_emoji_line(cls, text: str) -> bool:
+        """
+        True if any code-point in *text* takes two columns (typical for emoji).
+        """
+        for ch in text:
+            if cls.wcwidth_narrow(ch) > 1:
+                logger.info("%r → is emoji", text)
+                return True
+        return False

haraka/art/create.py

@@ -0,0 +1,17 @@
+from haraka.art import TextFramer
+
+class Create:
+    @staticmethod
+    def emoji(art: list[str], align: str = "left") -> None:
+        frame = TextFramer(border_char_x="", border_char_y="", padding=0, align=align)
+        frame.generate(art)
+
+    @staticmethod
+    def ascii(art: list[str], align: str = "left") -> None:
+        frame = TextFramer(border_char_x="=", border_char_y="||", padding=2, align=align)
+        frame.generate(art)
+
+    @staticmethod
+    def logo(art: list[str], align: str = "left") -> None:
+        frame = TextFramer(border_char_x="", border_char_y="", padding=2, align=align)
+        frame.generate(art)

haraka/post_gen/config/__init__.py

@@ -0,0 +1,3 @@
+from .config import PostGenConfig
+
+__all__ = ["PostGenConfig"]

haraka/post_gen/config/config.py

@@ -0,0 +1,11 @@
+from dataclasses import dataclass
+from pathlib import Path
+
+@dataclass(frozen=True, slots=True)
+class PostGenConfig:
+    language: str
+    project_slug: str
+    author: str
+    description: str
+    project_dir: Path
+    swagger: bool

haraka/post_gen/runner.py

@@ -0,0 +1,54 @@
+from post_gen.gen_ascii.ascii_art import goLang
+
+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
+
+
+def main(cfg: PostGenConfig) -> None:
+
+    _logger = Logger(cfg.language)
+    logger = _logger.start_logger()
+
+    try:
+        cmd = CommandRunner(logger)
+        fops = FileOps(logger)
+        purge = ResourcePurger(fops, logger)
+        git = GitOps(cmd, logger)
+    except Exception as e:
+        logger.error(f"Failed to initialize components: {e}")
+        raise
+
+    divider("1️⃣  / 4️⃣  – Purge template junk")
+    purge.purge(cfg.language, cfg.project_dir)
+
+    divider("2️⃣  / 4️⃣  – Initialise Git repo")
+    git.init_repo(cfg.project_dir)
+
+    divider("3️⃣  / 4️⃣  – Commit scaffold")
+    git.stage_commit(cfg.project_dir)
+
+    divider("4️⃣  / 4️⃣  – Create GitHub repo & push")
+    git.push_to_github(cfg.project_dir, cfg.author, cfg.project_slug, cfg.description)
+
+    divider("🎉 Project generation complete 🎉")
+
+    if cfg.language == "go" and not cfg.swagger:
+        go_emoji_logo = [emoji.go]
+        go_performance_mode = [
+            goLang, divider_xl, performance_mode, divider_l, tools, divider_s,
+            gRPC, divider_mono, protoC, divider_mono, autoMaxProcs, divider_mono,
+            ants, divider_mono, zeroLog,
+        ]
+        go_fast = [
+            goFast, gRpc_ProtoBuf, server,
+            by, wjb_dev
+        ]
+        Create.emoji(go_emoji_logo)
+        Create.ascii(go_performance_mode)
+        Create.logo(go_fast)

haraka/post_gen/utils/assets.py

@@ -0,0 +1,204 @@
+# assets.py  ← drop this next to utils/, purge.py, etc.
+from haraka.art.ascii.assets import *
+
+LANGUAGE_ASSETS = [
+    {
+        "language": "go",
+        "files": [
+            "Dockerfile",
+            "Makefile",
+            "Makefile.cpp",
+            "README.md",
+            "go.mod",
+            "skaffold.yaml",
+            "configs/dev.yaml",
+            "configs/prod.yaml",
+            "internal/config/config.go",
+            "internal/handler/echo.go",
+            "internal/handler/ping.go",
+            "internal/server/health.go",
+            "internal/server/server.go",
+            "pkg/proto/v1/ping.proto",
+            "pkg/proto/v1/service.proto",
+            # "cmd/{{ cookiecutter.project_slug }}/main.go",
+            "test/integration/echo_integration_test.go",
+            "test/integration/health_integration_test.go",
+            "test/integration/ping_integration_test.go",
+            "test/integration/testutil.go",
+            "test/unit/config/config_test.go",
+            "test/unit/handler/echo_test.go",
+            "test/unit/handler/ping_test.go",
+            "test/unit/server/health_test.go",
+            "test/unit/server/server_test.go",
+            "test/unit_test.go",
+            "test/package.go",
+            "runConfigurations/go/Golang.run.xml",
+            "chart/Chart.yaml",
+            "chart/templates/deployment.yaml",
+            "chart/templates/service.yaml",
+            "chart/templates/_helpers.tpl",
+            "chart/values.yaml",
+            "infra/terraform/main.tf",
+            "src/cpp/CMakeLists.txt",
+            "src/cpp/main.cc",
+            "tests/cpp/test_stub.cc"
+        ],
+        "dirs": [
+            "cmd/",
+            "configs/",
+            "internal/",
+            "internal/config/",
+            "internal/handler/",
+            "internal/server/",
+            "pkg/",
+            "pkg/proto/",
+            "pkg/proto/v1/",
+            "test/",
+            "test/integration/",
+            "test/unit/",
+            "test/unit/config/",
+            "test/unit/handler/",
+            "test/unit/server/",
+            "runConfigurations/",
+            "runConfigurations/go/",
+            "chart/",
+            "chart/templates/",
+            "infra/",
+            "infra/terraform/",
+            "src/",
+            "src/cpp/",
+            "tests/",
+            "tests/cpp/"
+        ]
+    },
+    {
+        "language": "python",
+        "files": [
+            "Dockerfile",
+            "Makefile",
+            "README.md",
+            "requirements.txt",
+            "pytest.ini",
+            "skaffold.yaml",
+            "src/app/__init__.py",
+            "src/app/main.py",
+            "src/app/core/config.py",
+            "src/app/services/health.py",
+            "src/app/schemas/health.py",
+            "src/app/api/v1/__init__.py",
+            "src/app/api/v1/routers/health.py",
+            "tests/__init__.py",
+            "tests/conftest.py",
+            "tests/integration/test_health_endpoint.py",
+            "tests/unit/api/v1/routers/test_health.py",
+            "tests/unit/schemas/test_health_schema.py"
+        ],
+        "dirs": [
+            "src/",
+            "src/app/",
+            "src/app/core/",
+            "src/app/services/",
+            "src/app/schemas/",
+            "src/app/api/",
+            "src/app/api/v1/",
+            "src/app/api/v1/routers/",
+            "tests/",
+            "tests/integration/",
+            "tests/unit/",
+            "tests/unit/api/",
+            "tests/unit/api/v1/",
+            "tests/unit/api/v1/routers/",
+            "tests/unit/schemas/"
+        ]
+    },
+    {
+        "language": "java",
+        "files": [
+            "Dockerfile",
+            "Makefile",
+            "README.md",
+            "pom.xml",
+            "skaffold.yaml",
+            "src/main/java/com/example/Application.java",
+            "src/main/java/com/example/config/OpenApiConfig.java",
+            "src/main/java/com/example/controller/HealthController.java",
+            "src/main/java/com/example/dto/HealthResponse.java",
+            "src/main/java/com/example/exception/GlobalExceptionHandler.java",
+            "src/main/java/com/example/service/HealthService.java",
+            "src/main/resources/application.yml",
+            "src/test/java/com/example/controller/HealthControllerTest.java",
+            "src/test/java/com/example/service/HealthServiceTest.java"
+        ],
+        "dirs": [
+            "src/",
+            "src/main/",
+            "src/main/java/",
+            "src/main/java/com/",
+            "src/main/java/com/example/",
+            "src/main/java/com/example/config/",
+            "src/main/java/com/example/controller/",
+            "src/main/java/com/example/dto/",
+            "src/main/java/com/example/exception/",
+            "src/main/java/com/example/service/",
+            "src/main/resources/",
+            "src/test/",
+            "src/test/java/",
+            "src/test/java/com/",
+            "src/test/java/com/example/",
+            "src/test/java/com/example/controller/",
+            "src/test/java/com/example/service/"
+        ]
+    }
+]
+
+# ------------------------------------------------------------------ #
+#  GLOBAL ASSETS  (kept for every language)                           #
+# ------------------------------------------------------------------ #
+GLOBAL_ASSETS = {
+    "files": [
+        "Dockerfile",
+        "Makefile",
+        "README.md",
+        "skaffold.yaml",
+        "chart/Chart.yaml",
+        "chart/values.yaml",
+        "chart/templates/_helpers.tpl",
+        "chart/templates/deployment.yaml",
+        "chart/templates/service.yaml",
+        "infra/terraform/main.tf",
+    ],
+    "dirs": [
+        "chart/",
+        "chart/templates/",
+        "infra/",
+        "infra/terraform/",
+    ],
+}
+
+go_emoji_logo = [
+    emoji["go"]
+]
+go_performance_mode = [
+    goLang,
+    divider_xl,
+    performance_mode,
+    divider_l,
+    tools,
+    divider_s,
+    gRPC,
+    divider_mono,
+    protoC,
+    divider_mono,
+    autoMaxProcs,
+    divider_mono,
+    ants,
+    divider_mono,
+    zeroLog,
+]
+go_fast = [
+    goFast,
+    gRpc_ProtoBuf,
+    server,
+    by,
+    wjb_dev
+]

haraka/post_gen/utils/command.py

@@ -0,0 +1,49 @@
+import subprocess, sys
+from pathlib import Path
+from typing import List, Optional
+from haraka.utils import Logger
+
+class CommandRunner:
+    
+    """Thin wrapper around subprocess.run with logging & graceful error-handling."""
+
+    def __init__(self, logger: Logger) -> None:
+        self._log = logger
+
+    def run(
+        self,
+        cmd: List[str],
+        *,
+        cwd: Optional[Path] = None,
+        check: bool = True,
+    ) -> Optional[subprocess.CompletedProcess]:
+        cmd_str = " ".join(cmd)
+        self._log.info(f"Running: {cmd_str}")
+        try:
+            result = subprocess.run(
+                cmd,
+                cwd=str(cwd) if cwd else None,
+                check=check,
+                stdout=subprocess.PIPE,
+                stderr=subprocess.PIPE,
+                text=True,
+            )
+            if result.stdout:
+                self._log.info(f"stdout:\n{result.stdout.strip()}")
+            if result.stderr:
+                self._log.warn(f"stderr:\n{result.stderr.strip()}", file=sys.stderr)
+            return result
+        except subprocess.CalledProcessError as e:
+            self._log.error(f"command failed: ({cmd_str})", file=sys.stderr)
+            if e.stdout:
+                self._log.error(f"stdout:\n{e.stdout.strip()}", file=sys.stderr)
+            if e.stderr:
+                self._log.error(f"stderr:\n{e.stderr.strip()}", file=sys.stderr)
+            if check:
+                sys.exit(e.returncode)
+            return None
+        except FileNotFoundError:
+            self._log.error(f"command not found: {cmd[0]}", file=sys.stderr)
+            if check:
+                sys.exit(1)
+            return None

haraka/post_gen/utils/files.py

@@ -0,0 +1,46 @@
+import shutil
+from pathlib import Path
+from haraka.utils import Logger
+
+class FileOps:
+    """Filesystem helpers: remove files/dirs, print tree, nice dividers."""
+    def __init__(self, logger: Logger = Logger("⚙️️️️️️️️️️️️Testing⚙️"), test_mode=False) -> None:
+        self.logger = logger
+        self.test_mode = test_mode
+
+    def _relpath(self, path: Path) -> str:
+        try:
+            return str(path.relative_to(Path.cwd()))
+        except ValueError:
+            return str(path) if self.test_mode else f"<non-project-path>: {path}"
+
+    def remove_file(self, path: Path) -> None:
+        try:
+            if path.is_file():
+                path.unlink()
+                self.logger.info(f"Removed file: {self._relpath(path)}")
+            elif path.is_dir():
+                shutil.rmtree(path, ignore_errors=True)
+                self.logger.info(f"Removed directory (expected file): {self._relpath(path)}")
+        except Exception as e:
+            self.logger.warn(f"Could not remove {self._relpath(path)}: {e}")
+
+    def remove_dir(self, path: Path) -> None:
+        if path.exists():
+            try:
+                shutil.rmtree(path, ignore_errors=True)
+                self.logger.info(f"Removed directory: {self._relpath(path)}")
+            except Exception as e:
+                self.logger.warn(f"Could not remove directory {self._relpath(path)}: {e}")
+
+    def print_tree(self, path: Path, prefix: str = "") -> None:
+        if not path.exists():
+            self.logger.warn(f"Path does not exist: {path}")
+            return
+        entries = sorted(path.iterdir(), key=lambda p: (p.is_file(), p.name.lower()))
+        for i, entry in enumerate(entries):
+            branch = "└── " if i == len(entries) - 1 else "├── "
+            print(prefix + branch + entry.name)
+            if entry.is_dir():
+                ext = "    " if i == len(entries) - 1 else "│   "
+                self.print_tree(entry, prefix + ext)

haraka/post_gen/utils/gitops.py

@@ -0,0 +1,60 @@
+import shutil
+import sys
+from pathlib import Path
+from .command import CommandRunner
+import subprocess
+from haraka.utils import Logger
+
+class GitOps:
+    """Git-related operations: init, commit, create remote, push."""
+
+    def __init__(self, runner: CommandRunner, logger: Logger) -> None:
+        self._r = runner
+        self._log = logger
+
+    # ------------- public API ----------------------------------------- #
+    def init_repo(self, project_dir: Path) -> None:
+        if not (project_dir / ".git").exists():
+            self._log.info("Initializing Git repository…")
+            self._r.run(["git", "init"], cwd=project_dir)
+            self._r.run(["git", "branch", "-M", "main"], cwd=project_dir)
+        else:
+            self._log.warn(".git already exists; skipping git init.")
+
+    def stage_commit(self, project_dir: Path) -> None:
+        self._log.info("Staging files…")
+        self._r.run(["git", "add", "."], cwd=project_dir)
+        res = self._r.run(["git", "commit", "-m", "Initial commit"],
+                          cwd=project_dir, check=False)
+        if not res or res.returncode:
+            self._log.error("'git commit' failed (maybe nothing to commit); continuing…", file=sys.stderr)
+
+    def push_to_github(self, project_dir: Path, author: str,
+                       slug: str, description: str) -> None:
+        if not self._has_gh():
+            return
+        if "origin" in self._current_remotes(project_dir):
+            self._log.warn("Remote 'origin' already exists; skipping create.")
+            return
+        repo = f"{author}/{slug}"
+        self._log.info(f"Creating GitHub repo {repo} & pushing…")
+        self._r.run([
+            "gh", "repo", "create", repo,
+            "--public", "--description", description,
+            "--source", ".", "--remote", "origin", "--push", "--confirm"
+        ], cwd=project_dir)
+
+    # ------------- internals ------------------------------------------ #
+    @staticmethod
+    def _current_remotes(project_dir: Path):
+        try:
+            res = subprocess.run(["git", "remote"], cwd=project_dir,
+                                 check=True, text=True,
+                                 stdout=subprocess.PIPE)
+            return [r.strip() for r in res.stdout.splitlines()]
+        except subprocess.CalledProcessError:
+            return []
+
+    @staticmethod
+    def _has_gh() -> bool:
+        return shutil.which("gh") is not None

haraka/post_gen/utils/purge.py

@@ -0,0 +1,70 @@
+# 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)

haraka/utils/__init__.py

@@ -0,0 +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 *
+__all__ = ["PostGenConfig", "", "divider", "Logger", "LANGUAGE_ASSETS", "GLOBAL_ASSETS"]

haraka/utils/common/utils.py

@@ -0,0 +1,14 @@
+import os
+
+def _term_width() -> int:
+    try:
+        return os.get_terminal_size().columns
+    except OSError:
+        return 60
+
+# -------- pretty printing ------------------------------------------ #
+def divider(title: str, *, char: str = "=") -> None:
+    width = _term_width()
+    print("\n" + char * width)
+    print(title)
+    print(char * width + "\n")

haraka/utils/logging/log_util.py

@@ -0,0 +1,28 @@
+from __future__ import annotations
+import sys
+from typing import TextIO
+
+
+class Logger:
+    def __init__(self, label: str = ""):
+        self.label = label
+
+    def start_logger(self) -> Logger:
+        label = Logger.get_label(self.label)
+        return Logger(label)
+
+    def info(self, msg: str) -> None:
+        print(f"{self.label} INFO: {msg}")
+
+    def warn(self, msg: str, file: TextIO = sys.stderr) -> None:
+        print(f"{self.label} WARNING: {msg}", file=file)
+
+    def error(self, msg: str, file: TextIO = sys.stderr) -> None:
+        print(f"{self.label} ERROR: {msg}", file=file)
+
+    @staticmethod
+    def get_label(language: str) -> str:
+        if language == "go":
+            return f"[🔥Go Fast: post_gen]"
+        return f"[🔥post_gen ({language})]"
+

haraka-0.2.5.dist-info/METADATA

@@ -0,0 +1,14 @@
+Metadata-Version: 2.4
+Name: haraka
+Version: 0.2.5
+Summary: Reusable post-generation helper for Cookiecutter micro-service templates
+Author-email: Will Burks <will@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/wjb-dev/comet-postgen
+Project-URL: Source, https://github.com/wjb-dev/comet-postgen
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown

haraka-0.2.5.dist-info/RECORD

@@ -0,0 +1,28 @@
+haraka/__init__.py,sha256=oQxsY6uhvvb8bUdYvbP6oWo48gfzJLunsYTVmFFSKBs,176
+haraka/art/__init__.py,sha256=-b1KHQiLkaI2sXaHS05XDaE27tZfXvVLitILjJfSiKs,112
+haraka/art/create.py,sha256=D2VPJtuwI0Ed7CcreHRHhxSN1VzV7PQfC1q-NW8l0DY,631
+haraka/art/ascii/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+haraka/art/ascii/assets.py,sha256=1WUxFQ0xlzaScVe6hXh6gHKggtLhYc3gfHi9CoW9Otc,9159
+haraka/art/ascii/frame/__init__.py,sha256=9Y1qWC-82ZK_kLhRq749hh_3tXb0mMaPkHq70jtElTc,156
+haraka/art/ascii/frame/border.py,sha256=n7qaLxzzBmf8ewatbe5gN97DO4afZM67bBjpU1OqgAM,1318
+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=nKVprtGZzVJBhRwU4vDV6op2d63RQ30BEX6XinuSdIY,1813
+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/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.5.dist-info/METADATA,sha256=hgLAOgD2_WhGfof6xrY1U5k5u0GuIvnZfODD9g6uc_c,578
+haraka-0.2.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+haraka-0.2.5.dist-info/top_level.txt,sha256=1khpwypLKWoklVd_CgFiwAfcctVSXRoRPc3BI9lyIXo,7
+haraka-0.2.5.dist-info/RECORD,,

haraka-0.2.5.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

haraka-0.2.5.dist-info/top_level.txt

@@ -0,0 +1 @@
+haraka