feat: import support

pyproject.toml

@@ -45,10 +45,11 @@ dev = [
     "pytest-asyncio>=0.21.1",
     "pytest-cov>=4.1.0",
     "ruff>=0.9.7",
-    "polyfactory>=2.8.2",
+    "polyfactory>=2.19.0",
     "gevent>=23.9.1",
     "pre-commit>=3.4.0",
     "python-dotenv>=1.0.0",
+    "vcrpy>=7.0.0",
 ]
 
 [build-system]

tests/conftest.py

@@ -0,0 +1,16 @@
+import os
+
+import pytest
+from dotenv import load_dotenv
+
+from ya_tracker_client import YaTrackerClient
+
+
+@pytest.fixture
+def client() -> YaTrackerClient:
+    load_dotenv()
+    return YaTrackerClient(
+        organisation_id=os.getenv('API_ORGANISATION_ID', default=''),
+        oauth_token=os.getenv('API_TOKEN', default='random_token'),
+        api_host=os.getenv('API_HOST', default='https://api.tracker.yandex.net'),
+    )

tests/integration/test_component.py

@@ -0,0 +1,74 @@
+import vcr
+
+from ya_tracker_client.domain.entities.component import Component
+from ya_tracker_client.domain.entities.queue import QueueShort
+from ya_tracker_client.domain.entities.user import UserShort
+
+
+class TestGetComponents:
+    @vcr.use_cassette(
+        'tests/integration/vcr_cassettes/get_standard_components.yaml',
+        filter_headers=['Authorization', 'X-Cloud-Org-Id'],
+        match_on=['uri', 'method'],
+    )
+    async def test_get_components__when_standard_components_exists__then_return_them(self, client) -> None:
+        # when
+        components = await client.get_components()
+        # then
+        assert components == [
+            Component(
+                url='https://api.tracker.yandex.net/v2/components/1',
+                id=1, version=1, name='Фронтенд',
+                queue=QueueShort(
+                    url='https://api.tracker.yandex.net/v2/queues/DANFIMOV',
+                    id='1',
+                    key='DANFIMOV',
+                    display='Персональная очередь',
+                ),
+                description=None,
+                lead=None,
+                assign_auto=False,
+            ),
+            Component(
+                url='https://api.tracker.yandex.net/v2/components/2',
+                id=2, version=1, name='Бекенд',
+                queue=QueueShort(
+                    url='https://api.tracker.yandex.net/v2/queues/DANFIMOV',
+                    id='1',
+                    key='DANFIMOV',
+                    display='Персональная очередь',
+                ),
+                description=None,
+                lead=None,
+                assign_auto=False,
+            ),
+        ]
+
+    @vcr.use_cassette(
+        'tests/integration/vcr_cassettes/get_custom_component.yaml',
+        filter_headers=['Authorization', 'X-Cloud-Org-Id'],
+        match_on=['uri', 'method'],
+    )
+    async def test_get_components__when_custom_component_exists__then_return_it(self, client) -> None:
+        # when
+        components = await client.get_components()
+        # then
+        assert Component(
+            url='https://api.tracker.yandex.net/v2/components/4',
+            id=4,
+            version=2,
+            name='Custom',
+            queue=QueueShort(
+                url='https://api.tracker.yandex.net/v2/queues/DANFIMOV',
+                id='1',
+                key='DANFIMOV',
+                display='Персональная очередь',
+            ),
+            description='Описание',
+            lead=UserShort(
+                url='https://api.tracker.yandex.net/v2/users/8000000000000004',
+                id='8000000000000004',
+                display='Dmitry Anfimov',
+            ),
+            assign_auto=True,
+        ) == components[2]

tests/integration/test_issue.py

@@ -0,0 +1,79 @@
+from datetime import datetime
+from zoneinfo import ZoneInfo
+
+import pytest
+import vcr
+
+from ya_tracker_client.domain.client.errors import ClientObjectNotFoundError
+from ya_tracker_client.domain.entities.issue import Issue
+from ya_tracker_client.domain.entities.issue_status import IssueStatus
+from ya_tracker_client.domain.entities.issue_type import IssueType
+from ya_tracker_client.domain.entities.priority import Priority
+from ya_tracker_client.domain.entities.queue import QueueShort
+from ya_tracker_client.domain.entities.user import UserShort
+
+
+class TestGetIssue:
+    @vcr.use_cassette(
+        'tests/integration/vcr_cassettes/get_issue_ok.yaml',
+        filter_headers=['Authorization', 'X-Cloud-Org-Id'],
+        match_on=['uri', 'method'],
+    )
+    async def test_get_issue__when_issue_found__then_return_it(self, client) -> None:
+        # when
+        issue = await client.get_issue('TEST-1')
+        # then
+        assert issue == Issue(
+            url='https://api.tracker.yandex.net/v2/issues/TEST-1',
+            id='678b278f6eaab8681c533f79',
+            key='TEST-1',
+            version=1,
+            summary='Test',
+            favorite=False,
+            votes=0,
+            type=IssueType(
+                url='https://api.tracker.yandex.net/v2/issuetypes/2',
+                id='2',
+                key='task',
+                display='Задача',
+            ),
+            priority=Priority(
+                url='https://api.tracker.yandex.net/v2/priorities/3',
+                id=3,
+                key='normal',
+                display='Средний',
+            ),
+            queue=QueueShort(
+                url='https://api.tracker.yandex.net/v2/queues/TEST',
+                id='2',
+                key='TEST',
+                display='Test',
+            ),
+            created_at=datetime(2025, 1, 18, 4, 1, 19, 687000, tzinfo=ZoneInfo('UTC')),
+            created_by=UserShort(
+                url='https://api.tracker.yandex.net/v2/users/8000000000000004',
+                id='8000000000000004',
+                display='Dmitry Anfimov',
+            ),
+            updated_by=UserShort(
+                url='https://api.tracker.yandex.net/v2/users/8000000000000004',
+                id='8000000000000004',
+                display='Dmitry Anfimov',
+            ),
+            updated_at=datetime(2025, 1, 18, 4, 1, 19, 687000, tzinfo=ZoneInfo('UTC')),
+            status=IssueStatus(
+                url='https://api.tracker.yandex.net/v2/statuses/1',
+                id='1',
+                key='open',
+                display='Открыт',
+            ),
+        )
+
+    @vcr.use_cassette(
+        'tests/integration/vcr_cassettes/get_issue_not_found.yaml',
+        filter_headers=['Authorization', 'X-Cloud-Org-Id'],
+        match_on=['uri', 'method'],
+    )
+    async def test_get_issue__when_issue_not_found__then_return_error(self, client) -> None:
+        with pytest.raises(ClientObjectNotFoundError):
+            await client.get_issue('TEST-100')

tests/integration/vcr_cassettes/get_custom_component.yaml

@@ -0,0 +1,22 @@
+interactions:
+- request:
+    body: 'null'
+    headers: {}
+    method: GET
+    uri: https://api.tracker.yandex.net/v2/components
+  response:
+    body:
+      string: "[{\"self\":\"https://api.tracker.yandex.net/v2/components/1\",\"id\":1,\"version\":1,\"name\":\"\u0424\u0440\u043E\u043D\u0442\u0435\u043D\u0434\",\"queue\":{\"self\":\"https://api.tracker.yandex.net/v2/queues/DANFIMOV\",\"id\":\"1\",\"key\":\"DANFIMOV\",\"display\":\"\u041F\u0435\u0440\u0441\u043E\u043D\u0430\u043B\u044C\u043D\u0430\u044F
+        \u043E\u0447\u0435\u0440\u0435\u0434\u044C\"},\"assignAuto\":false},{\"self\":\"https://api.tracker.yandex.net/v2/components/2\",\"id\":2,\"version\":1,\"name\":\"\u0411\u0435\u043A\u0435\u043D\u0434\",\"queue\":{\"self\":\"https://api.tracker.yandex.net/v2/queues/DANFIMOV\",\"id\":\"1\",\"key\":\"DANFIMOV\",\"display\":\"\u041F\u0435\u0440\u0441\u043E\u043D\u0430\u043B\u044C\u043D\u0430\u044F
+        \u043E\u0447\u0435\u0440\u0435\u0434\u044C\"},\"assignAuto\":false},{\"self\":\"https://api.tracker.yandex.net/v2/components/4\",\"id\":4,\"version\":2,\"name\":\"Custom\",\"queue\":{\"self\":\"https://api.tracker.yandex.net/v2/queues/DANFIMOV\",\"id\":\"1\",\"key\":\"DANFIMOV\",\"display\":\"\u041F\u0435\u0440\u0441\u043E\u043D\u0430\u043B\u044C\u043D\u0430\u044F
+        \u043E\u0447\u0435\u0440\u0435\u0434\u044C\"},\"description\":\"\u041E\u043F\u0438\u0441\u0430\u043D\u0438\u0435\",\"lead\":{\"self\":\"https://api.tracker.yandex.net/v2/users/8000000000000004\",\"id\":\"8000000000000004\",\"display\":\"Dmitry
+        Anfimov\",\"cloudUid\":\"ajeasjpl5sfocusdpv14\",\"passportUid\":747064831},\"assignAuto\":true}]"
+    headers:
+      X-Total-Count:
+      - '3'
+      X-Total-Pages:
+      - '1'
+    status:
+      code: 200
+      message: OK
+version: 1

tests/integration/vcr_cassettes/get_issue_not_found.yaml

@@ -0,0 +1,27 @@
+interactions:
+- request:
+    body: 'null'
+    headers: {}
+    method: GET
+    uri: https://api.tracker.yandex.net/v2/issues/TEST-100?expand=
+  response:
+    body:
+      string: "{\"errors\":{},\"errorsData\":{},\"errorMessages\":[\"\u0417\u0430\u0434\u0430\u0447\u0430
+        \u043D\u0435 \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u0435\u0442.\"],\"statusCode\":404}"
+    headers:
+      Content-Language:
+      - ru
+      Content-Type:
+      - application/json;charset=utf-8
+      Date:
+      - Tue, 25 Feb 2025 17:13:26 GMT
+      Set-Cookie:
+      - uid=qcgAAGe9+jYPmQDaBjFrAg==; path=/
+      Transfer-Encoding:
+      - chunked
+      Vary:
+      - Accept-Encoding, Accept-Language, Accept
+    status:
+      code: 404
+      message: Not Found
+version: 1

tests/integration/vcr_cassettes/get_issue_ok.yaml

@@ -0,0 +1,32 @@
+interactions:
+- request:
+    body: 'null'
+    headers: {}
+    method: GET
+    uri: https://api.tracker.yandex.net/v2/issues/TEST-1?expand=
+  response:
+    body:
+      string: "{\"self\":\"https://api.tracker.yandex.net/v2/issues/TEST-1\",\"id\":\"678b278f6eaab8681c533f79\",\"key\":\"TEST-1\",\"version\":1,\"summary\":\"Test\",\"statusStartTime\":\"2025-01-18T04:01:19.738+0000\",\"updatedBy\":{\"self\":\"https://api.tracker.yandex.net/v2/users/8000000000000004\",\"id\":\"8000000000000004\",\"display\":\"Dmitry
+        Anfimov\",\"cloudUid\":\"ajeasjpl5sfocusdpv14\",\"passportUid\":747064831},\"statusType\":{\"id\":\"new\",\"display\":\"\u041D\u0430\u0447\u0430\u043B\u044C\u043D\u044B\u0439\",\"key\":\"new\"},\"type\":{\"self\":\"https://api.tracker.yandex.net/v2/issuetypes/2\",\"id\":\"2\",\"key\":\"task\",\"display\":\"\u0417\u0430\u0434\u0430\u0447\u0430\"},\"priority\":{\"self\":\"https://api.tracker.yandex.net/v2/priorities/3\",\"id\":\"3\",\"key\":\"normal\",\"display\":\"\u0421\u0440\u0435\u0434\u043D\u0438\u0439\"},\"createdAt\":\"2025-01-18T04:01:19.687+0000\",\"createdBy\":{\"self\":\"https://api.tracker.yandex.net/v2/users/8000000000000004\",\"id\":\"8000000000000004\",\"display\":\"Dmitry
+        Anfimov\",\"cloudUid\":\"ajeasjpl5sfocusdpv14\",\"passportUid\":747064831},\"commentWithoutExternalMessageCount\":0,\"votes\":0,\"commentWithExternalMessageCount\":0,\"queue\":{\"self\":\"https://api.tracker.yandex.net/v2/queues/TEST\",\"id\":\"2\",\"key\":\"TEST\",\"display\":\"Test\"},\"updatedAt\":\"2025-01-18T04:01:19.687+0000\",\"status\":{\"self\":\"https://api.tracker.yandex.net/v2/statuses/1\",\"id\":\"1\",\"key\":\"open\",\"display\":\"\u041E\u0442\u043A\u0440\u044B\u0442\"},\"favorite\":false}"
+    headers:
+      Content-Language:
+      - ru
+      Content-Type:
+      - application/json;charset=utf-8
+      Date:
+      - Tue, 25 Feb 2025 16:50:30 GMT
+      Etag:
+      - '"1"'
+      Last-Modified:
+      - Sat, 18 Jan 2025 04:01:19 +0000
+      Set-Cookie:
+      - uid=qcgAAGe99NYPmQDaBiaOAg==; path=/
+      Transfer-Encoding:
+      - chunked
+      Vary:
+      - Accept-Encoding, Accept-Language, Accept
+    status:
+      code: 200
+      message: OK
+version: 1

tests/integration/vcr_cassettes/get_standard_components.yaml

@@ -0,0 +1,20 @@
+interactions:
+- request:
+    body: 'null'
+    headers: {}
+    method: GET
+    uri: https://api.tracker.yandex.net/v2/components
+  response:
+    body:
+      string: "[{\"self\":\"https://api.tracker.yandex.net/v2/components/1\",\"id\":1,\"version\":1,\"name\":\"\u0424\u0440\u043E\u043D\u0442\u0435\u043D\u0434\",\"queue\":{\"self\":\"https://api.tracker.yandex.net/v2/queues/DANFIMOV\",\"id\":\"1\",\"key\":\"DANFIMOV\",\"display\":\"\u041F\u0435\u0440\u0441\u043E\u043D\u0430\u043B\u044C\u043D\u0430\u044F
+        \u043E\u0447\u0435\u0440\u0435\u0434\u044C\"},\"assignAuto\":false},{\"self\":\"https://api.tracker.yandex.net/v2/components/2\",\"id\":2,\"version\":1,\"name\":\"\u0411\u0435\u043A\u0435\u043D\u0434\",\"queue\":{\"self\":\"https://api.tracker.yandex.net/v2/queues/DANFIMOV\",\"id\":\"1\",\"key\":\"DANFIMOV\",\"display\":\"\u041F\u0435\u0440\u0441\u043E\u043D\u0430\u043B\u044C\u043D\u0430\u044F
+        \u043E\u0447\u0435\u0440\u0435\u0434\u044C\"},\"assignAuto\":false}]"
+    headers:
+      X-Total-Count:
+      - '2'
+      X-Total-Pages:
+      - '1'
+    status:
+      code: 200
+      message: OK
+version: 1