roadmap-cli 0.1.1__py3-none-any.whl

roadmap/common/formatters/kanban/layout.py

@@ -0,0 +1,48 @@
+"""Kanban board layout and rendering."""
+
+from structlog import get_logger
+
+from roadmap.core.domain import Issue
+
+logger = get_logger()
+
+
+class KanbanLayout:
+    """Handles kanban board layout calculations and rendering."""
+
+    @staticmethod
+    def calculate_column_width(num_columns: int) -> int:
+        """Calculate column width based on terminal size."""
+        try:
+            import shutil
+
+            terminal_width = shutil.get_terminal_size().columns
+            return max(30, (terminal_width - 5) // num_columns)
+        except Exception as e:
+            logger.debug("terminal_size_calculation_failed", error=str(e))
+            return 35
+
+    @staticmethod
+    def format_issue_cell(issue: Issue, col_width: int, compact: bool) -> str:
+        """Format a single issue for display in a kanban cell."""
+        if not issue:
+            return " " * col_width
+
+        # Truncate title if needed
+        max_title_len = col_width - 4
+        display_title = (
+            issue.title[:max_title_len]
+            if len(issue.title) > max_title_len
+            else issue.title
+        )
+
+        if compact:
+            return f"• {display_title:<{col_width - 2}}"
+        else:
+            priority_emoji = {
+                "critical": "🔴",
+                "high": "🟠",
+                "medium": "🟡",
+                "low": "⚪",
+            }.get(issue.priority.value, "⚪")
+            return f"{priority_emoji} {display_title:<{col_width - 3}}"

roadmap/common/formatters/kanban/organizer.py

@@ -0,0 +1,81 @@
+"""Kanban board organization."""
+
+from datetime import UTC, datetime
+
+from roadmap.core.domain import Issue
+
+
+class KanbanOrganizer:
+    """Organizes issues into kanban columns."""
+
+    @staticmethod
+    def categorize_issues(milestone_issues: list[Issue]) -> dict:
+        """Categorize issues into kanban columns.
+
+        Returns:
+            Dictionary with keys: overdue, blocked, in_progress, not_started, done
+        """
+        now = datetime.now(UTC)
+
+        categories = {
+            "overdue": [],
+            "blocked": [],
+            "in_progress": [],
+            "not_started": [],
+            "closed": [],
+        }
+
+        for issue in milestone_issues:
+            if issue.status.value == "closed":
+                categories["closed"].append(issue)
+            elif issue.status.value == "blocked":
+                categories["blocked"].append(issue)
+            elif issue.status.value == "in-progress":
+                categories["in_progress"].append(issue)
+            elif (
+                issue.due_date
+                and issue.due_date < now
+                and issue.status.value != "closed"
+            ):
+                categories["overdue"].append(issue)
+            else:
+                categories["not_started"].append(issue)
+
+        return categories
+
+    @staticmethod
+    def create_column_definitions(
+        categories: dict, no_color: bool
+    ) -> list[tuple[str, list[Issue], str]]:
+        """Create column definitions for display.
+
+        Returns:
+            List of tuples: (column_title, issues, style)
+        """
+        return [
+            (
+                "🚨 Overdue",
+                categories["overdue"],
+                "bold red" if not no_color else "white",
+            ),
+            (
+                "🚫 Blocked",
+                categories["blocked"],
+                "bold yellow" if not no_color else "white",
+            ),
+            (
+                "🔄 In Progress",
+                categories["in_progress"],
+                "bold blue" if not no_color else "white",
+            ),
+            (
+                "⏸️  Not Started",
+                categories["not_started"],
+                "dim white" if not no_color else "white",
+            ),
+            (
+                "✅ Closed",
+                categories["closed"],
+                "bold green" if not no_color else "white",
+            ),
+        ]

roadmap/common/formatters/output/__init__.py

@@ -0,0 +1,15 @@
+"""Output formatter module public API."""
+
+from roadmap.common.output_formatter import (
+    CSVOutputFormatter,
+    JSONOutputFormatter,
+    OutputFormatter,
+    PlainTextOutputFormatter,
+)
+
+__all__ = [
+    "OutputFormatter",
+    "PlainTextOutputFormatter",
+    "JSONOutputFormatter",
+    "CSVOutputFormatter",
+]

roadmap/common/formatters/tables/__init__.py

@@ -0,0 +1,11 @@
+"""Tables module public API."""
+
+from .issue_table import IssueTableFormatter
+from .milestone_table import MilestoneTableFormatter
+from .project_table import ProjectTableFormatter
+
+__all__ = [
+    "IssueTableFormatter",
+    "MilestoneTableFormatter",
+    "ProjectTableFormatter",
+]

roadmap/common/formatters/tables/column_factory.py

@@ -0,0 +1,312 @@
+"""Factory functions for creating table column definitions (ColumnDef objects).
+
+This module centralizes column definitions to eliminate duplication
+across issue_table.py, milestone_table.py, and project_table.py.
+"""
+
+from roadmap.common.models import ColumnDef, ColumnType
+from roadmap.core.domain import Priority, ProjectStatus, Status
+
+
+def create_id_column(name: str = "id", width: int = 8) -> ColumnDef:
+    """Create an ID column definition.
+
+    Args:
+        name: Column data name (default: "id")
+        width: Column width (default: 8)
+
+    Returns:
+        ColumnDef object for ID column
+    """
+    return ColumnDef(
+        name=name,
+        display_name="ID",
+        type=ColumnType.STRING,
+        width=width,
+        display_style="cyan",
+        sortable=True,
+        filterable=True,
+    )
+
+
+def create_title_column(name: str = "title", width: int = 25) -> ColumnDef:
+    """Create a Title column definition.
+
+    Args:
+        name: Column data name (default: "title")
+        width: Column width (default: 25)
+
+    Returns:
+        ColumnDef object for Title column
+    """
+    return ColumnDef(
+        name=name,
+        display_name="Title" if name == "title" else "Name",
+        type=ColumnType.STRING,
+        width=width,
+        display_style="white",
+        sortable=True,
+        filterable=True,
+    )
+
+
+def create_priority_column(width: int = 10) -> ColumnDef:
+    """Create a Priority column definition.
+
+    Args:
+        width: Column width (default: 10)
+
+    Returns:
+        ColumnDef object for Priority column
+    """
+    return ColumnDef(
+        name="priority",
+        display_name="Priority",
+        type=ColumnType.ENUM,
+        width=width,
+        display_style="yellow",
+        enum_values=[p.value for p in Priority],
+        sortable=True,
+        filterable=True,
+    )
+
+
+def create_status_column(
+    enum_values: list[str] | None = None, width: int = 12, style: str = "green"
+) -> ColumnDef:
+    """Create a Status column definition.
+
+    Args:
+        enum_values: List of possible status values (default: Issue Status enum)
+        width: Column width (default: 12)
+        style: Display style (default: "green")
+
+    Returns:
+        ColumnDef object for Status column
+    """
+    if enum_values is None:
+        enum_values = [s.value for s in Status]
+
+    return ColumnDef(
+        name="status",
+        display_name="Status",
+        type=ColumnType.ENUM,
+        width=width,
+        display_style=style,
+        enum_values=enum_values,
+        sortable=True,
+        filterable=True,
+    )
+
+
+def create_progress_column(width: int = 10) -> ColumnDef:
+    """Create a Progress column definition.
+
+    Args:
+        width: Column width (default: 10)
+
+    Returns:
+        ColumnDef object for Progress column
+    """
+    return ColumnDef(
+        name="progress",
+        display_name="Progress",
+        type=ColumnType.STRING,
+        width=width,
+        display_style="blue",
+        sortable=False,
+        filterable=False,
+    )
+
+
+def create_assignee_column(width: int = 12) -> ColumnDef:
+    """Create an Assignee column definition.
+
+    Args:
+        width: Column width (default: 12)
+
+    Returns:
+        ColumnDef object for Assignee column
+    """
+    return ColumnDef(
+        name="assignee",
+        display_name="Assignee",
+        type=ColumnType.STRING,
+        width=width,
+        display_style="magenta",
+        sortable=True,
+        filterable=True,
+    )
+
+
+def create_estimate_column(width: int = 10) -> ColumnDef:
+    """Create an Estimate column definition.
+
+    Args:
+        width: Column width (default: 10)
+
+    Returns:
+        ColumnDef object for Estimate column
+    """
+    return ColumnDef(
+        name="estimate",
+        display_name="Estimate",
+        type=ColumnType.STRING,
+        width=width,
+        display_style="green",
+        sortable=True,
+        filterable=False,
+    )
+
+
+def create_milestone_column(width: int = 15) -> ColumnDef:
+    """Create a Milestone column definition.
+
+    Args:
+        width: Column width (default: 15)
+
+    Returns:
+        ColumnDef object for Milestone column
+    """
+    return ColumnDef(
+        name="milestone",
+        display_name="Milestone",
+        type=ColumnType.STRING,
+        width=width,
+        display_style="blue",
+        sortable=True,
+        filterable=True,
+    )
+
+
+def create_owner_column(width: int = 15) -> ColumnDef:
+    """Create an Owner/Lead column definition.
+
+    Args:
+        width: Column width (default: 15)
+
+    Returns:
+        ColumnDef object for Owner column
+    """
+    return ColumnDef(
+        name="owner",
+        display_name="Owner",
+        type=ColumnType.STRING,
+        width=width,
+        display_style="magenta",
+        sortable=True,
+        filterable=True,
+    )
+
+
+def create_description_column(width: int = 30) -> ColumnDef:
+    """Create a Description column definition.
+
+    Args:
+        width: Column width (default: 30)
+
+    Returns:
+        ColumnDef object for Description column
+    """
+    return ColumnDef(
+        name="description",
+        display_name="Description",
+        type=ColumnType.STRING,
+        width=width,
+        display_style="white",
+        sortable=True,
+        filterable=True,
+    )
+
+
+def create_due_date_column(width: int = 12) -> ColumnDef:
+    """Create a Due Date column definition.
+
+    Args:
+        width: Column width (default: 12)
+
+    Returns:
+        ColumnDef object for Due Date column
+    """
+    return ColumnDef(
+        name="due_date",
+        display_name="Due Date",
+        type=ColumnType.DATE,
+        width=width,
+        display_style="yellow",
+        sortable=True,
+        filterable=True,
+    )
+
+
+def create_comment_count_column(width: int = 9) -> ColumnDef:
+    """Create a Comments column definition.
+
+    Args:
+        width: Column width (default: 9)
+
+    Returns:
+        ColumnDef object for Comments column
+    """
+    return ColumnDef(
+        name="comment_count",
+        display_name="Comments",
+        type=ColumnType.STRING,
+        width=width,
+        display_style="dim",
+        sortable=True,
+        filterable=False,
+    )
+
+
+def create_issue_columns() -> list[ColumnDef]:
+    """Create all columns for an issue table.
+
+    Returns:
+        List of ColumnDef objects for issue display
+    """
+    return [
+        create_id_column(),
+        create_title_column(),
+        create_priority_column(),
+        create_status_column(),
+        create_progress_column(),
+        create_assignee_column(),
+        create_estimate_column(),
+        create_milestone_column(),
+        create_comment_count_column(),
+    ]
+
+
+def create_milestone_columns() -> list[ColumnDef]:
+    """Create all columns for a milestone table.
+
+    Returns:
+        List of ColumnDef objects for milestone display
+    """
+    return [
+        create_title_column(name="name", width=20),
+        create_description_column(width=30),
+        create_status_column(width=10),
+        create_due_date_column(width=12),
+        create_progress_column(width=12),
+        create_estimate_column(width=12),
+    ]
+
+
+def create_project_columns() -> list[ColumnDef]:
+    """Create all columns for a project table.
+
+    Returns:
+        List of ColumnDef objects for project display
+    """
+    return [
+        create_id_column(),
+        create_title_column(),
+        create_status_column(
+            enum_values=[s.value for s in ProjectStatus],
+            style="magenta",
+        ),
+        create_priority_column(),
+        create_owner_column(),
+    ]