annofabcli 1.102.0__py3-none-any.whl → 1.103.0__py3-none-any.whl

annofabcli/annotation/annotation_query.py

@@ -66,7 +66,7 @@ def _get_additional_data_v1(additional_data: dict[str, Any], attribute_value: At
             )
         if len(tmp) > 1:
             raise ValueError(
-                f"アノテーション仕様の'{get_attribute_name(additional_data)}'属性に、選択肢名(英語)が'{attribute_value}'である選択肢が複数（{len(tmp)} 個）存在します。"  # noqa: E501
+                f"アノテーション仕様の'{get_attribute_name(additional_data)}'属性に、選択肢名(英語)が'{attribute_value}'である選択肢が複数（{len(tmp)} 個）存在します。"
                 f" :: additional_data_definition_id='{additional_data_definition_id}'"
             )
 
@@ -95,13 +95,9 @@ def _get_additional_data_v2(additional_data: dict[str, Any], attribute_value: At
         tmp = [e for e in additional_data["choices"] if get_english_message(e["name"]) == choice_name_en]
 
         if len(tmp) == 0:  # pylint: disable=no-else-raise
-            raise ValueError(
-                f"アノテーション仕様の'{get_attribute_name(additional_data)}'属性に、選択肢名(英語)が'{choice_name_en}'である選択肢は存在しません。"
-            )
+            raise ValueError(f"アノテーション仕様の'{get_attribute_name(additional_data)}'属性に、選択肢名(英語)が'{choice_name_en}'である選択肢は存在しません。")
         elif len(tmp) > 1:
-            raise ValueError(
-                f"アノテーション仕様の'{get_attribute_name(additional_data)}'属性に、選択肢名(英語)が'{choice_name_en}'である選択肢が複数（{len(tmp)} 個）存在します。"  # noqa: E501
-            )
+            raise ValueError(f"アノテーション仕様の'{get_attribute_name(additional_data)}'属性に、選択肢名(英語)が'{choice_name_en}'である選択肢が複数（{len(tmp)} 個）存在します。")
 
         return tmp[0]["choice_id"]
 
@@ -137,9 +133,7 @@ def _get_additional_data_v2(additional_data: dict[str, Any], attribute_value: At
     return {"definition_id": additional_data_definition_id, "value": result_value}
 
 
-def convert_attributes_from_cli_to_api(
-    attributes: dict[str, AttributeValue], annotation_specs: dict[str, Any], *, label_id: Optional[str] = None
-) -> list[AdditionalDataV1]:
+def convert_attributes_from_cli_to_api(attributes: dict[str, AttributeValue], annotation_specs: dict[str, Any], *, label_id: Optional[str] = None) -> list[AdditionalDataV1]:
     """
     CLI用の属性をAPI用の属性に変換します。
 
@@ -179,20 +173,14 @@ def convert_attributes_from_cli_to_api(
             if label_info is None:
                 error_message = f"アノテーション仕様に、属性名(英語)が'{attribute_name}'である属性は存在しません。"
             else:
-                error_message = (
-                    f"アノテーション仕様の'{get_label_name(label_info)}'ラベルに、"
-                    f"属性名(英語)が'{attribute_name}'である属性は存在しません。 :: label_id='{label_id}'"
-                )
+                error_message = f"アノテーション仕様の'{get_label_name(label_info)}'ラベルに、属性名(英語)が'{attribute_name}'である属性は存在しません。 :: label_id='{label_id}'"
             raise ValueError(error_message)
 
         if len(tmp) > 1:
             if label_info is None:
                 error_message = f"アノテーション仕様に、属性名(英語)が'{attribute_name}'である属性が複数存在します。"
             else:
-                error_message = (
-                    f"アノテーション仕様の'{get_label_name(label_info)}'ラベルに、"
-                    f"属性名(英語)が'{attribute_name}'である属性が複数存在します。 :: label_id='{label_id}'"
-                )
+                error_message = f"アノテーション仕様の'{get_label_name(label_info)}'ラベルに、属性名(英語)が'{attribute_name}'である属性が複数存在します。 :: label_id='{label_id}'"
             raise ValueError(error_message)
         additional_data = tmp[0]
         attributes_for_webapi.append(_get_additional_data_v1(additional_data, attribute_value))
@@ -200,9 +188,7 @@ def convert_attributes_from_cli_to_api(
     return attributes_for_webapi
 
 
-def convert_attributes_from_cli_to_additional_data_list_v2(
-    attributes: dict[str, AttributeValue], annotation_specs: dict[str, Any], *, label_id: Optional[str] = None
-) -> list[dict[str, Any]]:
+def convert_attributes_from_cli_to_additional_data_list_v2(attributes: dict[str, AttributeValue], annotation_specs: dict[str, Any], *, label_id: Optional[str] = None) -> list[dict[str, Any]]:
     """
     CLI用の属性情報をAPI用の `AdditionalDataV2` に相当するdictに変換します。
 
@@ -242,20 +228,14 @@ def convert_attributes_from_cli_to_additional_data_list_v2(
             if label_info is None:
                 error_message = f"アノテーション仕様に、属性名(英語)が'{attribute_name}'である属性は存在しません。"
             else:
-                error_message = (
-                    f"アノテーション仕様の'{get_label_name(label_info)}'ラベルに、"
-                    f"属性名(英語)が'{attribute_name}'である属性は存在しません。 :: label_id='{label_id}'"
-                )
+                error_message = f"アノテーション仕様の'{get_label_name(label_info)}'ラベルに、属性名(英語)が'{attribute_name}'である属性は存在しません。 :: label_id='{label_id}'"
             raise ValueError(error_message)
 
         elif len(tmp) > 1:
             if label_info is None:
                 error_message = f"アノテーション仕様に、属性名(英語)が'{attribute_name}'である属性が複数存在します。"
             else:
-                error_message = (
-                    f"アノテーション仕様の'{get_label_name(label_info)}'ラベルに、"
-                    f"属性名(英語)が'{attribute_name}'である属性が複数存在します。 :: label_id='{label_id}'"
-                )
+                error_message = f"アノテーション仕様の'{get_label_name(label_info)}'ラベルに、属性名(英語)が'{attribute_name}'である属性が複数存在します。 :: label_id='{label_id}'"
             raise ValueError(error_message)
         additional_data = tmp[0]
         result.append(_get_additional_data_v2(additional_data, attribute_value))

annofabcli/annotation/change_annotation_attributes.py

@@ -58,9 +58,7 @@ class ChangeAnnotationAttributesMain(CommandLineWithConfirm):
 
         self.dump_annotation_obj = DumpAnnotationMain(service, project_id)
 
-    def change_annotation_attributes(
-        self, annotation_list: list[dict[str, Any]], additional_data_list: list[dict[str, Any]]
-    ) -> Optional[list[dict[str, Any]]]:
+    def change_annotation_attributes(self, annotation_list: list[dict[str, Any]], additional_data_list: list[dict[str, Any]]) -> Optional[list[dict[str, Any]]]:
         """
         アノテーション属性値を変更する。
 
@@ -270,9 +268,7 @@ class ChangeAttributesOfAnnotation(CommandLine):
         return annotation_query_for_cli.to_query_for_api(annotation_specs)
 
     @classmethod
-    def get_additional_data_list_from_cli_attributes(
-        cls, str_attributes: str, annotation_specs: dict[str, Any], label_id: Optional[str]
-    ) -> list[dict[str, Any]]:
+    def get_additional_data_list_from_cli_attributes(cls, str_attributes: str, annotation_specs: dict[str, Any], label_id: Optional[str]) -> list[dict[str, Any]]:
         """
         CLIから受け取った`--attributes`の値から、APIに渡す属性情報(`AdditionalDataListV2`)を返します。
         """
@@ -297,9 +293,7 @@ class ChangeAttributesOfAnnotation(CommandLine):
             sys.exit(COMMAND_LINE_ERROR_STATUS_CODE)
 
         try:
-            additional_data_list = self.get_additional_data_list_from_cli_attributes(
-                args.attributes, annotation_specs, label_id=annotation_query.label_id
-            )
+            additional_data_list = self.get_additional_data_list_from_cli_attributes(args.attributes, annotation_specs, label_id=annotation_query.label_id)
         except ValueError as e:
             print(f"{self.COMMON_MESSAGE} argument '--attributes' の値が不正です。 :: {e}", file=sys.stderr)  # noqa: T201
             sys.exit(COMMAND_LINE_ERROR_STATUS_CODE)
@@ -319,7 +313,7 @@ class ChangeAttributesOfAnnotation(CommandLine):
         if args.force:  # noqa: SIM102
             if not self.facade.contains_any_project_member_role(project_id, [ProjectMemberRole.OWNER]):
                 print(  # noqa: T201
-                    f"{self.COMMON_MESSAGE} argument --force : '--force' 引数を利用するにはプロジェクトのオーナーロールを持つユーザーで実行する必要があります。",  # noqa: E501
+                    f"{self.COMMON_MESSAGE} argument --force : '--force' 引数を利用するにはプロジェクトのオーナーロールを持つユーザーで実行する必要があります。",
                     file=sys.stderr,
                 )
                 sys.exit(COMMAND_LINE_ERROR_STATUS_CODE)
@@ -352,9 +346,7 @@ def parse_args(parser: argparse.ArgumentParser) -> None:
         "--annotation_query",
         type=str,
         required=True,
-        help="変更対象のアノテーションを検索する条件をJSON形式で指定します。"
-        "``file://`` を先頭に付けると、JSON形式のファイルを指定できます。"
-        f"(ex): ``{json.dumps(EXAMPLE_ANNOTATION_QUERY)}``",
+        help=f"変更対象のアノテーションを検索する条件をJSON形式で指定します。``file://`` を先頭に付けると、JSON形式のファイルを指定できます。(ex): ``{json.dumps(EXAMPLE_ANNOTATION_QUERY)}``",
     )
 
     EXAMPLE_ATTRIBUTES = '{"occluded": false}'  # noqa: N806
@@ -375,7 +367,7 @@ def parse_args(parser: argparse.ArgumentParser) -> None:
         "--backup",
         type=str,
         required=False,
-        help="アノテーションのバックアップを保存するディレクトリを指定してください。アノテーションの復元は ``annotation restore`` コマンドで実現できます。",  # noqa: E501
+        help="アノテーションのバックアップを保存するディレクトリを指定してください。アノテーションの復元は ``annotation restore`` コマンドで実現できます。",
     )
     parser.add_argument(
         "--parallelism",

annofabcli/annotation/change_annotation_properties.py

@@ -156,15 +156,10 @@ class ChangePropertiesOfAnnotationMain(CommandLineWithConfirm):
             logger.warning(f"task_id = '{task_id}' は存在しません。")
             return False
 
-        logger.debug(
-            f"{logger_prefix}task_id='{task_id}', phase={dict_task['phase']}, status={dict_task['status']}, "
-            f"updated_datetime={dict_task['updated_datetime']}"
-        )
+        logger.debug(f"{logger_prefix}task_id='{task_id}', phase={dict_task['phase']}, status={dict_task['status']}, updated_datetime={dict_task['updated_datetime']}")
 
         if dict_task["status"] in [TaskStatus.WORKING.value, TaskStatus.COMPLETE.value]:
-            logger.info(
-                f"タスク'{task_id}'は作業中または受入完了状態のため、アノテーションプロパティの変更をスキップします。 status={dict_task['status']}"
-            )
+            logger.info(f"タスク'{task_id}'は作業中または受入完了状態のため、アノテーションプロパティの変更をスキップします。 status={dict_task['status']}")
             return False
 
         old_account_id: Optional[str] = dict_task["account_id"]
@@ -375,9 +370,7 @@ def parse_args(parser: argparse.ArgumentParser) -> None:
         "--properties",
         type=str,
         required=True,
-        help="変更後のプロパティをJSON形式で指定します。変更可能なキーは ``is_protected`` です。"
-        "``file://`` を先頭に付けると、JSON形式のファイルを指定できます。"
-        f"(ex): ``{EXAMPLE_PROPERTIES}``",
+        help=f"変更後のプロパティをJSON形式で指定します。変更可能なキーは ``is_protected`` です。``file://`` を先頭に付けると、JSON形式のファイルを指定できます。(ex): ``{EXAMPLE_PROPERTIES}``",
     )
 
     parser.add_argument(
@@ -390,7 +383,7 @@ def parse_args(parser: argparse.ArgumentParser) -> None:
         "--backup",
         type=str,
         required=False,
-        help="アノテーションのバックアップを保存するディレクトリを指定してください。アノテーションの復元は ``annotation restore`` コマンドで実現できます。",  # noqa: E501
+        help="アノテーションのバックアップを保存するディレクトリを指定してください。アノテーションの復元は ``annotation restore`` コマンドで実現できます。",
     )
 
     parser.add_argument(
@@ -408,7 +401,7 @@ def add_parser(subparsers: Optional[argparse._SubParsersAction] = None) -> argpa
     subcommand_help = "アノテーションのプロパティを変更します。"
     description = (
         "アノテーションのプロパティを一括で変更します。ただし、作業中状態のタスクのアノテーションのプロパティは変更できません。"
-        "間違えてアノテーションのプロパティを変更したときに復元できるようにするため、 ``--backup`` でバックアップ用のディレクトリを指定することを推奨します。"  # noqa: E501
+        "間違えてアノテーションのプロパティを変更したときに復元できるようにするため、 ``--backup`` でバックアップ用のディレクトリを指定することを推奨します。"
     )
     epilog = "オーナロールを持つユーザで実行してください。"
 

annofabcli/annotation/copy_annotation.py

@@ -10,6 +10,7 @@ from dataclasses import dataclass
 from typing import Any, Optional
 
 import annofabapi
+from annofabapi.models import ProjectMemberRole
 from annofabapi.utils import can_put_annotation
 
 import annofabcli
@@ -157,8 +158,7 @@ class CopyAnnotationMain(CommandLineWithConfirm):
         if len(src_input_data_id_list) != len(dest_input_data_id_list):
             max_frame_number = min(len(src_input_data_id_list), len(dest_input_data_id_list))
             logger.debug(
-                f"コピー元タスク'{copy_target.src_task_id}'の1〜{max_frame_number}フレームのアノテーションを、"
-                f"コピー先タスク'{copy_target.dest_task_id}'の1〜{max_frame_number}フレームにコピーします。"
+                f"コピー元タスク'{copy_target.src_task_id}'の1〜{max_frame_number}フレームのアノテーションを、コピー先タスク'{copy_target.dest_task_id}'の1〜{max_frame_number}フレームにコピーします。"
             )
 
         copy_count = 0
@@ -206,9 +206,7 @@ class CopyAnnotationMain(CommandLineWithConfirm):
             アノテーションをコピーしたかどうか。
 
         """
-        src_annotation = self.service.wrapper.get_editor_annotation_or_none(
-            project_id=self.project_id, task_id=copy_target.src_task_id, input_data_id=copy_target.src_input_data_id
-        )
+        src_annotation = self.service.wrapper.get_editor_annotation_or_none(project_id=self.project_id, task_id=copy_target.src_task_id, input_data_id=copy_target.src_input_data_id)
         if src_annotation is None:
             logger.warning(
                 f"task_id='{copy_target.src_task_id}'のタスクが存在しないか、またはtask_id='{copy_target.src_task_id}'のタスクにinput_data_id='{copy_target.src_input_data_id}'の入力データが存在しません。"
@@ -217,9 +215,7 @@ class CopyAnnotationMain(CommandLineWithConfirm):
 
         src_anno_details = src_annotation["details"]
 
-        dest_annotation = self.service.wrapper.get_editor_annotation_or_none(
-            project_id=self.project_id, task_id=copy_target.dest_task_id, input_data_id=copy_target.dest_input_data_id
-        )
+        dest_annotation = self.service.wrapper.get_editor_annotation_or_none(project_id=self.project_id, task_id=copy_target.dest_task_id, input_data_id=copy_target.dest_input_data_id)
         if dest_annotation is None:
             logger.warning(
                 f"task_id='{copy_target.dest_task_id}'のタスクが存在しないか、またはtask_id='{copy_target.dest_task_id}'のタスクにinput_data_id='{copy_target.dest_input_data_id}'の入力データが存在しません。"
@@ -350,6 +346,8 @@ class CopyAnnotation(CommandLine):
             sys.exit(COMMAND_LINE_ERROR_STATUS_CODE)
 
         project_id = args.project_id
+        super().validate_project(project_id, [ProjectMemberRole.OWNER, ProjectMemberRole.ACCEPTER, ProjectMemberRole.WORKER])
+
         str_copy_target_list = get_list_from_args(args.input)
 
         copy_target_list = get_copy_target_list(str_copy_target_list)
@@ -391,8 +389,7 @@ def parse_args(parser: argparse.ArgumentParser) -> None:
     overwrite_merge_group.add_argument(
         "--overwrite",
         action="store_true",
-        help="コピー先にアノテーションが存在する場合、 ``--overwrite`` を指定していれば、すでに存在するアノテーションを削除してコピーします。"
-        "指定しなければ、アノテーションのコピーをスキップします。",
+        help="コピー先にアノテーションが存在する場合、 ``--overwrite`` を指定していれば、すでに存在するアノテーションを削除してコピーします。指定しなければ、アノテーションのコピーをスキップします。",
     )
     overwrite_merge_group.add_argument(
         "--merge",
@@ -421,6 +418,7 @@ def add_parser(subparsers: Optional[argparse._SubParsersAction] = None) -> argpa
     subcommand_name = "copy"
     subcommand_help = "アノテーションをコピーします．"
     description = "タスク単位または入力データ単位で、アノテーションをコピーします。"
-    parser = annofabcli.common.cli.add_parser(subparsers, subcommand_name, subcommand_help, description)
+    epilog = "オーナー、チェッカーまたはアノテータロールを持つユーザで実行してください。"
+    parser = annofabcli.common.cli.add_parser(subparsers, subcommand_name, subcommand_help, description, epilog=epilog)
     parse_args(parser)
     return parser

annofabcli/annotation/delete_annotation.py

@@ -135,10 +135,7 @@ class DeleteAnnotationMain(CommandLineWithConfirm):
 
         if not self.is_force:  # noqa: SIM102
             if task.status == TaskStatus.COMPLETE:
-                logger.info(
-                    f"task_id='{task_id}' :: タスクが完了状態のため、スキップします。"
-                    f"完了状態のタスクのアノテーションを削除するには、`--force`オプションを指定してください。"
-                )
+                logger.info(f"task_id='{task_id}' :: タスクが完了状態のため、スキップします。完了状態のタスクのアノテーションを削除するには、`--force`オプションを指定してください。")
                 return
 
         annotation_list = self.get_annotation_list_for_task(task_id, annotation_query=annotation_query)
@@ -197,10 +194,7 @@ class DeleteAnnotationMain(CommandLineWithConfirm):
         task_id = editor_annotation["task_id"]
         input_data_id = editor_annotation["input_data_id"]
         if len(editor_annotation["details"]) == 0:
-            logger.warning(
-                f"task_id='{task_id}', input_data_id='{input_data_id}' にはアノテーションが存在しません。以下のアノテーションの削除をスキップします。 :: "  # noqa: E501
-                f"annotation_ids={annotation_ids}"
-            )
+            logger.warning(f"task_id='{task_id}', input_data_id='{input_data_id}' にはアノテーションが存在しません。以下のアノテーションの削除をスキップします。 :: annotation_ids={annotation_ids}")
             return 0, len(annotation_ids)
 
         # annotation_idでフィルタ
@@ -209,9 +203,7 @@ class DeleteAnnotationMain(CommandLineWithConfirm):
         nonexistent_annotation_ids = annotation_ids - existent_annotation_ids
 
         if len(nonexistent_annotation_ids) > 0:
-            logger.warning(
-                f"次のアノテーションは存在しないので、削除できません。 :: task_id='{task_id}', input_data_id='{input_data_id}', annotation_id='{nonexistent_annotation_ids}'"  # noqa: E501
-            )
+            logger.warning(f"次のアノテーションは存在しないので、削除できません。 :: task_id='{task_id}', input_data_id='{input_data_id}', annotation_id='{nonexistent_annotation_ids}'")
 
         if len(filtered_details) == 0:
             logger.info(f"task_id='{task_id}', input_data_id='{input_data_id}' には削除対象のアノテーションが存在しないので、スキップします。")
@@ -241,9 +233,7 @@ class DeleteAnnotationMain(CommandLineWithConfirm):
             logger.warning(f"task_id='{task_id}', input_data_id='{input_data_id}' :: アノテーションの削除に失敗しました。", exc_info=True)
             # `batchUpdateAnnotations` APIでエラーになった場合、途中までは削除されるので、`len(annotation_ids)` 件削除に失敗したとは限らない。
             # そのため、再度アノテーション情報を取得して、削除できたアノテーション数と削除できなかったアノテーション数を取得する。
-            new_editor_annotation, _ = self.service.api.get_editor_annotation(
-                self.project_id, task_id=task_id, input_data_id=input_data_id, query_params={"v": "2"}
-            )
+            new_editor_annotation, _ = self.service.api.get_editor_annotation(self.project_id, task_id=task_id, input_data_id=input_data_id, query_params={"v": "2"})
             new_annotation_ids = {e["annotation_id"] for e in new_editor_annotation["details"]}
             deleted_annotation_count = len(existent_annotation_ids - new_annotation_ids)
             failed_to_delete_annotation_count = len(existent_annotation_ids) - deleted_annotation_count
@@ -307,13 +297,10 @@ class DeleteAnnotationMain(CommandLineWithConfirm):
             for input_data_id, annotation_ids in sub_grouped.items():
                 # 指定input_data_idの全annotationを取得
                 # TODO どこかのタイミングで、"v=2"のアノテーションを取得するようにする
-                editor_annotation = self.service.wrapper.get_editor_annotation_or_none(
-                    self.project_id, task_id=task_id, input_data_id=input_data_id, query_params={"v": "1"}
-                )
+                editor_annotation = self.service.wrapper.get_editor_annotation_or_none(self.project_id, task_id=task_id, input_data_id=input_data_id, query_params={"v": "1"})
                 if editor_annotation is None:
                     logger.warning(
-                        f"task_id='{task_id}'のタスクに、input_data_id='{input_data_id}'の入力データが含まれていません。 アノテーションの削除をスキップします。 :: "  # noqa: E501
-                        f"annotation_ids={annotation_ids}"
+                        f"task_id='{task_id}'のタスクに、input_data_id='{input_data_id}'の入力データが含まれていません。 アノテーションの削除をスキップします。 :: annotation_ids={annotation_ids}"
                     )
                     failed_to_delete_annotation_count += len(annotation_ids)
                     continue
@@ -322,9 +309,7 @@ class DeleteAnnotationMain(CommandLineWithConfirm):
                     (backup_dir / task_id).mkdir(exist_ok=True, parents=True)
                     self.dump_annotation_obj.dump_editor_annotation(editor_annotation, json_path=backup_dir / task_id / f"{input_data_id}.json")
 
-                sub_deleted_annotation_count, sub_failed_to_delete_annotation_count = self.delete_annotation_by_annotation_ids(
-                    editor_annotation, set(annotation_ids)
-                )
+                sub_deleted_annotation_count, sub_failed_to_delete_annotation_count = self.delete_annotation_by_annotation_ids(editor_annotation, set(annotation_ids))
                 deleted_annotation_count += sub_deleted_annotation_count
                 failed_to_delete_annotation_count += sub_failed_to_delete_annotation_count
 
@@ -356,7 +341,13 @@ class DeleteAnnotation(CommandLine):
         else:
             backup_dir = Path(args.backup)
 
-        super().validate_project(project_id, [ProjectMemberRole.OWNER])
+        if args.force:
+            # --forceオプションが指定されている場合は、完了状態のタスクも削除する
+            # 完了状態のタスクを削除するには、オーナーロールである必要があるため、`args.force`で条件を分岐する
+            super().validate_project(project_id, [ProjectMemberRole.OWNER])
+        else:
+            super().validate_project(project_id, [ProjectMemberRole.OWNER, ProjectMemberRole.ACCEPTER])
+
         main_obj = DeleteAnnotationMain(self.service, project_id, all_yes=args.yes, is_force=args.force)
 
         if args.json is not None:
@@ -452,12 +443,16 @@ def parse_args(parser: argparse.ArgumentParser) -> None:
         f"(ex): ``{json.dumps(EXAMPLE_ANNOTATION_QUERY)}``",
     )
 
-    parser.add_argument("--force", action="store_true", help="指定した場合は、完了状態のタスクのアノテーションも削除します。")
+    parser.add_argument(
+        "--force",
+        action="store_true",
+        help="指定した場合は、完了状態のタスクのアノテーションも削除します。ただし、完了状態のタスクを削除するには、オーナーロールを持つユーザーが実行する必要があります。",
+    )
     parser.add_argument(
         "--backup",
         type=str,
         required=False,
-        help="アノテーションのバックアップを保存するディレクトリを指定してください。アノテーションの復元は ``annotation restore`` コマンドで実現できます。",  # noqa: E501
+        help="アノテーションのバックアップを保存するディレクトリを指定してください。アノテーションの復元は ``annotation restore`` コマンドで実現できます。",
     )
     parser.set_defaults(subcommand_func=main)
 
@@ -469,7 +464,7 @@ def add_parser(subparsers: Optional[argparse._SubParsersAction] = None) -> argpa
         "タスク配下のアノテーションを削除します。ただし、作業中状態のタスクのアノテーションは削除できません。"
         "間違えてアノテーションを削除したときに復元できるようにするため、 ``--backup`` でバックアップ用のディレクトリを指定することを推奨します。"
     )
-    epilog = "オーナロールを持つユーザで実行してください。"
+    epilog = "オーナーまたはチェッカーロールを持つユーザで実行してください。ただし``--force``オプションを指定した場合は、オーナーロールを持つユーザで実行してください。"
 
     parser = annofabcli.common.cli.add_parser(subparsers, subcommand_name, subcommand_help, description, epilog=epilog)
     parse_args(parser)

annofabcli/annotation/dump_annotation.py

@@ -161,10 +161,7 @@ def parse_args(parser: argparse.ArgumentParser) -> None:
 def add_parser(subparsers: Optional[argparse._SubParsersAction] = None) -> argparse.ArgumentParser:
     subcommand_name = "dump"
     subcommand_help = "``annotation restore`` コマンドに読み込ませることができるアノテーション情報を出力します。"
-    description = (
-        "``annotation restore`` コマンドに読み込ませることができるアノテーション情報を出力します。"
-        "アノテーションのバックアップ目的で利用することを想定しています。"
-    )
+    description = "``annotation restore`` コマンドに読み込ませることができるアノテーション情報を出力します。アノテーションのバックアップ目的で利用することを想定しています。"
 
     parser = annofabcli.common.cli.add_parser(subparsers, subcommand_name, subcommand_help, description)
     parse_args(parser)

annofabcli/annotation/import_annotation.py

@@ -200,9 +200,7 @@ class AnnotationConverter:
             try:
                 choice = get_choice(choices, choice_name=str(attribute_value))
             except ValueError:
-                logger.warning(
-                    f"アノテーション仕様の属性'{attribute_name}'に選択肢名(英語)が'{attribute_value}'である選択肢情報は存在しないか、複数存在します。 :: {log_message_suffix}"  # noqa: E501
-                )
+                logger.warning(f"アノテーション仕様の属性'{attribute_name}'に選択肢名(英語)が'{attribute_value}'である選択肢情報は存在しないか、複数存在します。 :: {log_message_suffix}")
                 if self.is_strict:
                     raise
                 return None
@@ -214,9 +212,7 @@ class AnnotationConverter:
             try:
                 choice = get_choice(choices, choice_name=str(attribute_value))
             except ValueError:
-                logger.warning(
-                    f"アノテーション仕様の属性'{attribute_name}'に選択肢名(英語)が'{attribute_value}'である選択肢情報は存在しないか、複数存在します。 :: {log_message_suffix}"  # noqa: E501
-                )
+                logger.warning(f"アノテーション仕様の属性'{attribute_name}'に選択肢名(英語)が'{attribute_value}'である選択肢情報は存在しないか、複数存在します。 :: {log_message_suffix}")
                 if self.is_strict:
                     raise
                 return None
@@ -226,9 +222,7 @@ class AnnotationConverter:
         else:
             assert_noreturn(additional_data_type)
 
-    def convert_attributes(
-        self, attributes: dict[str, Any], *, label_name: Optional[str] = None, log_message_suffix: str = ""
-    ) -> list[dict[str, Any]]:
+    def convert_attributes(self, attributes: dict[str, Any], *, label_name: Optional[str] = None, log_message_suffix: str = "") -> list[dict[str, Any]]:
         """
         インポート対象のアノテーションJSONに格納されている`attributes`を`AdditionalDataListV2`のlistに変換します。
 
@@ -248,9 +242,7 @@ class AnnotationConverter:
             try:
                 specs_additional_data = self.annotation_specs_accessor.get_attribute(attribute_name=attribute_name, label=label)
             except ValueError:
-                logger.warning(
-                    f"アノテーション仕様に属性名(英語)が'{attribute_name}'である属性情報が存在しないか、複数存在します。 :: {log_message_suffix}"
-                )
+                logger.warning(f"アノテーション仕様に属性名(英語)が'{attribute_name}'である属性情報が存在しないか、複数存在します。 :: {log_message_suffix}")
                 if self.is_strict:
                     raise
                 continue
@@ -293,19 +285,15 @@ class AnnotationConverter:
             ValueError: 存在しないラベル名が指定された場合（`self.is_strict`がFalseでもraiseされる９
 
         """
-        log_message_suffix = (
-            f"task_id='{parser.task_id}', input_data_id='{parser.input_data_id}', label_name='{detail.label}', annotation_id='{detail.annotation_id}'"
-        )
+        log_message_suffix = f"task_id='{parser.task_id}', input_data_id='{parser.input_data_id}', label_name='{detail.label}', annotation_id='{detail.annotation_id}'"
 
         try:
             label_info = self.annotation_specs_accessor.get_label(label_name=detail.label)
         except ValueError:
-            logger.warning(
-                f"アノテーション仕様にラベル名(英語)が'{detail.label}'であるラベル情報が存在しないか、または複数存在します。 :: {log_message_suffix}"
-            )
+            logger.warning(f"アノテーション仕様にラベル名(英語)が'{detail.label}'であるラベル情報が存在しないか、または複数存在します。 :: {log_message_suffix}")
             raise
 
-        if detail.attributes is not None:
+        if detail.attributes is not None:  # noqa: SIM108
             additional_data_list = self.convert_attributes(detail.attributes, label_name=detail.label, log_message_suffix=log_message_suffix)
         else:
             additional_data_list = []
@@ -349,7 +337,7 @@ class AnnotationConverter:
             details: インポート対象のアノテーション情報
             old_details: 既存のアノテーション情報。既存のアノテーション情報に加えて、インポート対象のアノテーションを登録するためのリクエストボディを作成します。
             updated_datetime: 更新日時
-        """  # noqa: E501
+        """
         old_dict_detail = {}
         INDEX_KEY = "_index"  # noqa: N806
         for index, old_detail in enumerate(old_details):
@@ -362,7 +350,7 @@ class AnnotationConverter:
         new_request_details: list[dict[str, Any]] = []
         for detail in details:
             try:
-                log_message_suffix = f"task_id='{parser.task_id}', input_data_id='{parser.input_data_id}', label_name='{detail.label}', annotation_id='{detail.annotation_id}'"  # noqa: E501
+                log_message_suffix = f"task_id='{parser.task_id}', input_data_id='{parser.input_data_id}', label_name='{detail.label}', annotation_id='{detail.annotation_id}'"
 
                 request_detail = self.convert_annotation_detail(parser, detail, log_message_suffix=log_message_suffix)
             except Exception as e:
@@ -424,9 +412,7 @@ class ImportAnnotationMain(CommandLineWithConfirm):
 
         simple_annotation: ImportedSimpleAnnotation = ImportedSimpleAnnotation.from_dict(parser.load_json())
         if len(simple_annotation.details) == 0:
-            logger.debug(
-                f"task_id='{task_id}', input_data_id='{input_data_id}' :: インポート元にアノテーションデータがないため、アノテーションの登録をスキップします。"  # noqa: E501
-            )
+            logger.debug(f"task_id='{task_id}', input_data_id='{input_data_id}' :: インポート元にアノテーションデータがないため、アノテーションの登録をスキップします。")
             return False
 
         input_data = self.service.wrapper.get_input_data_or_none(self.project_id, input_data_id)
@@ -446,13 +432,9 @@ class ImportAnnotationMain(CommandLineWithConfirm):
 
         logger.info(f"task_id='{task_id}', input_data_id='{input_data_id}' :: {len(simple_annotation.details)} 件のアノテーションを登録します。")
         if self.is_merge:
-            request_body = self.converter.convert_annotation_details(
-                parser, simple_annotation.details, old_details=old_annotation["details"], updated_datetime=old_annotation["updated_datetime"]
-            )
+            request_body = self.converter.convert_annotation_details(parser, simple_annotation.details, old_details=old_annotation["details"], updated_datetime=old_annotation["updated_datetime"])
         else:
-            request_body = self.converter.convert_annotation_details(
-                parser, simple_annotation.details, old_details=[], updated_datetime=old_annotation["updated_datetime"]
-            )
+            request_body = self.converter.convert_annotation_details(parser, simple_annotation.details, old_details=[], updated_datetime=old_annotation["updated_datetime"])
 
         self.service.api.put_annotation(self.project_id, task_id, input_data_id, request_body=request_body, query_params={"v": "2"})
         return True
@@ -551,9 +533,7 @@ class ImportAnnotationMain(CommandLineWithConfirm):
         target_task_ids: Optional[set[str]] = None,
         parallelism: Optional[int] = None,
     ):
-        def get_iter_task_parser_from_task_ids(
-            _iter_task_parser: Iterator[SimpleAnnotationParserByTask], _target_task_ids: set[str]
-        ) -> Iterator[SimpleAnnotationParserByTask]:
+        def get_iter_task_parser_from_task_ids(_iter_task_parser: Iterator[SimpleAnnotationParserByTask], _target_task_ids: set[str]) -> Iterator[SimpleAnnotationParserByTask]:
             for task_parser in _iter_task_parser:
                 if task_parser.task_id in _target_task_ids:
                     _target_task_ids.remove(task_parser.task_id)
@@ -586,9 +566,7 @@ class ImportAnnotationMain(CommandLineWithConfirm):
                     task_count += 1
 
         if target_task_ids is not None and len(tmp_target_task_ids) > 0:
-            logger.warning(
-                f"'--task_id'で指定したタスクの内 {len(tmp_target_task_ids)} 件は、インポート対象のアノテーションデータに含まれていません。 :: {tmp_target_task_ids}"  # noqa: E501
-            )
+            logger.warning(f"'--task_id'で指定したタスクの内 {len(tmp_target_task_ids)} 件は、インポート対象のアノテーションデータに含まれていません。 :: {tmp_target_task_ids}")
 
         logger.info(f"{success_count} / {task_count} 件のタスクに対してアノテーションをインポートしました。")
 
@@ -679,8 +657,7 @@ def parse_args(parser: argparse.ArgumentParser) -> None:
         "--annotation",
         type=Path,
         required=True,
-        help="Simpleアノテーションと同じフォルダ構成のzipファイル or ディレクトリのパスを指定してください。"
-        "タスクの状態が作業中/完了の場合はインポートしません。",
+        help="Simpleアノテーションと同じフォルダ構成のzipファイル or ディレクトリのパスを指定してください。タスクの状態が作業中/完了の場合はインポートしません。",
     )
 
     argument_parser.add_task_id(required=False)
@@ -690,8 +667,7 @@ def parse_args(parser: argparse.ArgumentParser) -> None:
     overwrite_merge_group.add_argument(
         "--overwrite",
         action="store_true",
-        help="アノテーションが存在する場合、 ``--overwrite`` を指定していれば、すでに存在するアノテーションを削除してインポートします。"
-        "指定しなければ、アノテーションのインポートをスキップします。",
+        help="アノテーションが存在する場合、 ``--overwrite`` を指定していれば、すでに存在するアノテーションを削除してインポートします。指定しなければ、アノテーションのインポートをスキップします。",
     )
 
     overwrite_merge_group.add_argument(

annofabcli/annotation/list_annotation.py

@@ -104,9 +104,7 @@ class ListAnnotationMain:
 
                 logger.debug(f"入力データ(input_data_id='{input_data_id}')のアノテーション一覧の件数: {len(annotation_list)}")
                 if len(annotation_list) == UPPER_BOUND:
-                    logger.warning(
-                        f"入力データ(input_data_id='{input_data_id}')のアノテーション一覧は{UPPER_BOUND}件で打ち切られている可能性があります。"
-                    )
+                    logger.warning(f"入力データ(input_data_id='{input_data_id}')のアノテーション一覧は{UPPER_BOUND}件で打ち切られている可能性があります。")
                 all_annotation_list.extend(annotation_list)
             return all_annotation_list
         else:
@@ -248,7 +246,6 @@ def parse_args(parser: argparse.ArgumentParser) -> None:
         choices=[FormatArgument.CSV, FormatArgument.JSON, FormatArgument.PRETTY_JSON],
         default=FormatArgument.CSV,
     )
-    argument_parser.add_csv_format()
 
     argument_parser.add_output()