polycoding 0.1.0__py3-none-any.whl

project_manager/module.py

@@ -0,0 +1,66 @@
+"""Project management module implementation for the Polycode plugin system."""
+
+import logging
+from typing import Any
+
+import pluggy
+
+from modules.context import ModuleContext
+
+log = logging.getLogger(__name__)
+
+
+class ProjectManagerModule:
+    """Project management module for flow lifecycle integration.
+
+    This module provides GitHub-specific operations (PR creation, merging,
+    issue management) as a plugin that responds to flow lifecycle hooks.
+    It bridges the gap between generic flow phases and provider-specific
+    project management operations.
+    """
+
+    name = "project_manager"
+    version = "0.1.0"
+    dependencies: list[str] = []
+
+    @classmethod
+    def on_load(cls, context: ModuleContext) -> None:
+        """Initialize project manager module.
+
+        The module doesn't require any special initialization - the
+        project manager factory is created when hooks are registered.
+        """
+        log.info(f"📦 Project manager module loaded (v{cls.version})")
+
+    @classmethod
+    def register_hooks(cls, hook_manager: pluggy.PluginManager) -> None:
+        """Register project management hooks.
+
+        Creates and registers ProjectManagerHooks with a factory function
+        that instantiates the appropriate ProjectManager based on config.
+        """
+        from project_manager import GitHubProjectManager
+        from project_manager.hooks import ProjectManagerHooks
+
+        def project_manager_factory(config):
+            """Factory function to create project manager based on provider."""
+            provider = getattr(config, "provider", "github")
+            if provider == "github":
+                return GitHubProjectManager(config)
+            raise ValueError(f"Unknown project manager provider: {provider}")
+
+        hook_manager.register(ProjectManagerHooks(project_manager_factory))
+        log.info("🏹 Registered ProjectManagerHooks")
+
+    @classmethod
+    def get_models(cls) -> list[type]:
+        """Return ORM models for this module.
+
+        Project manager doesn't define any database models.
+        """
+        return []
+
+    @classmethod
+    def get_tasks(cls) -> list[dict[str, Any]]:
+        """Return Celery task definitions for this module."""
+        return []

project_manager/types.py

@@ -0,0 +1,79 @@
+"""Common types for project management."""
+
+from enum import Enum
+from typing import Any, Optional
+
+from pydantic import BaseModel
+
+
+class IssueStatus(str, Enum):
+    """Standardized issue status values."""
+
+    TODO = "todo"
+    READY = "ready"
+    IN_PROGRESS = "in_progress"
+    REVIEWING = "reviewing"
+    DONE = "done"
+    BLOCKED = "blocked"
+
+
+class Issue(BaseModel):
+    """Generic issue representation."""
+
+    id: int
+    number: int
+    title: str
+    body: str | None = None
+    node_id: str | None = None
+    url: str | None = None
+    labels: list[str] = []
+
+
+class ProjectItem(BaseModel):
+    """Generic project item representation."""
+
+    id: str
+    issue_number: int
+    title: str
+    body: str | None = None
+    status: str | None = None
+    issue_id: int | None = None
+
+
+class StatusMapping(BaseModel):
+    """Maps standardized statuses to provider-specific values."""
+
+    todo: str = "Todo"
+    ready: str = "Ready"
+    in_progress: str = "In progress"
+    reviewing: str = "In review"
+    done: str = "Done"
+    blocked: str = "Blocked"
+
+    def to_provider_status(self, status: IssueStatus) -> str:
+        """Convert standardized status to provider-specific value."""
+        return getattr(self, status.value)
+
+    @classmethod
+    def from_dict(cls, data: dict[str, str]) -> "StatusMapping":
+        """Create mapping from dictionary."""
+        return cls(
+            todo=data.get("todo", "Todo"),
+            ready=data.get("ready", "Ready"),
+            in_progress=data.get("in_progress", "In progress"),
+            reviewing=data.get("reviewing", "In review"),
+            done=data.get("done", "Done"),
+            blocked=data.get("blocked", "Blocked"),
+        )
+
+
+class ProjectConfig(BaseModel):
+    """Configuration for a project manager."""
+
+    provider: str
+    repo_owner: str
+    repo_name: str
+    project_identifier: Optional[str] = None
+    status_mapping: StatusMapping = StatusMapping()
+    token: str | None = None
+    extra: dict[str, Any] = {}