Wrapperクラスにget_editor_annotation_or_none関数を追加 (#455)

* get_editor_annotation_or_none

* updat version

Author: yuji38kwmt

annofabapi/__version__.py

@@ -1 +1 @@
-__version__ = "0.57.0"
+__version__ = "0.58.0"

annofabapi/wrapper.py

@@ -228,6 +228,32 @@ def _download(self, url: str, dest_path: Union[str, Path]) -> requests.Response:
     #########################################
     # Public Method : Annotation
     #########################################
+    def get_editor_annotation_or_none(
+        self, project_id: str, task_id: str, input_data_id: str, *, query_params: Optional[Dict[str, Any]] = None
+    ) -> Optional[Dict[str, Any]]:
+        """
+        アノテーションを取得する。
+        存在しない場合(HTTP 404 Error)はNoneを返します。
+
+        Args:
+            project_id: プロジェクトID
+            task_id: タスクID
+            input_data_id: 入力データID
+
+        Returns:
+            アノテーション
+        """
+        content, response = self.api.get_editor_annotation(
+            project_id, task_id, input_data_id, query_params=query_params, raise_for_status=False
+        )
+
+        if response.status_code == requests.codes.not_found:
+            return None
+        else:
+            _log_error_response(logger, response)
+            _raise_for_status(response)
+            return content
+
     def download_annotation_archive(self, project_id: str, dest_path: Union[str, Path]) -> str:
         """
         simpleアノテーションZIPをダウンロードする。

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "annofabapi"
-version = "0.57.0"
+version = "0.58.0"
 description = "Python Clinet Library of AnnoFab WebAPI (https://annofab.com/docs/api/)"
 authors = ["yuji38kwmt"]
 license = "MIT"

tests/test_api.py

@@ -666,6 +666,14 @@ def test_get_task_histories_or_none(self):
 
         assert wrapper.get_task_histories_or_none("not-exists", task_id) is None
 
+    def test_get_task_histories_or_none(self):
+        actual = wrapper.get_editor_annotation_or_none(project_id, task_id, self.input_data_id)
+        assert actual["task_id"] == task_id
+        assert actual["input_data_id"] == self.input_data_id
+
+        assert wrapper.get_editor_annotation_or_none(project_id, task_id, "not-exists") is None
+        assert wrapper.get_editor_annotation_or_none(project_id, "not-exists", "not-exists") is None
+
 
 class TestProtectedMethod:
     @classmethod