feat: external links support (#30)

examples/get_test_entities.py

@@ -33,6 +33,8 @@ async def main() -> None:
     await client.get_attachments_list('TRACKER-1')
     await client.get_issue_comments('TRACKER-1')
     await client.get_projects_list(expand='queues')
+    await client.get_external_applications()
+    await client.get_external_links("TRACKER-1")
 
     await client.stop()
 

ya_tracker_client/domain/entities/external_application.py

@@ -0,0 +1,8 @@
+from ya_tracker_client.domain.entities.base import AbstractEntity
+
+
+class ExternalApplication(AbstractEntity):
+    url: str
+    id: str
+    type: str
+    name: str

ya_tracker_client/domain/entities/external_link.py

@@ -0,0 +1,20 @@
+from datetime import datetime
+
+from pydantic import Field
+
+from ya_tracker_client.domain.entities.base import AbstractEntity
+from ya_tracker_client.domain.entities.external_object import ExternalObject
+from ya_tracker_client.domain.entities.issue_relationship import IssueRelationshipType
+from ya_tracker_client.domain.entities.user import UserShort
+
+
+class ExternalLink(AbstractEntity):
+    url: str
+    id: int
+    type: IssueRelationshipType
+    direction: str = Field(examples=["outward", "inward"])
+    object: ExternalObject
+    created_by: UserShort
+    updated_by: UserShort
+    created_at: datetime
+    updated_at: datetime

ya_tracker_client/domain/entities/external_object.py

@@ -0,0 +1,9 @@
+from ya_tracker_client.domain.entities.base import AbstractEntity
+from ya_tracker_client.domain.entities.external_application import ExternalApplication
+
+
+class ExternalObject(AbstractEntity):
+    url: str
+    id: str
+    key: str
+    application: ExternalApplication

ya_tracker_client/domain/repositories/__init__.py

@@ -1,9 +1,14 @@
 from ya_tracker_client.domain.repositories.attachment import AttachmentRepository
+from ya_tracker_client.domain.repositories.bulk_operation import BulkOperationRepository
 from ya_tracker_client.domain.repositories.checklist import ChecklistRepository
 from ya_tracker_client.domain.repositories.comment import CommentRepository
 from ya_tracker_client.domain.repositories.component import ComponentRepository
+from ya_tracker_client.domain.repositories.external_link import ExternalLinkRepository
+from ya_tracker_client.domain.repositories.importing import ImportingRepository
 from ya_tracker_client.domain.repositories.issue import IssueRepository
+from ya_tracker_client.domain.repositories.issue_field import IssueFieldRepository
 from ya_tracker_client.domain.repositories.issue_relationship import IssueRelationshipRepository
+from ya_tracker_client.domain.repositories.macros import MacrosRepository
 from ya_tracker_client.domain.repositories.project import ProjectRepository
 from ya_tracker_client.domain.repositories.queue import QueueRepository
 from ya_tracker_client.domain.repositories.user import UserRepository
@@ -12,11 +17,16 @@
 
 __all__ = [
     "AttachmentRepository",
+    "BulkOperationRepository",
     "ChecklistRepository",
     "CommentRepository",
     "ComponentRepository",
+    "ExternalLinkRepository",
+    "ImportingRepository",
+    "IssueFieldRepository",
     "IssueRelationshipRepository",
     "IssueRepository",
+    "MacrosRepository",
     "ProjectRepository",
     "QueueRepository",
     "UserRepository",

ya_tracker_client/domain/repositories/board.py

@@ -0,0 +1,5 @@
+from ya_tracker_client.domain.repositories.base import EntityRepository
+
+
+class BoardRepository(EntityRepository):
+    ...

ya_tracker_client/domain/repositories/bulk_operation.py

@@ -0,0 +1,5 @@
+from ya_tracker_client.domain.repositories.base import EntityRepository
+
+
+class BulkOperationRepository(EntityRepository):
+    ...

ya_tracker_client/domain/repositories/external_link.py

@@ -0,0 +1,57 @@
+from ya_tracker_client.domain.entities.external_application import ExternalApplication
+from ya_tracker_client.domain.entities.external_link import ExternalLink
+from ya_tracker_client.domain.repositories.base import EntityRepository
+
+
+class ExternalLinkRepository(EntityRepository):
+    async def get_external_applications(self) -> list[ExternalApplication]:
+        """
+        YC docs: https://cloud.yandex.com/en/docs/tracker/concepts/issues/get-applications
+        """
+        raw_response = await self._client.request(
+            method="GET",
+            uri="/applications",
+        )
+        return self._decode(raw_response, ExternalApplication, plural=True)
+
+    async def get_external_links(self, issue_id: str) -> list[ExternalLink]:
+        """
+        YC docs: https://cloud.yandex.com/en/docs/tracker/concepts/issues/get-external-links
+        """
+        raw_response = await self._client.request(
+            method="GET",
+            uri=f"/issues/{issue_id}/remotelinks",
+        )
+        return self._decode(raw_response, ExternalLink, plural=True)
+
+    async def add_external_link(
+        self,
+        issue_id: str,
+        key: str,
+        origin: str,
+        relationship: str = "RELATES",
+        backlink: bool | None = None,
+    ) -> ExternalLink:
+        """
+        YC docs: https://cloud.yandex.com/en/docs/tracker/concepts/issues/add-external-link
+        """
+        raw_response = await self._client.request(
+            method="POST",
+            uri=f"/issues/{issue_id}/remotelinks",
+            payload={
+                "key": key,
+                "origin": origin,
+                "relationship": relationship,
+            },
+            params={"backlink": backlink} if backlink is not None else None,
+        )
+        return self._decode(raw_response, ExternalLink)
+
+    async def delete_external_link(self, issue_id: str, external_link_id: str | int) -> None:
+        """
+        YC docs: https://cloud.yandex.com/en/docs/tracker/concepts/issues/delete-external-link
+        """
+        await self._client.request(
+            method="DELETE",
+            uri=f"/issues/{issue_id}/remotelinks/{external_link_id}",
+        )

ya_tracker_client/domain/repositories/importing.py

@@ -0,0 +1,5 @@
+from ya_tracker_client.domain.repositories.base import EntityRepository
+
+
+class ImportingRepository(EntityRepository):
+    ...

ya_tracker_client/domain/repositories/issue_field.py

@@ -0,0 +1,5 @@
+from ya_tracker_client.domain.repositories.base import EntityRepository
+
+
+class IssueFieldRepository(EntityRepository):
+    ...

ya_tracker_client/domain/repositories/macros.py

@@ -0,0 +1,5 @@
+from ya_tracker_client.domain.repositories.base import EntityRepository
+
+
+class MacrosRepository(EntityRepository):
+    ...

ya_tracker_client/service/api.py

@@ -1,10 +1,15 @@
 from ya_tracker_client.domain.repositories import (
     AttachmentRepository,
+    BulkOperationRepository,
     ChecklistRepository,
     CommentRepository,
     ComponentRepository,
+    ExternalLinkRepository,
+    ImportingRepository,
+    IssueFieldRepository,
     IssueRelationshipRepository,
     IssueRepository,
+    MacrosRepository,
     ProjectRepository,
     QueueRepository,
     UserRepository,
@@ -15,15 +20,20 @@
 
 class YaTrackerClient(
     AttachmentRepository,
-    CommentRepository,
+    BulkOperationRepository,
     ChecklistRepository,
+    CommentRepository,
     ComponentRepository,
+    ExternalLinkRepository,
+    ImportingRepository,
+    IssueFieldRepository,
     IssueRelationshipRepository,
     IssueRepository,
+    MacrosRepository,
+    ProjectRepository,
     QueueRepository,
     UserRepository,
     WorklogRepository,
-    ProjectRepository,
 ):
     def __init__(
         self,