devrev-Python-SDK 1.0.0__py3-none-any.whl

devrev/services/articles.py

@@ -0,0 +1,80 @@
+"""Articles service for DevRev SDK."""
+
+from __future__ import annotations
+
+from collections.abc import Sequence
+
+from devrev.models.articles import (
+    Article,
+    ArticlesCreateRequest,
+    ArticlesCreateResponse,
+    ArticlesDeleteRequest,
+    ArticlesDeleteResponse,
+    ArticlesGetRequest,
+    ArticlesGetResponse,
+    ArticlesListRequest,
+    ArticlesListResponse,
+    ArticlesUpdateRequest,
+    ArticlesUpdateResponse,
+)
+from devrev.services.base import AsyncBaseService, BaseService
+
+
+class ArticlesService(BaseService):
+    """Service for managing DevRev Articles."""
+
+    def create(self, request: ArticlesCreateRequest) -> Article:
+        """Create a new article."""
+        response = self._post("/articles.create", request, ArticlesCreateResponse)
+        return response.article
+
+    def get(self, request: ArticlesGetRequest) -> Article:
+        """Get an article by ID."""
+        response = self._post("/articles.get", request, ArticlesGetResponse)
+        return response.article
+
+    def list(self, request: ArticlesListRequest | None = None) -> Sequence[Article]:
+        """List articles."""
+        if request is None:
+            request = ArticlesListRequest()
+        response = self._post("/articles.list", request, ArticlesListResponse)
+        return response.articles
+
+    def update(self, request: ArticlesUpdateRequest) -> Article:
+        """Update an article."""
+        response = self._post("/articles.update", request, ArticlesUpdateResponse)
+        return response.article
+
+    def delete(self, request: ArticlesDeleteRequest) -> None:
+        """Delete an article."""
+        self._post("/articles.delete", request, ArticlesDeleteResponse)
+
+
+class AsyncArticlesService(AsyncBaseService):
+    """Async service for managing DevRev Articles."""
+
+    async def create(self, request: ArticlesCreateRequest) -> Article:
+        """Create a new article."""
+        response = await self._post("/articles.create", request, ArticlesCreateResponse)
+        return response.article
+
+    async def get(self, request: ArticlesGetRequest) -> Article:
+        """Get an article by ID."""
+        response = await self._post("/articles.get", request, ArticlesGetResponse)
+        return response.article
+
+    async def list(self, request: ArticlesListRequest | None = None) -> Sequence[Article]:
+        """List articles."""
+        if request is None:
+            request = ArticlesListRequest()
+        response = await self._post("/articles.list", request, ArticlesListResponse)
+        return response.articles
+
+    async def update(self, request: ArticlesUpdateRequest) -> Article:
+        """Update an article."""
+        response = await self._post("/articles.update", request, ArticlesUpdateResponse)
+        return response.article
+
+    async def delete(self, request: ArticlesDeleteRequest) -> None:
+        """Delete an article."""
+        await self._post("/articles.delete", request, ArticlesDeleteResponse)

devrev/services/base.py

@@ -0,0 +1,234 @@
+"""Base service class for DevRev SDK.
+
+This module provides the base service class that all API services inherit from.
+"""
+
+from __future__ import annotations
+
+import logging
+from typing import TYPE_CHECKING, Any, TypeVar, overload
+
+from pydantic import BaseModel
+
+if TYPE_CHECKING:
+    from devrev.utils.http import AsyncHTTPClient, HTTPClient
+
+logger = logging.getLogger(__name__)
+
+T = TypeVar("T", bound=BaseModel)
+
+
+class BaseService:
+    """Base class for synchronous DevRev API services.
+
+    Provides common functionality for making API requests
+    and parsing responses into Pydantic models.
+
+    Args:
+        http_client: The HTTP client to use for requests
+    """
+
+    def __init__(self, http_client: HTTPClient) -> None:
+        """Initialize the service.
+
+        Args:
+            http_client: The HTTP client to use for requests
+        """
+        self._http = http_client
+
+    @overload
+    def _post(
+        self,
+        endpoint: str,
+        request: BaseModel | None,
+        response_type: type[T],
+    ) -> T: ...
+
+    @overload
+    def _post(
+        self,
+        endpoint: str,
+        request: BaseModel | None = None,
+        response_type: None = None,
+    ) -> dict[str, Any]: ...
+
+    def _post(
+        self,
+        endpoint: str,
+        request: BaseModel | None = None,
+        response_type: type[T] | None = None,
+    ) -> T | dict[str, Any]:
+        """Make a POST request and parse the response.
+
+        Args:
+            endpoint: API endpoint path
+            request: Request model to serialize as JSON body
+            response_type: Response model type to parse into
+
+        Returns:
+            Parsed response model or raw dict if no response_type
+        """
+        data = request.model_dump(exclude_none=True, by_alias=True) if request else None
+        response = self._http.post(endpoint, data=data)
+
+        # Handle empty responses (204 No Content or empty body)
+        if response.status_code == 204 or not response.content:
+            json_data: dict[str, Any] = {}
+        else:
+            json_data = response.json()
+
+        if response_type:
+            return response_type.model_validate(json_data)
+        return json_data
+
+    @overload
+    def _get(
+        self,
+        endpoint: str,
+        params: dict[str, Any] | None,
+        response_type: type[T],
+    ) -> T: ...
+
+    @overload
+    def _get(
+        self,
+        endpoint: str,
+        params: dict[str, Any] | None = None,
+        response_type: None = None,
+    ) -> dict[str, Any]: ...
+
+    def _get(
+        self,
+        endpoint: str,
+        params: dict[str, Any] | None = None,
+        response_type: type[T] | None = None,
+    ) -> T | dict[str, Any]:
+        """Make a GET request and parse the response.
+
+        Args:
+            endpoint: API endpoint path
+            params: Query parameters
+            response_type: Response model type to parse into
+
+        Returns:
+            Parsed response model or raw dict if no response_type
+        """
+        response = self._http.get(endpoint, params=params)
+
+        # Handle empty responses (204 No Content or empty body)
+        if response.status_code == 204 or not response.content:
+            json_data: dict[str, Any] = {}
+        else:
+            json_data = response.json()
+
+        if response_type:
+            return response_type.model_validate(json_data)
+        return json_data
+
+
+class AsyncBaseService:
+    """Base class for asynchronous DevRev API services.
+
+    Provides common functionality for making async API requests
+    and parsing responses into Pydantic models.
+
+    Args:
+        http_client: The async HTTP client to use for requests
+    """
+
+    def __init__(self, http_client: AsyncHTTPClient) -> None:
+        """Initialize the service.
+
+        Args:
+            http_client: The async HTTP client to use for requests
+        """
+        self._http = http_client
+
+    @overload
+    async def _post(
+        self,
+        endpoint: str,
+        request: BaseModel | None,
+        response_type: type[T],
+    ) -> T: ...
+
+    @overload
+    async def _post(
+        self,
+        endpoint: str,
+        request: BaseModel | None = None,
+        response_type: None = None,
+    ) -> dict[str, Any]: ...
+
+    async def _post(
+        self,
+        endpoint: str,
+        request: BaseModel | None = None,
+        response_type: type[T] | None = None,
+    ) -> T | dict[str, Any]:
+        """Make an async POST request and parse the response.
+
+        Args:
+            endpoint: API endpoint path
+            request: Request model to serialize as JSON body
+            response_type: Response model type to parse into
+
+        Returns:
+            Parsed response model or raw dict if no response_type
+        """
+        data = request.model_dump(exclude_none=True, by_alias=True) if request else None
+        response = await self._http.post(endpoint, data=data)
+
+        # Handle empty responses (204 No Content or empty body)
+        if response.status_code == 204 or not response.content:
+            json_data: dict[str, Any] = {}
+        else:
+            json_data = response.json()
+
+        if response_type:
+            return response_type.model_validate(json_data)
+        return json_data
+
+    @overload
+    async def _get(
+        self,
+        endpoint: str,
+        params: dict[str, Any] | None,
+        response_type: type[T],
+    ) -> T: ...
+
+    @overload
+    async def _get(
+        self,
+        endpoint: str,
+        params: dict[str, Any] | None = None,
+        response_type: None = None,
+    ) -> dict[str, Any]: ...
+
+    async def _get(
+        self,
+        endpoint: str,
+        params: dict[str, Any] | None = None,
+        response_type: type[T] | None = None,
+    ) -> T | dict[str, Any]:
+        """Make an async GET request and parse the response.
+
+        Args:
+            endpoint: API endpoint path
+            params: Query parameters
+            response_type: Response model type to parse into
+
+        Returns:
+            Parsed response model or raw dict if no response_type
+        """
+        response = await self._http.get(endpoint, params=params)
+
+        # Handle empty responses (204 No Content or empty body)
+        if response.status_code == 204 or not response.content:
+            json_data: dict[str, Any] = {}
+        else:
+            json_data = response.json()
+
+        if response_type:
+            return response_type.model_validate(json_data)
+        return json_data

devrev/services/code_changes.py

@@ -0,0 +1,80 @@
+"""Code Changes service for DevRev SDK."""
+
+from __future__ import annotations
+
+from collections.abc import Sequence
+
+from devrev.models.code_changes import (
+    CodeChange,
+    CodeChangesCreateRequest,
+    CodeChangesCreateResponse,
+    CodeChangesDeleteRequest,
+    CodeChangesDeleteResponse,
+    CodeChangesGetRequest,
+    CodeChangesGetResponse,
+    CodeChangesListRequest,
+    CodeChangesListResponse,
+    CodeChangesUpdateRequest,
+    CodeChangesUpdateResponse,
+)
+from devrev.services.base import AsyncBaseService, BaseService
+
+
+class CodeChangesService(BaseService):
+    """Service for managing DevRev Code Changes."""
+
+    def create(self, request: CodeChangesCreateRequest) -> CodeChange:
+        """Create a new code change."""
+        response = self._post("/code-changes.create", request, CodeChangesCreateResponse)
+        return response.code_change
+
+    def get(self, request: CodeChangesGetRequest) -> CodeChange:
+        """Get a code change by ID."""
+        response = self._post("/code-changes.get", request, CodeChangesGetResponse)
+        return response.code_change
+
+    def list(self, request: CodeChangesListRequest | None = None) -> Sequence[CodeChange]:
+        """List code changes."""
+        if request is None:
+            request = CodeChangesListRequest()
+        response = self._post("/code-changes.list", request, CodeChangesListResponse)
+        return response.code_changes
+
+    def update(self, request: CodeChangesUpdateRequest) -> CodeChange:
+        """Update a code change."""
+        response = self._post("/code-changes.update", request, CodeChangesUpdateResponse)
+        return response.code_change
+
+    def delete(self, request: CodeChangesDeleteRequest) -> None:
+        """Delete a code change."""
+        self._post("/code-changes.delete", request, CodeChangesDeleteResponse)
+
+
+class AsyncCodeChangesService(AsyncBaseService):
+    """Async service for managing DevRev Code Changes."""
+
+    async def create(self, request: CodeChangesCreateRequest) -> CodeChange:
+        """Create a new code change."""
+        response = await self._post("/code-changes.create", request, CodeChangesCreateResponse)
+        return response.code_change
+
+    async def get(self, request: CodeChangesGetRequest) -> CodeChange:
+        """Get a code change by ID."""
+        response = await self._post("/code-changes.get", request, CodeChangesGetResponse)
+        return response.code_change
+
+    async def list(self, request: CodeChangesListRequest | None = None) -> Sequence[CodeChange]:
+        """List code changes."""
+        if request is None:
+            request = CodeChangesListRequest()
+        response = await self._post("/code-changes.list", request, CodeChangesListResponse)
+        return response.code_changes
+
+    async def update(self, request: CodeChangesUpdateRequest) -> CodeChange:
+        """Update a code change."""
+        response = await self._post("/code-changes.update", request, CodeChangesUpdateResponse)
+        return response.code_change
+
+    async def delete(self, request: CodeChangesDeleteRequest) -> None:
+        """Delete a code change."""
+        await self._post("/code-changes.delete", request, CodeChangesDeleteResponse)

devrev/services/conversations.py

@@ -0,0 +1,98 @@
+"""Conversations service for DevRev SDK."""
+
+from __future__ import annotations
+
+from collections.abc import Sequence
+
+from devrev.models.conversations import (
+    Conversation,
+    ConversationsCreateRequest,
+    ConversationsCreateResponse,
+    ConversationsDeleteRequest,
+    ConversationsDeleteResponse,
+    ConversationsExportRequest,
+    ConversationsExportResponse,
+    ConversationsGetRequest,
+    ConversationsGetResponse,
+    ConversationsListRequest,
+    ConversationsListResponse,
+    ConversationsUpdateRequest,
+    ConversationsUpdateResponse,
+)
+from devrev.services.base import AsyncBaseService, BaseService
+
+
+class ConversationsService(BaseService):
+    """Service for managing DevRev Conversations."""
+
+    def create(self, request: ConversationsCreateRequest) -> Conversation:
+        """Create a new conversation."""
+        response = self._post("/conversations.create", request, ConversationsCreateResponse)
+        return response.conversation
+
+    def get(self, request: ConversationsGetRequest) -> Conversation:
+        """Get a conversation by ID."""
+        response = self._post("/conversations.get", request, ConversationsGetResponse)
+        return response.conversation
+
+    def list(self, request: ConversationsListRequest | None = None) -> Sequence[Conversation]:
+        """List conversations."""
+        if request is None:
+            request = ConversationsListRequest()
+        response = self._post("/conversations.list", request, ConversationsListResponse)
+        return response.conversations
+
+    def update(self, request: ConversationsUpdateRequest) -> Conversation:
+        """Update a conversation."""
+        response = self._post("/conversations.update", request, ConversationsUpdateResponse)
+        return response.conversation
+
+    def delete(self, request: ConversationsDeleteRequest) -> None:
+        """Delete a conversation."""
+        self._post("/conversations.delete", request, ConversationsDeleteResponse)
+
+    def export(self, request: ConversationsExportRequest | None = None) -> Sequence[Conversation]:
+        """Export conversations."""
+        if request is None:
+            request = ConversationsExportRequest()
+        response = self._post("/conversations.export", request, ConversationsExportResponse)
+        return response.conversations
+
+
+class AsyncConversationsService(AsyncBaseService):
+    """Async service for managing DevRev Conversations."""
+
+    async def create(self, request: ConversationsCreateRequest) -> Conversation:
+        """Create a new conversation."""
+        response = await self._post("/conversations.create", request, ConversationsCreateResponse)
+        return response.conversation
+
+    async def get(self, request: ConversationsGetRequest) -> Conversation:
+        """Get a conversation by ID."""
+        response = await self._post("/conversations.get", request, ConversationsGetResponse)
+        return response.conversation
+
+    async def list(self, request: ConversationsListRequest | None = None) -> Sequence[Conversation]:
+        """List conversations."""
+        if request is None:
+            request = ConversationsListRequest()
+        response = await self._post("/conversations.list", request, ConversationsListResponse)
+        return response.conversations
+
+    async def update(self, request: ConversationsUpdateRequest) -> Conversation:
+        """Update a conversation."""
+        response = await self._post("/conversations.update", request, ConversationsUpdateResponse)
+        return response.conversation
+
+    async def delete(self, request: ConversationsDeleteRequest) -> None:
+        """Delete a conversation."""
+        await self._post("/conversations.delete", request, ConversationsDeleteResponse)
+
+    async def export(
+        self, request: ConversationsExportRequest | None = None
+    ) -> Sequence[Conversation]:
+        """Export conversations."""
+        if request is None:
+            request = ConversationsExportRequest()
+        response = await self._post("/conversations.export", request, ConversationsExportResponse)
+        return response.conversations