annofabcli 1.101.0__py3-none-any.whl → 1.102.1__py3-none-any.whl

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
@@ -350,6 +351,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)
@@ -421,6 +424,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

@@ -356,7 +356,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,7 +458,12 @@ 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,
@@ -469,7 +480,7 @@ def add_parser(subparsers: Optional[argparse._SubParsersAction] = None) -> argpa
         "タスク配下のアノテーションを削除します。ただし、作業中状態のタスクのアノテーションは削除できません。"
         "間違えてアノテーションを削除したときに復元できるようにするため、 ``--backup`` でバックアップ用のディレクトリを指定することを推奨します。"
     )
-    epilog = "オーナロールを持つユーザで実行してください。"
+    epilog = "オーナーまたはチェッカーロールを持つユーザで実行してください。ただし``--force``オプションを指定した場合は、オーナーロールを持つユーザで実行してください。"  # noqa: E501
 
     parser = annofabcli.common.cli.add_parser(subparsers, subcommand_name, subcommand_help, description, epilog=epilog)
     parse_args(parser)

annofabcli/annotation/merge_segmentation.py

@@ -12,6 +12,7 @@ from typing import Any, Optional
 
 import annofabapi
 import numpy
+from annofabapi.models import ProjectMemberRole
 from annofabapi.pydantic_models.default_annotation_type import DefaultAnnotationType
 from annofabapi.pydantic_models.task_status import TaskStatus
 from annofabapi.segmentation import read_binary_image, write_binary_image
@@ -304,6 +305,8 @@ class MergeSegmentation(CommandLine):
             sys.exit(COMMAND_LINE_ERROR_STATUS_CODE)
 
         project_id = args.project_id
+        super().validate_project(project_id, [ProjectMemberRole.OWNER, ProjectMemberRole.ACCEPTER, ProjectMemberRole.WORKER])
+
         task_id_list = annofabcli.common.cli.get_list_from_args(args.task_id)
         label_name_list = annofabcli.common.cli.get_list_from_args(args.label_name)
 
@@ -385,6 +388,7 @@ def add_parser(subparsers: Optional[argparse._SubParsersAction] = None) -> argpa
         "複数の塗りつぶしアノテーションを1つにまとめます。"
         "ラベルの種類を「塗りつぶし（インスタンスセグメンテーション）」から「塗りつぶしv2（セマンティックセグメンテーション）」に変更する場合などに有用です。"
     )
-    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/remove_segmentation_overlap.py

@@ -12,6 +12,7 @@ from typing import Any, Optional
 
 import annofabapi
 import numpy
+from annofabapi.models import ProjectMemberRole
 from annofabapi.pydantic_models.task_status import TaskStatus
 from annofabapi.segmentation import read_binary_image, write_binary_image
 from annofabapi.utils import can_put_annotation
@@ -291,8 +292,11 @@ class RemoveSegmentationOverlap(CommandLine):
             sys.exit(COMMAND_LINE_ERROR_STATUS_CODE)
 
         project_id = args.project_id
+
         task_id_list = annofabcli.common.cli.get_list_from_args(args.task_id)
 
+        super().validate_project(project_id, [ProjectMemberRole.OWNER, ProjectMemberRole.ACCEPTER, ProjectMemberRole.WORKER])
+
         main_obj = RemoveSegmentationOverlapMain(
             self.service,
             project_id=project_id,
@@ -338,6 +342,7 @@ def add_parser(subparsers: Optional[argparse._SubParsersAction] = None) -> argpa
         "Annofabでインスタンスセグメンテーションは重ねることができてしまいます。"
         "この重なりをなくしたいときに有用です。"
     )
-    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/organization_member/delete_organization_member.py

@@ -7,6 +7,7 @@ from typing import Any, Optional
 
 import annofabapi
 import more_itertools
+from annofabapi.models import OrganizationMemberRole
 
 import annofabcli
 import annofabcli.common.cli
@@ -35,8 +36,14 @@ class DeleteOrganizationMemberMain(CommandLineWithConfirm):
     def get_member(organization_member_list: list[dict[str, Any]], user_id: str) -> Optional[dict[str, Any]]:
         return more_itertools.first_true(organization_member_list, pred=lambda e: e["user_id"] == user_id)
 
-    def main(self, organization_name: str, user_ids: Collection[str]) -> None:
-        logger.info(f"{len(user_ids)} 件のユーザを組織'{organization_name}'から脱退させます。")
+    def delete_organization_members_from_organization(self, organization_name: str, user_ids: Collection[str]) -> None:
+        if not self.facade.contains_any_organization_member_role(
+            organization_name, {OrganizationMemberRole.ADMINISTRATOR, OrganizationMemberRole.OWNER}
+        ):
+            logger.warning(f"組織'{organization_name}'に所属していないか、組織メンバーを脱退できるロールを持たないため、スキップします。")
+            return
+
+        logger.info(f"{len(user_ids)} 件のメンバーを組織'{organization_name}'から脱退させます。")
 
         member_list = self.service.wrapper.get_all_organization_members(organization_name)
 
@@ -45,24 +52,30 @@ class DeleteOrganizationMemberMain(CommandLineWithConfirm):
         for user_id in user_ids:
             member = self.get_member(member_list, user_id)
             if member is None:
-                logger.warning(f"組織メンバにuser_id='{user_id}'のユーザが存在しません。")
+                logger.warning(f"組織'{organization_name}'に user_id='{user_id}'のメンバーが存在しません。")
                 continue
 
             if not self.confirm_processing(
-                f"user_id='{user_id}'のユーザを組織から脱退させますか？ :: username='{member['username']}', role='{member['role']}'"
+                f"組織'{organization_name}'に所属する user_id='{user_id}'のメンバーを脱退させますか？ :: username='{member['username']}'"
             ):
                 continue
 
-            logger.debug(f"user_id='{user_id}'のユーザを組織から脱退させます。 :: username='{member['username']}', role='{member['role']}'")
             try:
                 self.service.api.delete_organization_member(organization_name, user_id)
-                logger.debug(f"user_id='{user_id}'のユーザを組織'{organization_name}'から脱退させました。")
+                logger.debug(f"組織'{organization_name}'から user_id='{user_id}'のメンバーを脱退させました。")
                 success_count += 1
 
             except Exception:  # pylint: disable=broad-except
-                logger.warning(f"user_id='{user_id}'のユーザを組織'{organization_name}'から脱退させるのに失敗しました。", exc_info=True)
+                logger.warning(f"組織'{organization_name}'から user_id='{user_id}'のメンバーを脱退させるのに失敗しました。", exc_info=True)
+
+        logger.info(f"{success_count} / {len(user_ids)} 件のメンバーを組織'{organization_name}'から脱退させました。")
 
-        logger.info(f"{success_count} / {len(user_ids)} 件のユーザを組織'{organization_name}'から脱退させました。")
+    def delete_organization_members_from_organizations(self, organization_names: list[str], user_ids: Collection[str]) -> None:
+        for organization_name in organization_names:
+            try:
+                self.delete_organization_members_from_organization(organization_name, user_ids)
+            except Exception:  # pylint
+                logger.warning(f"組織'{organization_name}'からメンバーを脱退させるのに失敗しました。", exc_info=True)
 
 
 class DeleteOrganizationMember(CommandLine):
@@ -70,9 +83,10 @@ class DeleteOrganizationMember(CommandLine):
         args = self.args
 
         user_id_list = annofabcli.common.cli.get_list_from_args(args.user_id)
+        organization_name_list = annofabcli.common.cli.get_list_from_args(args.organization)
 
         main_obj = DeleteOrganizationMemberMain(self.service, all_yes=args.yes)
-        main_obj.main(organization_name=args.organization, user_ids=user_id_list)
+        main_obj.delete_organization_members_from_organizations(organization_name_list, user_id_list)
 
 
 def main(args: argparse.Namespace) -> None:
@@ -82,7 +96,14 @@ def main(args: argparse.Namespace) -> None:
 
 
 def parse_args(parser: argparse.ArgumentParser) -> None:
-    parser.add_argument("-org", "--organization", required=True, type=str, help="対象の組織の組織名を指定してください。")
+    parser.add_argument(
+        "-org",
+        "--organization",
+        nargs="+",
+        required=True,
+        type=str,
+        help="対象の組織名を指定してます。 ``file://`` を先頭に付けると、一覧が記載されたファイルを指定できます。",
+    )
 
     parser.add_argument(
         "-u",
@@ -90,7 +111,7 @@ def parse_args(parser: argparse.ArgumentParser) -> None:
         type=str,
         nargs="+",
         required=True,
-        help="組織から脱退させるユーザのuser_idを指定してください。 ``file://`` を先頭に付けると、一覧が記載されたファイルを指定できます。",
+        help="組織から脱退させるメンバーのuser_idを指定します。 ``file://`` を先頭に付けると、一覧が記載されたファイルを指定できます。",
     )
 
     parser.set_defaults(subcommand_func=main)
@@ -98,10 +119,9 @@ def parse_args(parser: argparse.ArgumentParser) -> None:
 
 def add_parser(subparsers: Optional[argparse._SubParsersAction] = None) -> argparse.ArgumentParser:
     subcommand_name = "delete"
-    subcommand_help = "組織からユーザを脱退させます。"
-    description = "組織からユーザを脱退させます。"
+    subcommand_help = "組織からメンバーを脱退させます。"
     epilog = "組織オーナまたは組織管理者ロールを持つユーザで実行してください。"
 
-    parser = annofabcli.common.cli.add_parser(subparsers, subcommand_name, command_help=subcommand_help, description=description, epilog=epilog)
+    parser = annofabcli.common.cli.add_parser(subparsers, subcommand_name, command_help=subcommand_help, epilog=epilog)
     parse_args(parser)
     return parser

annofabcli/organization_member/invite_organization_member.py

@@ -29,8 +29,14 @@ class InviteOrganizationMemberMain(CommandLineWithConfirm):
         self.facade = AnnofabApiFacade(service)
         super().__init__(all_yes)
 
-    def main(self, organization_name: str, user_ids: Collection[str], role: str) -> None:
-        logger.info(f"{len(user_ids)} 件のユーザを組織'{organization_name}'に招待して、ロール'{role}'を付与します。")
+    def invite_members_to_organization(self, organization_name: str, user_ids: Collection[str], role: str) -> None:
+        if not self.facade.contains_any_organization_member_role(
+            organization_name, {OrganizationMemberRole.ADMINISTRATOR, OrganizationMemberRole.OWNER}
+        ):
+            logger.warning(f"組織'{organization_name}'に所属していないか、組織メンバーを招待できるロールを持たないため、スキップします。")
+            return
+
+        logger.info(f"{len(user_ids)} 件のメンバーを組織'{organization_name}'に招待して、ロール'{role}'を付与します。")
 
         organization_member_list = self.service.wrapper.get_all_organization_members(organization_name)
         all_user_ids = {e["user_id"] for e in organization_member_list}
@@ -39,21 +45,28 @@ class InviteOrganizationMemberMain(CommandLineWithConfirm):
         success_count = 0
         for user_id in user_ids:
             if user_id in all_user_ids:
-                logger.warning(f"user_id='{user_id}'のユーザは、すでに組織'{organization_name}'に存在しています。")
+                logger.warning(f"user_id='{user_id}'のメンバーは、すでに組織'{organization_name}'に存在しているため、スキップします。")
                 continue
 
-            if not self.confirm_processing(f"user_id='{user_id}'のユーザを組織'{organization_name}'に招待しますか？ :: role='{role}'"):
+            if not self.confirm_processing(f"user_id='{user_id}'のメンバーを組織'{organization_name}'に招待して、ロール'{role}'を付与しますか？"):
                 continue
 
             try:
                 self.service.api.invite_organization_member(organization_name, user_id, request_body={"role": role})
-                logger.debug(f"user_id='{user_id}'のユーザを組織'{organization_name}'に招待しました。")
+                logger.debug(f"user_id='{user_id}'のメンバーを組織'{organization_name}'に招待しました。")
                 success_count += 1
 
             except Exception:  # pylint: disable=broad-except
-                logger.warning(f"user_id='{user_id}'のユーザを組織'{organization_name}'に招待するのに失敗しました。", exc_info=True)
+                logger.warning(f"user_id='{user_id}'のメンバーを組織'{organization_name}'に招待するのに失敗しました。", exc_info=True)
+
+        logger.info(f"{success_count} / {len(user_ids)} 件のメンバーを組織'{organization_name}'に招待しました。")
 
-        logger.info(f"{success_count} / {len(user_ids)} 件のユーザを組織'{organization_name}'に招待しました。")
+    def invite_members_to_organizations(self, organization_names: list[str], user_ids: Collection[str], role: str) -> None:
+        for organization_name in organization_names:
+            try:
+                self.invite_members_to_organization(organization_name, user_ids, role)
+            except Exception:  # pylint
+                logger.warning(f"組織'{organization_name}'にメンバーを招待するのに失敗しました。", exc_info=True)
 
 
 class InviteOrganizationMember(CommandLine):
@@ -61,9 +74,10 @@ class InviteOrganizationMember(CommandLine):
         args = self.args
 
         user_id_list = annofabcli.common.cli.get_list_from_args(args.user_id)
+        organization_name_list = annofabcli.common.cli.get_list_from_args(args.organization)
 
         main_obj = InviteOrganizationMemberMain(self.service, all_yes=args.yes)
-        main_obj.main(organization_name=args.organization, user_ids=user_id_list, role=args.role)
+        main_obj.invite_members_to_organizations(organization_name_list, user_id_list, role=args.role)
 
 
 def main(args: argparse.Namespace) -> None:
@@ -73,7 +87,7 @@ def main(args: argparse.Namespace) -> None:
 
 
 def parse_args(parser: argparse.ArgumentParser) -> None:
-    parser.add_argument("-org", "--organization", required=True, type=str, help="対象の組織の組織名を指定してください。")
+    parser.add_argument("-org", "--organization", nargs="+", required=True, type=str, help="招待先の組織名を指定してください。")
 
     parser.add_argument(
         "-u",
@@ -81,7 +95,7 @@ def parse_args(parser: argparse.ArgumentParser) -> None:
         type=str,
         nargs="+",
         required=True,
-        help="組織に招待するユーザのuser_idを指定してください。 ``file://`` を先頭に付けると、一覧が記載されたファイルを指定できます。",
+        help="組織に招待するメンバーのuser_idを指定してます。 ``file://`` を先頭に付けると、一覧が記載されたファイルを指定できます。",
     )
 
     role_choices = [e.value for e in OrganizationMemberRole]
@@ -90,7 +104,7 @@ def parse_args(parser: argparse.ArgumentParser) -> None:
         type=str,
         choices=role_choices,
         required=True,
-        help="招待するユーザに割り当てる組織メンバのロールを指定してください。",
+        help="招待するメンバーに割り当てるロールを指定してください。",
     )
 
     parser.set_defaults(subcommand_func=main)
@@ -98,10 +112,9 @@ def parse_args(parser: argparse.ArgumentParser) -> None:
 
 def add_parser(subparsers: Optional[argparse._SubParsersAction] = None) -> argparse.ArgumentParser:
     subcommand_name = "invite"
-    subcommand_help = "組織にユーザを招待します。"
-    description = "組織にユーザを招待します。"
+    subcommand_help = "組織にメンバーを招待します。"
     epilog = "組織オーナまたは組織管理者ロールを持つユーザで実行してください。"
 
-    parser = annofabcli.common.cli.add_parser(subparsers, subcommand_name, command_help=subcommand_help, description=description, epilog=epilog)
+    parser = annofabcli.common.cli.add_parser(subparsers, subcommand_name, command_help=subcommand_help, epilog=epilog)
     parse_args(parser)
     return parser

annofabcli/statistics/list_annotation_area.py

@@ -0,0 +1,320 @@
+from __future__ import annotations
+
+import argparse
+import logging
+import sys
+import tempfile
+import zipfile
+from collections.abc import Collection, Iterator
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Any, Optional
+
+import numpy
+import pandas
+from annofabapi.models import InputDataType, ProjectMemberRole
+from annofabapi.parser import (
+    SimpleAnnotationParser,
+    lazy_parse_simple_annotation_dir,
+    lazy_parse_simple_annotation_zip,
+)
+from annofabapi.segmentation import read_binary_image
+from dataclasses_json import DataClassJsonMixin
+
+import annofabcli
+import annofabcli.common.cli
+from annofabcli.common.cli import (
+    COMMAND_LINE_ERROR_STATUS_CODE,
+    ArgumentParser,
+    CommandLine,
+    build_annofabapi_resource_and_login,
+)
+from annofabcli.common.download import DownloadingFile
+from annofabcli.common.enums import FormatArgument
+from annofabcli.common.facade import (
+    AnnofabApiFacade,
+    TaskQuery,
+    match_annotation_with_task_query,
+)
+from annofabcli.common.utils import print_csv, print_json
+
+logger = logging.getLogger(__name__)
+
+
+def lazy_parse_simple_annotation_by_input_data(annotation_path: Path) -> Iterator[SimpleAnnotationParser]:
+    if not annotation_path.exists():
+        raise RuntimeError(f"'{annotation_path}' は存在しません。")
+
+    if annotation_path.is_dir():
+        return lazy_parse_simple_annotation_dir(annotation_path)
+    elif zipfile.is_zipfile(str(annotation_path)):
+        return lazy_parse_simple_annotation_zip(annotation_path)
+    else:
+        raise RuntimeError(f"'{annotation_path}'は、zipファイルまたはディレクトリではありません。")
+
+
+@dataclass(frozen=True)
+class AnnotationAreaInfo(DataClassJsonMixin):
+    task_id: str
+    task_status: str
+    task_phase: str
+    task_phase_stage: int
+
+    input_data_id: str
+    input_data_name: str
+
+    label: str
+    annotation_id: str
+    annotation_area: int
+
+
+def calculate_bounding_box_area(data: dict[str, Any]) -> int:
+    width = abs(data["right_bottom"]["x"] - data["left_top"]["x"])
+    height = abs(data["right_bottom"]["y"] - data["left_top"]["y"])
+    return width * height
+
+
+def calculate_segmentation_area(outer_file: Path) -> int:
+    nd_array = read_binary_image(outer_file)
+    return numpy.count_nonzero(nd_array)
+
+
+def get_annotation_area_info_list(parser: SimpleAnnotationParser, simple_annotation: dict[str, Any]) -> list[AnnotationAreaInfo]:
+    result = []
+    for detail in simple_annotation["details"]:
+        if detail["data"]["_type"] in {"Segmentation", "SegmentationV2"}:
+            annotation_area = calculate_segmentation_area(parser.open_outer_file(detail["data"]["data_uri"]))
+        elif detail["data"]["_type"] == "BoundingBox":
+            annotation_area = calculate_bounding_box_area(detail["data"])
+
+        else:
+            continue
+
+        result.append(
+            AnnotationAreaInfo(
+                task_id=simple_annotation["task_id"],
+                task_phase=simple_annotation["task_phase"],
+                task_phase_stage=simple_annotation["task_phase_stage"],
+                task_status=simple_annotation["task_status"],
+                input_data_id=simple_annotation["input_data_id"],
+                input_data_name=simple_annotation["input_data_name"],
+                label=detail["label"],
+                annotation_id=detail["annotation_id"],
+                annotation_area=annotation_area,
+            )
+        )
+
+    return result
+
+
+def get_annotation_area_info_list_from_annotation_path(
+    annotation_path: Path,
+    *,
+    target_task_ids: Optional[Collection[str]] = None,
+    task_query: Optional[TaskQuery] = None,
+) -> list[AnnotationAreaInfo]:
+    annotation_area_list = []
+    target_task_ids = set(target_task_ids) if target_task_ids is not None else None
+    iter_parser = lazy_parse_simple_annotation_by_input_data(annotation_path)
+    logger.debug("アノテーションzip/ディレクトリを読み込み中")
+    for index, parser in enumerate(iter_parser):
+        if (index + 1) % 1000 == 0:
+            logger.debug(f"{index + 1}  件目のJSONを読み込み中")
+        if target_task_ids is not None and parser.task_id not in target_task_ids:
+            continue
+        simple_annotation_dict = parser.load_json()
+        if task_query is not None:  # noqa: SIM102
+            if not match_annotation_with_task_query(simple_annotation_dict, task_query):
+                continue
+        sub_annotation_area_list = get_annotation_area_info_list(parser, simple_annotation_dict)
+        annotation_area_list.extend(sub_annotation_area_list)
+    return annotation_area_list
+
+
+def create_df(
+    annotation_area_list: list[AnnotationAreaInfo],
+) -> pandas.DataFrame:
+    columns = [
+        "task_id",
+        "task_status",
+        "task_phase",
+        "task_phase_stage",
+        "input_data_id",
+        "input_data_name",
+        "label",
+        "annotation_id",
+        "annotation_area",
+    ]
+    df = pandas.DataFrame(e.to_dict() for e in annotation_area_list)
+    if len(df) == 0:
+        df = pandas.DataFrame(columns=columns)
+
+    df = df.fillna({"annotation_area": 0})
+    return df[columns]
+
+
+def print_annotation_area(
+    annotation_path: Path,
+    output_file: Path,
+    output_format: FormatArgument,
+    *,
+    target_task_ids: Optional[Collection[str]] = None,
+    task_query: Optional[TaskQuery] = None,
+) -> None:
+    annotation_area_list = get_annotation_area_info_list_from_annotation_path(
+        annotation_path,
+        target_task_ids=target_task_ids,
+        task_query=task_query,
+    )
+
+    logger.info(f"{len(annotation_area_list)} 件のタスクに含まれる塗りつぶしアノテーションのピクセル数情報を出力します。")
+
+    if output_format == FormatArgument.CSV:
+        df = create_df(annotation_area_list)
+        print_csv(df, output_file)
+
+    elif output_format in [FormatArgument.PRETTY_JSON, FormatArgument.JSON]:
+        json_is_pretty = output_format == FormatArgument.PRETTY_JSON
+        print_json(
+            [e.to_dict(encode_json=True) for e in annotation_area_list],
+            is_pretty=json_is_pretty,
+            output=output_file,
+        )
+
+    else:
+        raise RuntimeError(f"出力形式 '{output_format}' はサポートされていません。")
+
+
+class ListAnnotationArea(CommandLine):
+    COMMON_MESSAGE = "annofabcli statistics list_annotation_area: error:"
+
+    def validate(self, args: argparse.Namespace) -> bool:
+        if args.project_id is None and args.annotation is None:
+            print(  # noqa: T201
+                f"{self.COMMON_MESSAGE} argument --project_id: '--annotation'が未指定のときは、'--project_id' を指定してください。",
+                file=sys.stderr,
+            )
+            return False
+        return True
+
+    def main(self) -> None:
+        args = self.args
+
+        if not self.validate(args):
+            sys.exit(COMMAND_LINE_ERROR_STATUS_CODE)
+
+        project_id: Optional[str] = args.project_id
+        if project_id is not None:
+            super().validate_project(project_id, project_member_roles=[ProjectMemberRole.OWNER, ProjectMemberRole.TRAINING_DATA_USER])
+            project, _ = self.service.api.get_project(project_id)
+            if project["input_data_type"] != InputDataType.IMAGE.value:
+                logger.warning(f"project_id='{project_id}'であるプロジェクトは、画像プロジェクトでないので、出力されるデータは0件になります。")
+
+        annotation_path = Path(args.annotation) if args.annotation is not None else None
+
+        task_id_list = annofabcli.common.cli.get_list_from_args(args.task_id) if args.task_id is not None else None
+        task_query = TaskQuery.from_dict(annofabcli.common.cli.get_json_from_args(args.task_query)) if args.task_query is not None else None
+
+        output_file: Path = args.output
+        output_format = FormatArgument(args.format)
+
+        downloading_obj = DownloadingFile(self.service)
+
+        def download_and_print_annotation_area(project_id: str, temp_dir: Path, *, is_latest: bool, annotation_path: Optional[Path]) -> None:
+            if annotation_path is None:
+                annotation_path = temp_dir / f"{project_id}__annotation.zip"
+                downloading_obj.download_annotation_zip(
+                    project_id,
+                    dest_path=annotation_path,
+                    is_latest=is_latest,
+                )
+            print_annotation_area(
+                output_format=output_format,
+                output_file=output_file,
+                target_task_ids=task_id_list,
+                task_query=task_query,
+                annotation_path=annotation_path,
+            )
+
+        if project_id is not None:
+            if args.temp_dir is not None:
+                download_and_print_annotation_area(
+                    project_id=project_id, temp_dir=args.temp_dir, is_latest=args.latest, annotation_path=annotation_path
+                )
+            else:
+                with tempfile.TemporaryDirectory() as str_temp_dir:
+                    download_and_print_annotation_area(
+                        project_id=project_id, temp_dir=Path(str_temp_dir), is_latest=args.latest, annotation_path=annotation_path
+                    )
+        else:
+            assert annotation_path is not None
+            print_annotation_area(
+                output_format=output_format,
+                output_file=output_file,
+                target_task_ids=task_id_list,
+                task_query=task_query,
+                annotation_path=annotation_path,
+            )
+
+
+def parse_args(parser: argparse.ArgumentParser) -> None:
+    argument_parser = ArgumentParser(parser)
+
+    parser.add_argument(
+        "--annotation",
+        type=str,
+        help="アノテーションzip、またはzipを展開したディレクトリを指定します。指定しない場合はAnnofabからダウンロードします。",
+    )
+
+    parser.add_argument(
+        "-p",
+        "--project_id",
+        type=str,
+        help="project_id。``--annotation`` が未指定のときは必須です。\n"
+        "``--annotation`` が指定されているときに ``--project_id`` を指定すると、アノテーション仕様を参照して、集計対象の属性やCSV列順が決まります。",
+    )
+
+    argument_parser.add_format(
+        choices=[FormatArgument.CSV, FormatArgument.JSON, FormatArgument.PRETTY_JSON],
+        default=FormatArgument.CSV,
+    )
+
+    argument_parser.add_output()
+
+    parser.add_argument(
+        "-tq",
+        "--task_query",
+        type=str,
+        help="集計対象タスクを絞り込むためのクエリ条件をJSON形式で指定します。使用できるキーは task_id, status, phase, phase_stage です。"
+        " ``file://`` を先頭に付けると、JSON形式のファイルを指定できます。",
+    )
+    argument_parser.add_task_id(required=False)
+
+    parser.add_argument(
+        "--latest",
+        action="store_true",
+        help="``--annotation`` を指定しないとき、最新のアノテーションzipを参照します。このオプションを指定すると、アノテーションzipを更新するのに数分待ちます。",  # noqa: E501
+    )
+
+    parser.add_argument(
+        "--temp_dir",
+        type=Path,
+        help="指定したディレクトリに、アノテーションZIPなどの一時ファイルをダウンロードします。",
+    )
+
+    parser.set_defaults(subcommand_func=main)
+
+
+def main(args: argparse.Namespace) -> None:
+    service = build_annofabapi_resource_and_login(args)
+    facade = AnnofabApiFacade(service)
+    ListAnnotationArea(service, facade, args).main()
+
+
+def add_parser(subparsers: Optional[argparse._SubParsersAction] = None) -> argparse.ArgumentParser:
+    subcommand_name = "list_annotation_area"
+    subcommand_help = "塗りつぶしアノテーションまたは矩形アノテーションの面積を出力します。"
+    epilog = "オーナロールまたはアノテーションユーザロールを持つユーザで実行してください。"
+    parser = annofabcli.common.cli.add_parser(subparsers, subcommand_name, subcommand_help, description=subcommand_help, epilog=epilog)
+    parse_args(parser)
+    return parser

annofabcli/statistics/subcommand_statistics.py

@@ -4,6 +4,7 @@ from typing import Optional
 import annofabcli
 import annofabcli.common.cli
 import annofabcli.stat_visualization.merge_visualization_dir
+import annofabcli.statistics.list_annotation_area
 import annofabcli.statistics.list_annotation_attribute
 import annofabcli.statistics.list_annotation_attribute_filled_count
 import annofabcli.statistics.list_annotation_count
@@ -27,6 +28,7 @@ def parse_args(parser: argparse.ArgumentParser) -> None:
     annofabcli.statistics.list_annotation_attribute_filled_count.add_parser(subparsers)
     annofabcli.statistics.list_annotation_count.add_parser(subparsers)
     annofabcli.statistics.list_annotation_duration.add_parser(subparsers)
+    annofabcli.statistics.list_annotation_area.add_parser(subparsers)
 
     annofabcli.statistics.list_video_duration.add_parser(subparsers)
     annofabcli.statistics.list_worktime.add_parser(subparsers)

{annofabcli-1.101.0.dist-info → annofabcli-1.102.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: annofabcli
-Version: 1.101.0
+Version: 1.102.1
 Summary: Utility Command Line Interface for AnnoFab
 Author: Kurusugawa Computer Inc.
 License: MIT

{annofabcli-1.101.0.dist-info → annofabcli-1.102.1.dist-info}/RECORD

@@ -5,15 +5,15 @@ annofabcli/annotation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3h
 annofabcli/annotation/annotation_query.py,sha256=ke3W3RT1-WfFzwt-TXcQwGmghG34vcKJkM_jxgbNKjU,15922
 annofabcli/annotation/change_annotation_attributes.py,sha256=GcabzuTeUhGHibYxOhoSgB9RR1ACmtrdxdmGGCiUnNQ,17200
 annofabcli/annotation/change_annotation_properties.py,sha256=Zgxl2GVuoMsFComW5Wkaip3UKeOyPpH9T0FMsngpswc,18427
-annofabcli/annotation/copy_annotation.py,sha256=Zy8sS7Hy4DVPLgtRrppEVuesfzj4rq07vXM783k6Akg,18165
-annofabcli/annotation/delete_annotation.py,sha256=1rwuPTd_bnrmq_pVrzojy-1i7nAAme6MaTQEfKmq4n0,22696
+annofabcli/annotation/copy_annotation.py,sha256=79kJOfz_U_PIcP89HXdMW0HN5wiN5i-AxdjkwFgg5rQ,18482
+annofabcli/annotation/delete_annotation.py,sha256=pZb48d7lRYEAYOFPOi_pt3rnOG5YNGuq-oPbjTOFEXc,23462
 annofabcli/annotation/download_annotation_zip.py,sha256=P_ZpdqIaSFEmB8jjpdykcRhh2tVlHxSlXFrYreJjShE,3282
 annofabcli/annotation/dump_annotation.py,sha256=bVEQeRYfskEKo5QjZ-bT6zsBon8u4bRySVy-CmJJTm8,7493
 annofabcli/annotation/import_annotation.py,sha256=Yg032TQgnBVUaG12Kjvta2YLvSk4NN9CvdZTWtZta28,33799
 annofabcli/annotation/list_annotation.py,sha256=B8ZFI7SRQPy-TgbpaX-tzXhveViY17YuCPE9BuK9mrs,10790
 annofabcli/annotation/list_annotation_count.py,sha256=T9fbaoxWeDJIVgW_YgHRldbwrVZWiE-57lfJrDQrj80,6474
-annofabcli/annotation/merge_segmentation.py,sha256=ldEQlcyCrog0KFYn92sTkScZQ7gmTjlujuCsKBemjhU,17950
-annofabcli/annotation/remove_segmentation_overlap.py,sha256=gONYqaI0PMEGYJduB4JsmGBn3LCY9JtLSFgosWYyc3M,15957
+annofabcli/annotation/merge_segmentation.py,sha256=FuUrDG6HqMOna4BDJtC-NpqUBdQn45Oi-hzFyAVtDng,18267
+annofabcli/annotation/remove_segmentation_overlap.py,sha256=NIwz45DwuBO6p-Zsty1WdI4eAJbzqUJkDLiJFZirX2k,16275
 annofabcli/annotation/restore_annotation.py,sha256=B3zitm-xB5ZuZy7c-6umiltK49Gdu3Di7YWTqNhJ22g,14704
 annofabcli/annotation/subcommand_annotation.py,sha256=ku9mzb7zZilHcjf1MFV1E7EJ8OvfSUDHpcunM38teto,2122
 annofabcli/annotation_specs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -106,8 +106,8 @@ annofabcli/organization/list_organization.py,sha256=kafkiBHd4nkJ_fqxJwYcuU79mqzE
 annofabcli/organization/subcommand_organization.py,sha256=EM-3uU45T9H51kcQGVR6a-mmU9nLd9akP2-tULq2RY0,719
 annofabcli/organization_member/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 annofabcli/organization_member/change_organization_member.py,sha256=DrRnVHTXRp5kE8ezgkXofuL0tgpvEPxwF8MowCDv27Q,4918
-annofabcli/organization_member/delete_organization_member.py,sha256=n_TI5oLUwWi3UzaffrtmwoVvsQhqh_KocxCPxAc3JXM,4304
-annofabcli/organization_member/invite_organization_member.py,sha256=LndGMPOSTn5nlnu_Gg8XUcXe4oG6-31jbPjv7Gz9h0k,4249
+annofabcli/organization_member/delete_organization_member.py,sha256=tHMHMxNUpM-wpGP7ycyMh5lmifKMD802FHEuCRMIQNo,5305
+annofabcli/organization_member/invite_organization_member.py,sha256=5sixK8WqUGl7DAOyIRxQ-uf106FYMHl4k7VtF1SatfQ,5177
 annofabcli/organization_member/list_organization_member.py,sha256=zaZECajTok6N_HJvH2xAwB62qMOJjaIwabTdTfTwMJY,3588
 annofabcli/organization_member/subcommand_organization_member.py,sha256=iK-Y4PxG5J8fu0Bnf8NBixv81BRXvr3BiVUyUb3ET7A,1289
 annofabcli/project/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -135,6 +135,7 @@ annofabcli/stat_visualization/write_performance_rating_csv.py,sha256=TDn7-poyFt2
 annofabcli/statistics/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 annofabcli/statistics/histogram.py,sha256=CvzDxT2cKLSnBGSqkZE6p92PayGxYYja1YyB24M4ALU,3245
 annofabcli/statistics/linegraph.py,sha256=0kr7jVBNMiM2ECYhv3Ry5RitElKerSl9ZKxbKzfiplI,12494
+annofabcli/statistics/list_annotation_area.py,sha256=1LFYqc1JodVuHKM2ceTwWriDCabMmkOnHiNptvEyXAw,12325
 annofabcli/statistics/list_annotation_attribute.py,sha256=87jjNCOXJUbWnmswMCLN7GTjGsBfqpFJ6hViWmnj8Y4,12557
 annofabcli/statistics/list_annotation_attribute_filled_count.py,sha256=vwWeFHwTnEMdrLBauIKPFDkUCa6lXXd0GQgUAQ0LCqU,28890
 annofabcli/statistics/list_annotation_count.py,sha256=nzmlHRCWt5mjeksZkeQyWqm4UaCa9SrdbNtuX9TPP5w,52907
@@ -142,7 +143,7 @@ annofabcli/statistics/list_annotation_duration.py,sha256=N7nnVUDfX_thIapqe6-z_Mq
 annofabcli/statistics/list_video_duration.py,sha256=uNeMteRBX2JG_AWmcgMJj0Jzbq_qF7bvAwr25GmeIiw,9124
 annofabcli/statistics/list_worktime.py,sha256=C7Yu3IOW2EvhkJJv6gY3hNdS9_TOLmT_9LZsB7vLJ1o,6493
 annofabcli/statistics/scatter.py,sha256=IUCwXix9GbZb6V82wjjb5q2eamrT5HQsU_bzDTjAFnM,11011
-annofabcli/statistics/subcommand_statistics.py,sha256=mx18Fgxz2eG4LrF-x0vISw2qh9aLommxuQLD8cfoZhw,2416
+annofabcli/statistics/subcommand_statistics.py,sha256=Pvd7s0vvDU9tSpAphPrv94IDhhR1p8iFH2tjdt7I7ZU,2536
 annofabcli/statistics/summarize_task_count.py,sha256=8OH6BBRYRjHJkWRTjU0A0OfXa7f3NIRHrxPNFlRt_hM,9707
 annofabcli/statistics/summarize_task_count_by_task_id_group.py,sha256=TSSmcFv615NLcq6uqXmg3ilYqSHl3A5qp90msVQM1gE,8646
 annofabcli/statistics/summarize_task_count_by_user.py,sha256=TRoJXpt2HOVb8QO2YtRejkOAxyK80_NsPt3Vk9es9C8,6948
@@ -206,8 +207,8 @@ annofabcli/task_history_event/download_task_history_event_json.py,sha256=hQLVbQ0
 annofabcli/task_history_event/list_all_task_history_event.py,sha256=JQEgwOIXbbTIfeX23AVaoySHViOR9UGm9uoXuhVEBqo,6446
 annofabcli/task_history_event/list_worktime.py,sha256=9jsRYa2C9bva8E1Aqxv9CCKDuCP0MvbiaIyQFTDpjqY,13150
 annofabcli/task_history_event/subcommand_task_history_event.py,sha256=mJVJoT4RXk4HWnY7-Nrsl4If-gtaIIEXd2z7eFZwM2I,1260
-annofabcli-1.101.0.dist-info/METADATA,sha256=zlNu7ev7fOJfYzE4Dx2Gs6B_tT2_kvIOwBBI10WAzyg,5286
-annofabcli-1.101.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-annofabcli-1.101.0.dist-info/entry_points.txt,sha256=C2uSUc-kkLJpoK_mDL5FEMAdorLEMPfwSf8VBMYnIFM,56
-annofabcli-1.101.0.dist-info/licenses/LICENSE,sha256=pcqWYfxFtxBzhvKp3x9MXNM4xciGb2eFewaRhXUNHlo,1081
-annofabcli-1.101.0.dist-info/RECORD,,
+annofabcli-1.102.1.dist-info/METADATA,sha256=dagbVH22HM5jYGQFjhCTeWBOGeFpZKnzfYMix15O8VU,5286
+annofabcli-1.102.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+annofabcli-1.102.1.dist-info/entry_points.txt,sha256=C2uSUc-kkLJpoK_mDL5FEMAdorLEMPfwSf8VBMYnIFM,56
+annofabcli-1.102.1.dist-info/licenses/LICENSE,sha256=pcqWYfxFtxBzhvKp3x9MXNM4xciGb2eFewaRhXUNHlo,1081
+annofabcli-1.102.1.dist-info/RECORD,,