update wrapper.py

Author: yuji38kwmt

README.md

@@ -15,7 +15,10 @@
 * 現在、APIは開発途上版です。予告なく互換性のない変更がある可能性をご了承ください。
 * put, post, delete系のメソッドを間違えて実行してしまわないよう、注意してください。特に「プロジェクト削除」や「アノテーション仕様更新」のAPIには十分注意してください。
 
-
+## 廃止予定
+* `wraapper.py get_annotation_specs_from_url`
+    * 廃止理由：過去のアノテーション仕様を`get_annotation_specs`メソッドから取得できるようになったため
+    * 廃止予定日：2019/11/01以降
 
 # Features
 cURLやPostmanなどよりも簡単にAnnoFab Web APIにアクセスできます。

annofabapi/wrapper.py

@@ -4,6 +4,7 @@
 import time
 import urllib
 import urllib.parse
+import warnings
 from typing import Any, Callable, Dict, List, Optional, Tuple  # pylint: disable=unused-import
 
 import requests
@@ -167,13 +168,16 @@ def get_annotation_specs_from_url(self, project_id: str, url: str) -> Annotation
         """
         アノテーション仕様の履歴から取得したURLから、アノテーション仕様を取得する
 
+        .. deprecated:: `get_annotation_specs`から過去のアノテーション仕様を取得できるようになったので、廃止する。2019/11/01以降に廃止する予定。
+
         Args:
             project_id: プロジェクトID
             url: アノテーション仕様の履歴から取得したURL
 
         Returns:
             put_annotation_specsのContent
         """
+        warnings.warn("deprecated", DeprecationWarning)
         cookies, _ = self.api._get_signed_cookie(project_id)
         kwargs = self.api._create_kwargs()
         kwargs.update({"cookies": cookies})

tests/test_api.py

@@ -134,6 +134,10 @@ def test_annotation_specs():
     annotation_specs_histories = api.get_annotation_specs_histories(project_id)[0]
     assert type(annotation_specs_histories) == list
 
+    annotation_spec, _ = api.get_annotation_specs(
+        project_id, query_params={"history_id": annotation_specs_histories[0]["history_id"]})
+    assert type(annotation_spec) == dict
+
     old_annotation_specs_url = annotation_specs_histories[0]["url"]
     old_annotation_specs = wrapper.get_annotation_specs_from_url(project_id, old_annotation_specs_url)
     assert type(old_annotation_specs) == dict

tests/test_local_utils.py

@@ -1,7 +1,3 @@
-import datetime
-
-from annofabapi.utils import to_iso8601_extension
-
 # timezonが異なる場所だとテストに失敗するので、コメントアウトする
 # def test_to_iso8601_extension():
 #     d = datetime.datetime(2019, 10, 8, 16, 20, 8, 241762)