megaplan-sdk 0.1.0__py3-none-any.whl

megaplan_sdk/models/project.py

@@ -0,0 +1,76 @@
+"""Project models for Megaplan SDK."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from pydantic import BaseModel, ConfigDict, Field
+
+from megaplan_sdk.models.base import BaseEntity
+from megaplan_sdk.models.common import DateTime, TimestampMixin
+
+
+class ProjectFilter(BaseModel):
+    """Project filter configuration.
+
+    Can be used as filter ID (integer) or filter configuration (dict).
+    """
+
+    id: int | None = None
+    config: dict[str, Any] | None = None
+
+
+class Project(TimestampMixin):
+    """Project model.
+
+    Represents a project in Megaplan with all its properties.
+    """
+
+    id: int
+    content_type: str = Field(alias="contentType", default="Project")
+    name: str | None = None
+    description: str | None = None
+    status: str | None = None
+    owner: BaseEntity | None = None
+    responsible: BaseEntity | None = None
+    deadline: str | DateTime | dict[str, Any] | None = None  # Can be DateOnly, DateTime, or string
+    actual_finish: str | DateTime | None = Field(alias="actualFinish", default=None)
+    parent: BaseEntity | None = None
+    priority: str | None = None
+    tags: list[BaseEntity] | None = None
+    attaches: list[BaseEntity] | None = None
+    todos: list[BaseEntity] | None = None
+
+    model_config = ConfigDict(populate_by_name=True, extra="ignore")
+
+
+class ProjectFullDetails(BaseModel):
+    """Full project details with all related entities.
+
+    Attributes:
+        project: Main project entity.
+        deals: List of associated deals (if requested).
+        issues: List of tasks/issues (if requested).
+        actual_issues: List of actual tasks/issues (if requested).
+        comments: List of comments (if requested).
+        history: Change history entries (if requested).
+        auditors: List of auditors (if requested).
+        executors: List of executors/co-performers (if requested).
+        milestones: List of milestones (if requested).
+        responsible_details: Full responsible employee details (if requested).
+        owner_details: Full owner employee details (if requested).
+    """
+
+    project: Project
+    deals: list[Any] | None = None
+    issues: list[Any] | None = None
+    actual_issues: list[Any] | None = None
+    comments: list[Any] | None = None
+    history: list[dict[str, Any]] | None = None
+    auditors: list[Any] | None = None
+    executors: list[Any] | None = None
+    milestones: list[Any] | None = None
+    responsible_details: Any | None = None
+    owner_details: Any | None = None
+
+    model_config = ConfigDict(populate_by_name=True, extra="ignore")

megaplan_sdk/models/task.py

@@ -0,0 +1,75 @@
+"""Task models for Megaplan SDK."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from pydantic import BaseModel, ConfigDict, Field
+
+from megaplan_sdk.models.base import BaseEntity
+from megaplan_sdk.models.common import DateTime, TimestampMixin
+
+
+class TaskFilter(BaseModel):
+    """Task filter configuration.
+
+    Can be used as filter ID (integer) or filter configuration (dict).
+    """
+
+    id: int | None = None
+    config: dict[str, Any] | None = None
+
+
+class Task(TimestampMixin):
+    """Task model.
+
+    Represents a task in Megaplan with all its properties.
+    """
+
+    id: int
+    content_type: str = Field(alias="contentType", default="Task")
+    name: str | None = None
+    description: str | None = None
+    status: str | None = None
+    responsible: BaseEntity | None = None
+    owner: BaseEntity | None = None
+    deadline: str | DateTime | dict[str, Any] | None = None  # Can be DateOnly, DateTime, or string
+    actual_finish: str | DateTime | None = Field(alias="actualFinish", default=None)
+    parent: BaseEntity | None = None
+    project: BaseEntity | None = None
+    priority: str | None = None
+    tags: list[BaseEntity] | None = None
+    attaches: list[BaseEntity] | None = None
+    todos: list[BaseEntity] | None = None
+
+    model_config = ConfigDict(populate_by_name=True, extra="ignore")
+
+
+class TaskFullDetails(BaseModel):
+    """Full task details with all related entities.
+
+    Attributes:
+        task: Main task entity.
+        sub_tasks: List of subtasks (if requested).
+        actual_sub_tasks: List of actual subtasks (if requested).
+        comments: List of comments (if requested).
+        history: Change history entries (if requested).
+        auditors: List of auditors (if requested).
+        executors: List of executors/co-performers (if requested).
+        milestones: List of milestones (if requested).
+        responsible_details: Full responsible employee details (if requested).
+        owner_details: Full owner employee details (if requested).
+    """
+
+    task: Task
+    sub_tasks: list[Any] | None = None
+    actual_sub_tasks: list[Any] | None = None
+    comments: list[Any] | None = None
+    history: list[dict[str, Any]] | None = None
+    auditors: list[Any] | None = None
+    executors: list[Any] | None = None
+    milestones: list[Any] | None = None
+    responsible_details: Any | None = None
+    owner_details: Any | None = None
+
+    model_config = ConfigDict(populate_by_name=True, extra="ignore")

megaplan_sdk/resources/__init__.py

@@ -0,0 +1,15 @@
+"""Resources for Megaplan SDK."""
+
+from megaplan_sdk.resources.auth import AuthResource
+from megaplan_sdk.resources.base import BaseResource
+from megaplan_sdk.resources.deals import DealsResource
+from megaplan_sdk.resources.projects import ProjectsResource
+from megaplan_sdk.resources.tasks import TasksResource
+
+__all__ = [
+    "BaseResource",
+    "AuthResource",
+    "TasksResource",
+    "ProjectsResource",
+    "DealsResource",
+]

megaplan_sdk/resources/auth.py

@@ -0,0 +1,73 @@
+"""Authentication resource for Megaplan API."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from megaplan_sdk.auth import AuthManager
+from megaplan_sdk.http_client import HTTPClient
+from megaplan_sdk.resources.base import BaseResource
+
+if TYPE_CHECKING:
+    from megaplan_sdk.cache import EntityCache
+
+
+class AuthResource(BaseResource):
+    """Resource for OAuth2 authentication."""
+
+    def __init__(self, http_client: HTTPClient, cache: EntityCache | None = None) -> None:
+        """Initialize auth resource.
+
+        Args:
+            http_client: HTTP client for making requests.
+            cache: Optional entity cache.
+        """
+        super().__init__(http_client, cache=cache)
+        self._auth_manager = AuthManager(http_client)
+
+    async def authenticate(self, username: str, password: str) -> str:
+        """Authenticate with username and password.
+
+        Args:
+            username: User email or username.
+            password: User password.
+
+        Returns:
+            Access token.
+        """
+        return await self._auth_manager.authenticate(username, password)
+
+    async def refresh_token(self, refresh_token: str | None = None) -> str:
+        """Refresh access token.
+
+        Args:
+            refresh_token: Optional refresh token. Uses stored token if not provided.
+
+        Returns:
+            New access token.
+        """
+        return await self._auth_manager.refresh(refresh_token)
+
+    async def ensure_authenticated(self, username: str, password: str) -> str:
+        """Ensure we have a valid access token.
+
+        Args:
+            username: Username for authentication.
+            password: Password for authentication.
+
+        Returns:
+            Valid access token.
+        """
+        return await self._auth_manager.ensure_authenticated(username, password)
+
+    def get_access_token(self) -> str | None:
+        """Get current access token.
+
+        Returns:
+            Access token or None if not authenticated.
+        """
+        return self._auth_manager.get_access_token()
+
+    def clear_tokens(self) -> None:
+        """Clear stored tokens."""
+        self._auth_manager.clear_tokens()