@pennyfarthing/core 10.0.2 → 10.0.5

package/pennyfarthing_scripts/hotspots/formatters.py

@@ -0,0 +1,109 @@
+"""
+Output formatters for hotspot analysis results.
+
+Supports table, JSON, and CSV output — no external dependencies.
+Uses common/output.py for colored terminal output.
+"""
+
+from __future__ import annotations
+
+import csv
+import io
+import json
+import sys
+from dataclasses import asdict
+from typing import TextIO
+
+from pennyfarthing_scripts.common.output import header, info
+from pennyfarthing_scripts.hotspots.models import (
+    DirectoryHotspot,
+    FileHotspot,
+    HotspotResult,
+    MultiRepoHotspotResult,
+)
+
+
+def format_file_table(hotspots: list[FileHotspot], top_n: int = 20) -> str:
+    """Format file hotspots as a column-aligned table."""
+    if not hotspots:
+        return "  No file hotspots found."
+
+    items = hotspots[:top_n]
+
+    # Column headers and widths
+    hdr = f"{'Score':>6}  {'Changes':>8}  {'Fixes':>6}  {'Authors':>8}  {'Churn':>8}  File"
+    sep = f"{'------':>6}  {'--------':>8}  {'------':>6}  {'--------':>8}  {'--------':>8}  ----"
+
+    lines = [hdr, sep]
+    for h in items:
+        lines.append(
+            f"{h.hotspot_score:>6.1f}  {h.change_count:>8}  {h.bug_fix_count:>6}  "
+            f"{h.author_count:>8}  {h.churn:>8}  {h.path}"
+        )
+
+    return "\n".join(lines)
+
+
+def format_dir_table(hotspots: list[DirectoryHotspot], top_n: int = 20) -> str:
+    """Format directory hotspots as a column-aligned table."""
+    if not hotspots:
+        return "  No directory hotspots found."
+
+    items = hotspots[:top_n]
+
+    hdr = f"{'Score':>6}  {'Files':>6}  {'Changes':>8}  {'Fixes':>6}  {'Avg Auth':>9}  Directory"
+    sep = f"{'------':>6}  {'------':>6}  {'--------':>8}  {'------':>6}  {'---------':>9}  ---------"
+
+    lines = [hdr, sep]
+    for d in items:
+        lines.append(
+            f"{d.hotspot_score:>6.1f}  {d.file_count:>6}  {d.total_changes:>8}  "
+            f"{d.total_bug_fixes:>6}  {d.avg_author_count:>9.1f}  {d.path}"
+        )
+
+    return "\n".join(lines)
+
+
+def format_summary(result: HotspotResult, file: TextIO = sys.stderr) -> None:
+    """Print a summary header for a single repo result."""
+    header(f"  Hotspots: {result.repo_name}", char="=", width=60, file=file)
+    info(f"Path: {result.repo_path}", file=file)
+    info(f"Time window: {result.time_window_days} days", file=file)
+    info(f"Commits analyzed: {result.commit_count}", file=file)
+    info(f"File hotspots: {len(result.file_hotspots)}", file=file)
+    info(f"Directory hotspots: {len(result.directory_hotspots)}", file=file)
+
+
+def export_json(result: HotspotResult | MultiRepoHotspotResult) -> str:
+    """Serialize result to JSON string."""
+    return json.dumps(asdict(result), indent=2, default=str)
+
+
+def export_csv(hotspots: list[FileHotspot]) -> str:
+    """Export file hotspots as CSV."""
+    buf = io.StringIO()
+    writer = csv.writer(buf)
+    writer.writerow([
+        "path",
+        "change_count",
+        "bug_fix_count",
+        "author_count",
+        "lines_added",
+        "lines_deleted",
+        "churn",
+        "last_changed",
+        "hotspot_score",
+    ])
+    for h in hotspots:
+        writer.writerow([
+            h.path,
+            h.change_count,
+            h.bug_fix_count,
+            h.author_count,
+            h.lines_added,
+            h.lines_deleted,
+            h.churn,
+            h.last_changed,
+            h.hotspot_score,
+        ])
+    return buf.getvalue()

package/pennyfarthing_scripts/hotspots/models.py

@@ -0,0 +1,60 @@
+"""
+Data models for hotspot analysis results.
+
+Follows ADR-0008 result pattern — structured dataclasses with success/error fields.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from datetime import datetime
+
+
+@dataclass
+class FileHotspot:
+    """Hotspot data for a single file."""
+
+    path: str
+    change_count: int = 0
+    bug_fix_count: int = 0
+    author_count: int = 0
+    lines_added: int = 0
+    lines_deleted: int = 0
+    churn: int = 0  # lines_added + lines_deleted
+    last_changed: str = ""  # ISO date string
+    hotspot_score: float = 0.0  # 0–100 composite score
+
+
+@dataclass
+class DirectoryHotspot:
+    """Hotspot data aggregated to directory level."""
+
+    path: str
+    file_count: int = 0
+    total_changes: int = 0
+    total_bug_fixes: int = 0
+    avg_author_count: float = 0.0
+    hotspot_score: float = 0.0
+
+
+@dataclass
+class HotspotResult:
+    """Analysis result for a single repository."""
+
+    success: bool
+    repo_name: str
+    repo_path: str
+    time_window_days: int
+    commit_count: int = 0
+    file_hotspots: list[FileHotspot] = field(default_factory=list)
+    directory_hotspots: list[DirectoryHotspot] = field(default_factory=list)
+    error: str | None = None
+
+
+@dataclass
+class MultiRepoHotspotResult:
+    """Analysis result spanning multiple repositories."""
+
+    success: bool
+    repo_results: list[HotspotResult] = field(default_factory=list)
+    error: str | None = None

package/pennyfarthing_scripts/jira/__init__.py

@@ -0,0 +1,99 @@
+"""
+Jira integration package for Pennyfarthing scripts.
+
+This package provides:
+- client: JiraClient REST API wrapper and helper functions
+- sync: Epic sync to Jira
+- bidirectional: Bidirectional sync between YAML and Jira
+- epic: Epic creation
+- story: Single story sync
+- claim: Story claiming
+
+Usage:
+    # Use the client module
+    from pennyfarthing_scripts.jira import JiraClient
+    client = JiraClient()
+    issue = client.get_issue_sync("MSSCI-12345")
+
+    # Use CLI
+    python -m pennyfarthing_scripts.jira <subcommand> [args]
+"""
+
+# Re-export from client for backwards compatibility
+from pennyfarthing_scripts.jira.client import (
+    # Constants
+    GITHUB_TO_JIRA_MAP,
+    JIRA_PROJECT,
+    JIRA_TO_STATUS,
+    JIRA_URL,
+    STATUS_TO_JIRA,
+    # Classes
+    JiraClient,
+    # Functions
+    add_comment,
+    check_dependencies,
+    extract_jira_key,
+    get_client,
+    get_issue,
+    get_jira_field,
+    get_story_points,
+    is_jira_cli_available,
+    map_github_to_jira,
+    map_jira_to_status,
+    map_status_to_jira,
+    update_issue_status,
+)
+
+# Import submodules to make them accessible
+from pennyfarthing_scripts.jira import (
+    bidirectional,
+    claim,
+    client,
+    create,
+    epic,
+    operations,
+    reconcile,
+    story,
+    sync,
+)
+
+# CLI entry point - import module, not function, so "from jira import cli" gets the module
+from pennyfarthing_scripts.jira import cli
+from pennyfarthing_scripts.jira.cli import main
+
+__all__ = [
+    # Constants
+    "GITHUB_TO_JIRA_MAP",
+    "JIRA_PROJECT",
+    "JIRA_TO_STATUS",
+    "JIRA_URL",
+    "STATUS_TO_JIRA",
+    # Classes
+    "JiraClient",
+    # Functions
+    "add_comment",
+    "check_dependencies",
+    "extract_jira_key",
+    "get_client",
+    "get_issue",
+    "get_jira_field",
+    "get_story_points",
+    "is_jira_cli_available",
+    "map_github_to_jira",
+    "map_jira_to_status",
+    "map_status_to_jira",
+    "update_issue_status",
+    # Submodules
+    "bidirectional",
+    "claim",
+    "client",
+    "create",
+    "epic",
+    "operations",
+    "reconcile",
+    "story",
+    "sync",
+    # CLI
+    "cli",
+    "main",
+]

package/pennyfarthing_scripts/jira/__main__.py

@@ -0,0 +1,10 @@
+"""
+Entry point for python -m pennyfarthing_scripts.jira
+"""
+
+import sys
+
+from pennyfarthing_scripts.jira.cli import cli
+
+if __name__ == "__main__":
+    sys.exit(cli())