annofabcli 1.113.0__tar.gz → 1.114.0__tar.gz

{annofabcli-1.113.0 → annofabcli-1.114.0}/PKG-INFO

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

{annofabcli-1.113.0 → annofabcli-1.114.0}/annofabcli/__main__.py

@@ -26,6 +26,7 @@ import annofabcli.stat_visualization.subcommand_stat_visualization
 import annofabcli.statistics.subcommand_statistics
 import annofabcli.supplementary.subcommand_supplementary
 import annofabcli.task.subcommand_task
+import annofabcli.task_count.subcommand_task_count
 import annofabcli.task_history.subcommand_task_history
 import annofabcli.task_history_event.subcommand_task_history_event
 
@@ -121,6 +122,7 @@ def create_parser() -> argparse.ArgumentParser:
     annofabcli.stat_visualization.subcommand_stat_visualization.add_parser(subparsers)
     annofabcli.supplementary.subcommand_supplementary.add_parser(subparsers)
     annofabcli.task.subcommand_task.add_parser(subparsers)
+    annofabcli.task_count.subcommand_task_count.add_parser(subparsers)
     annofabcli.task_history.subcommand_task_history.add_parser(subparsers)
     annofabcli.task_history_event.subcommand_task_history_event.add_parser(subparsers)
 

{annofabcli-1.113.0 → annofabcli-1.114.0}/annofabcli/annotation/dump_annotation.py

@@ -68,7 +68,7 @@ class DumpAnnotationMain:
         json_path = task_dir / f"{input_data_id}.json"
         self.dump_editor_annotation(editor_annotation=editor_annotation, json_path=json_path)
 
-    def dump_annotation_for_task(self, task_id: str, output_dir: Path, *, task_index: int | None = None, task_history_index: int | None = None) -> bool:
+    def dump_annotation_for_task(self, task_id: str, output_dir: Path, *, task_index: int | None = None, task_history_index: int | None = None, task_history_id: str | None = None) -> bool:
         """
         タスク配下のアノテーションをファイルに保存する。
 
@@ -85,23 +85,23 @@ class DumpAnnotationMain:
             logger.warning(f"task_id = '{task_id}' のタスクは存在しません。スキップします。")
             return False
 
-        task_history_id: str | None = None
+        actual_task_history_id: str | None = task_history_id
         if task_history_index is not None:
             task_histories, _ = self.service.api.get_task_histories(self.project_id, task_id)
             if task_history_index >= len(task_histories):
                 logger.warning(f"task_id='{task_id}' :: task_history_index='{task_history_index}'のタスク履歴は存在しません。タスク履歴は{len(task_histories)}件です。スキップします。")
                 return False
-            task_history_id = task_histories[task_history_index]["task_history_id"]
+            actual_task_history_id = task_histories[task_history_index]["task_history_id"]
 
         input_data_id_list = task["input_data_id_list"]
         task_dir = output_dir / task_id
         task_dir.mkdir(exist_ok=True, parents=True)
-        logger.debug(f"{logger_prefix}task_id = '{task_id}' のアノテーション情報を '{task_dir}' ディレクトリに保存します。 :: task_history_id='{task_history_id}'")
+        logger.debug(f"{logger_prefix}task_id = '{task_id}' のアノテーション情報を '{task_dir}' ディレクトリに保存します。 :: task_history_id='{actual_task_history_id}'")
 
         is_failure = False
         for input_data_id in input_data_id_list:
             try:
-                self.dump_annotation_for_input_data(task_id, input_data_id, task_dir=task_dir, task_history_id=task_history_id)
+                self.dump_annotation_for_input_data(task_id, input_data_id, task_dir=task_dir, task_history_id=actual_task_history_id)
             except Exception:
                 logger.warning(f"タスク'{task_id}', 入力データ'{input_data_id}' のアノテーション情報のダンプに失敗しました。", exc_info=True)
                 is_failure = True
@@ -109,15 +109,15 @@ class DumpAnnotationMain:
 
         return not is_failure
 
-    def dump_annotation_for_task_wrapper(self, tpl: tuple[int, str], output_dir: Path, *, task_history_index: int | None = None) -> bool:
+    def dump_annotation_for_task_wrapper(self, tpl: tuple[int, str], output_dir: Path, *, task_history_index: int | None = None, task_history_id: str | None = None) -> bool:
         task_index, task_id = tpl
         try:
-            return self.dump_annotation_for_task(task_id, output_dir=output_dir, task_index=task_index, task_history_index=task_history_index)
+            return self.dump_annotation_for_task(task_id, output_dir=output_dir, task_index=task_index, task_history_index=task_history_index, task_history_id=task_history_id)
         except Exception:  # pylint: disable=broad-except
             logger.warning(f"タスク'{task_id}'のアノテーション情報のダンプに失敗しました。", exc_info=True)
             return False
 
-    def dump_annotation(self, task_id_list: list[str], output_dir: Path, *, task_history_index: int | None = None, parallelism: int | None = None) -> None:
+    def dump_annotation(self, task_id_list: list[str], output_dir: Path, *, task_history_index: int | None = None, task_history_id: str | None = None, parallelism: int | None = None) -> None:
         project_title = self.facade.get_project_title(self.project_id)
         logger.info(f"プロジェクト'{project_title}'に対して、タスク{len(task_id_list)} 件のアノテーションをファイルに保存します。")
 
@@ -126,7 +126,7 @@ class DumpAnnotationMain:
         success_count = 0
 
         if parallelism is not None:
-            func = functools.partial(self.dump_annotation_for_task_wrapper, task_history_index=task_history_index, output_dir=output_dir)
+            func = functools.partial(self.dump_annotation_for_task_wrapper, task_history_index=task_history_index, task_history_id=task_history_id, output_dir=output_dir)
             with multiprocessing.Pool(parallelism) as pool:
                 result_bool_list = pool.map(func, enumerate(task_id_list))
                 success_count = len([e for e in result_bool_list if e])
@@ -134,7 +134,7 @@ class DumpAnnotationMain:
         else:
             for task_index, task_id in enumerate(task_id_list):
                 try:
-                    result = self.dump_annotation_for_task(task_id, output_dir=output_dir, task_history_index=task_history_index, task_index=task_index)
+                    result = self.dump_annotation_for_task(task_id, output_dir=output_dir, task_history_index=task_history_index, task_history_id=task_history_id, task_index=task_index)
                     if result:
                         success_count += 1
                 except Exception:
@@ -157,7 +157,7 @@ class DumpAnnotation(CommandLine):
         super().validate_project(project_id, project_member_roles=None)
 
         main_obj = DumpAnnotationMain(self.service, project_id)
-        main_obj.dump_annotation(task_id_list, output_dir=output_dir, parallelism=args.parallelism, task_history_index=args.task_history_index)
+        main_obj.dump_annotation(task_id_list, output_dir=output_dir, parallelism=args.parallelism, task_history_index=args.task_history_index, task_history_id=args.task_history_id)
 
 
 def main(args: argparse.Namespace) -> None:
@@ -174,12 +174,19 @@ def parse_args(parser: argparse.ArgumentParser) -> None:
 
     parser.add_argument("-o", "--output_dir", type=str, required=True, help="出力先ディレクトリのパス")
 
-    parser.add_argument(
+    task_history_group = parser.add_mutually_exclusive_group()
+    task_history_group.add_argument(
         "--task_history_index",
         type=int,
         help="指定したタスク履歴のインデックス（ゼロ始まり）で付与されたアノテーション情報をダンプします。過去のアノテーション結果をダンプする場合に指定します。"
         "ただし、過去のアノテーションデータは30日間しか保持されません。30日より前に更新されたアノテーションをダンプした場合は、アノテーションが0件の状態でダンプされます。",
     )
+    task_history_group.add_argument(
+        "--task_history_id",
+        type=str,
+        help="指定したタスク履歴IDで付与されたアノテーション情報をダンプします。過去のアノテーション結果をダンプする場合に指定します。"
+        "ただし、過去のアノテーションデータは30日間しか保持されません。30日より前に更新されたアノテーションをダンプした場合は、アノテーションが0件の状態でダンプされます。",
+    )
 
     parser.add_argument(
         "--parallelism",

{annofabcli-1.113.0 → annofabcli-1.114.0}/annofabcli/annotation_zip/list_annotation_3d_bounding_box.py

@@ -1,5 +1,6 @@
 import argparse
 import logging
+import math
 import sys
 import tempfile
 from collections.abc import Collection
@@ -65,6 +66,9 @@ class Annotation3DBoundingBoxInfo(DataClassJsonMixin):
     top_z: float
     """天面のZ座標（location.z + height/2）。回転は考慮していない。"""
 
+    horizontal_distance: float
+    """原点(0, 0)からのXY平面上の距離（sqrt(location.x² + location.y²)）"""
+
     attributes: dict[str, str | int | bool]
     """属性情報"""
 
@@ -96,6 +100,7 @@ def get_annotation_3d_bounding_box_info_list(simple_annotation: dict[str, Any],
         footprint_area = width * depth
         bottom_z = location.z - height / 2
         top_z = location.z + height / 2
+        horizontal_distance = math.hypot(location.x, location.y)
 
         result.append(
             Annotation3DBoundingBoxInfo(
@@ -116,6 +121,7 @@ def get_annotation_3d_bounding_box_info_list(simple_annotation: dict[str, Any],
                 footprint_area=footprint_area,
                 bottom_z=bottom_z,
                 top_z=top_z,
+                horizontal_distance=horizontal_distance,
                 attributes=detail["attributes"],
                 updated_datetime=simple_annotation["updated_datetime"],
             )
@@ -177,6 +183,7 @@ def create_df(
         "footprint_area",
         "bottom_z",
         "top_z",
+        "horizontal_distance",
     ]
 
     if len(tmp_annotation_bbox_list) == 0:

{annofabcli-1.113.0 → annofabcli-1.114.0}/annofabcli/comment/list_all_comment.py

@@ -39,21 +39,46 @@ class ListAllCommentMain:
         task_ids: Collection[str] | None,
         comment_type: CommentType | None,
         exclude_reply: bool,  # noqa: FBT001
+        temp_dir: Path | None,
     ) -> list[dict[str, Any]]:
         if comment_json is None:
             downloading_obj = DownloadingFile(self.service)
             # `NamedTemporaryFile`を使わない理由: Windowsで`PermissionError`が発生するため
             # https://qiita.com/yuji38kwmt/items/c6f50e1fc03dafdcdda0 参考
-            with tempfile.TemporaryDirectory() as str_temp_dir:
-                json_path = Path(str_temp_dir) / f"{project_id}__comment.json"
-                downloading_obj.download_comment_json(project_id, str(json_path))
-                with json_path.open(encoding="utf-8") as f:
-                    comment_list = json.load(f)
-
+            if temp_dir is not None:
+                json_path = downloading_obj.download_comment_json_to_dir(project_id, temp_dir)
+            else:
+                with tempfile.TemporaryDirectory() as str_temp_dir:
+                    json_path = downloading_obj.download_comment_json_to_dir(project_id, Path(str_temp_dir))
+                    with json_path.open(encoding="utf-8") as f:
+                        comment_list = json.load(f)
+                        # 一時ディレクトリの場合はここでフィルタリング処理まで行う
+                        if task_ids is not None:
+                            task_id_set = set(task_ids)
+                            comment_list = [e for e in comment_list if e["task_id"] in task_id_set]
+
+                        if comment_type is not None:
+                            comment_list = [e for e in comment_list if e["comment_type"] == comment_type.value]
+
+                        # 返信回数を算出する
+                        reply_counter = create_reply_counter(comment_list)
+                        for c in comment_list:
+                            key = (c["task_id"], c["input_data_id"], c["comment_id"])
+                            c["reply_count"] = reply_counter.get(key, 0)
+
+                        if exclude_reply:
+                            # 返信コメントを除外する
+                            comment_list = [e for e in comment_list if e["comment_node"]["_type"] != "Reply"]
+
+                        visualize = AddProps(self.service, project_id)
+                        comment_list = [visualize.add_properties_to_comment(e) for e in comment_list]
+
+                        return comment_list
         else:
             json_path = comment_json
-            with json_path.open(encoding="utf-8") as f:
-                comment_list = json.load(f)
+
+        with json_path.open(encoding="utf-8") as f:
+            comment_list = json.load(f)
 
         if task_ids is not None:
             task_id_set = set(task_ids)
@@ -86,6 +111,7 @@ class ListAllComment(CommandLine):
 
         task_id_list = annofabcli.common.cli.get_list_from_args(args.task_id) if args.task_id is not None else None
         comment_type = CommentType(args.comment_type) if args.comment_type is not None else None
+        temp_dir = Path(args.temp_dir) if args.temp_dir is not None else None
 
         main_obj = ListAllCommentMain(self.service)
         comment_list = main_obj.get_all_comment(
@@ -94,6 +120,7 @@ class ListAllComment(CommandLine):
             task_ids=task_id_list,
             comment_type=comment_type,
             exclude_reply=args.exclude_reply,
+            temp_dir=temp_dir,
         )
 
         logger.info(f"コメントの件数: {len(comment_list)}")
@@ -133,6 +160,12 @@ def parse_args(parser: argparse.ArgumentParser) -> None:
 
     parser.add_argument("--exclude_reply", action="store_true", help="返信コメントを除外します。")
 
+    parser.add_argument(
+        "--temp_dir",
+        type=str,
+        help="``--comment_json`` を指定しなかった場合、ダウンロードしたJSONファイルの保存先ディレクトリを指定できます。指定しない場合は、一時ディレクトリに保存されます。",
+    )
+
     argument_parser.add_format(
         choices=[
             FormatArgument.CSV,

{annofabcli-1.113.0 → annofabcli-1.114.0}/annofabcli/common/download.py

@@ -404,3 +404,72 @@ class DownloadingFile:
             wait_options=wait_options,
         )
         return dest_path
+
+    def download_task_history_json_to_dir(
+        self,
+        project_id: str,
+        output_dir: Path,
+    ) -> Path:
+        """
+        タスク履歴JSONをoutput_dirに統一された命名規則でダウンロードする。
+
+        Args:
+            project_id: プロジェクトID
+            output_dir: 出力ディレクトリ
+
+        Returns:
+            ダウンロードされたファイルのパス
+        """
+        dest_path = output_dir / get_filename(project_id, "task_history", "json")
+
+        self.download_task_history_json(
+            project_id,
+            dest_path=str(dest_path),
+        )
+        return dest_path
+
+    def download_task_history_event_json_to_dir(
+        self,
+        project_id: str,
+        output_dir: Path,
+    ) -> Path:
+        """
+        タスク履歴イベントJSONをoutput_dirに統一された命名規則でダウンロードする。
+
+        Args:
+            project_id: プロジェクトID
+            output_dir: 出力ディレクトリ
+
+        Returns:
+            ダウンロードされたファイルのパス
+        """
+        dest_path = output_dir / get_filename(project_id, "task_history_event", "json")
+
+        self.download_task_history_event_json(
+            project_id,
+            dest_path=str(dest_path),
+        )
+        return dest_path
+
+    def download_comment_json_to_dir(
+        self,
+        project_id: str,
+        output_dir: Path,
+    ) -> Path:
+        """
+        コメントJSONをoutput_dirに統一された命名規則でダウンロードする。
+
+        Args:
+            project_id: プロジェクトID
+            output_dir: 出力ディレクトリ
+
+        Returns:
+            ダウンロードされたファイルのパス
+        """
+        dest_path = output_dir / get_filename(project_id, "comment", "json")
+
+        self.download_comment_json(
+            project_id,
+            dest_path=str(dest_path),
+        )
+        return dest_path

{annofabcli-1.113.0 → annofabcli-1.114.0}/annofabcli/input_data/list_all_input_data.py

@@ -71,24 +71,39 @@ class ListInputDataWithJsonMain:
         contain_parent_task_id_list: bool = False,
         contain_supplementary_data_count: bool = False,
         is_latest: bool = False,
+        temp_dir: Path | None = None,
     ) -> list[dict[str, Any]]:
         if input_data_json is None:
             downloading_obj = DownloadingFile(self.service)
             # `NamedTemporaryFile`を使わない理由: Windowsで`PermissionError`が発生するため
             # https://qiita.com/yuji38kwmt/items/c6f50e1fc03dafdcdda0 参考
-            with tempfile.TemporaryDirectory() as str_temp_dir:
-                json_path = Path(str_temp_dir) / f"{project_id}__input_data.json"
-                downloading_obj.download_input_data_json(
-                    project_id,
-                    str(json_path),
-                    is_latest=is_latest,
-                )
-                with json_path.open(encoding="utf-8") as f:
-                    input_data_list = json.load(f)
+            if temp_dir is not None:
+                json_path = downloading_obj.download_input_data_json_to_dir(project_id, temp_dir, is_latest=is_latest)
+            else:
+                with tempfile.TemporaryDirectory() as str_temp_dir:
+                    json_path = downloading_obj.download_input_data_json_to_dir(project_id, Path(str_temp_dir), is_latest=is_latest)
+                    with json_path.open(encoding="utf-8") as f:
+                        input_data_list = json.load(f)
+                        # 一時ディレクトリの場合はここでフィルタリング処理まで行う
+                        input_data_id_set = set(input_data_id_list) if input_data_id_list is not None else None
+                        filtered_input_data_list = [e for e in input_data_list if self.filter_input_data_list(e, input_data_query=input_data_query, input_data_id_set=input_data_id_set)]
+
+                        adding_obj = AddingDetailsToInputData(self.service, project_id)
+                        if contain_parent_task_id_list:
+                            adding_obj.add_parent_task_id_list_to_input_data_list(input_data_list)
+
+                        if contain_supplementary_data_count:
+                            adding_obj.add_supplementary_data_count_to_input_data_list(input_data_list)
+
+                        # 入力データの不要なキーを削除する
+                        for input_data in input_data_list:
+                            remove_unnecessary_keys_from_input_data(input_data)
+                        return filtered_input_data_list
         else:
             json_path = input_data_json
-            with json_path.open(encoding="utf-8") as f:
-                input_data_list = json.load(f)
+
+        with json_path.open(encoding="utf-8") as f:
+            input_data_list = json.load(f)
 
         input_data_id_set = set(input_data_id_list) if input_data_id_list is not None else None
         filtered_input_data_list = [e for e in input_data_list if self.filter_input_data_list(e, input_data_query=input_data_query, input_data_id_set=input_data_id_set)]
@@ -117,6 +132,7 @@ class ListAllInputData(CommandLine):
         super().validate_project(project_id, project_member_roles=[ProjectMemberRole.TRAINING_DATA_USER, ProjectMemberRole.OWNER])
 
         main_obj = ListInputDataWithJsonMain(self.service)
+        temp_dir = Path(args.temp_dir) if args.temp_dir is not None else None
         input_data_list = main_obj.get_input_data_list(
             project_id=project_id,
             input_data_json=args.input_data_json,
@@ -125,6 +141,7 @@ class ListAllInputData(CommandLine):
             is_latest=args.latest,
             contain_parent_task_id_list=args.with_parent_task_id_list,
             contain_supplementary_data_count=args.with_supplementary_data_count,
+            temp_dir=temp_dir,
         )
 
         logger.debug(f"入力データ一覧の件数: {len(input_data_list)}")
@@ -195,6 +212,12 @@ def parse_args(parser: argparse.ArgumentParser) -> None:
 
     parser.add_argument("--with_supplementary_data_count", action="store_true", help="入力データに紐づく補助情報の個数( ``supplementary_data_count`` )も出力します。")
 
+    parser.add_argument(
+        "--temp_dir",
+        type=str,
+        help="``--input_data_json`` を指定しなかった場合、ダウンロードしたJSONファイルの保存先ディレクトリを指定できます。指定しない場合は、一時ディレクトリに保存されます。",
+    )
+
     argument_parser.add_format(
         choices=[
             FormatArgument.CSV,

{annofabcli-1.113.0 → annofabcli-1.114.0}/annofabcli/task/list_all_tasks.py

@@ -47,21 +47,34 @@ class ListTasksWithJsonMain:
         task_id_list: list[str] | None = None,
         task_query: TaskQuery | None = None,
         is_latest: bool = False,  # noqa: FBT001, FBT002
+        temp_dir: Path | None = None,
     ) -> list[dict[str, Any]]:
         if task_json is None:
             downloading_obj = DownloadingFile(self.service)
             # `NamedTemporaryFile`を使わない理由: Windowsで`PermissionError`が発生するため
             # https://qiita.com/yuji38kwmt/items/c6f50e1fc03dafdcdda0 参考
-            with tempfile.TemporaryDirectory() as str_temp_dir:
-                json_path = Path(str_temp_dir) / f"{project_id}__task.json"
-                downloading_obj.download_task_json(project_id, str(json_path), is_latest=is_latest)
-                with json_path.open(encoding="utf-8") as f:
-                    task_list = json.load(f)
-
+            if temp_dir is not None:
+                json_path = downloading_obj.download_task_json_to_dir(project_id, temp_dir, is_latest=is_latest)
+            else:
+                with tempfile.TemporaryDirectory() as str_temp_dir:
+                    json_path = downloading_obj.download_task_json_to_dir(project_id, Path(str_temp_dir), is_latest=is_latest)
+                    with json_path.open(encoding="utf-8") as f:
+                        task_list = json.load(f)
+                        # 一時ディレクトリの場合はここでフィルタリング処理まで行う
+                        if task_query is not None:
+                            task_query = self.facade.set_account_id_of_task_query(project_id, task_query)
+
+                        logger.debug("出力対象のタスクを抽出しています。")
+                        task_id_set = set(task_id_list) if task_id_list is not None else None
+                        filtered_task_list = [e for e in task_list if self.match_task_with_conditions(e, task_query=task_query, task_id_set=task_id_set)]
+
+                        visualize_obj = AddProps(self.service, project_id)
+                        return [visualize_obj.add_properties_to_task(e) for e in filtered_task_list]
         else:
             json_path = task_json
-            with json_path.open(encoding="utf-8") as f:
-                task_list = json.load(f)
+
+        with json_path.open(encoding="utf-8") as f:
+            task_list = json.load(f)
 
         if task_query is not None:
             task_query = self.facade.set_account_id_of_task_query(project_id, task_query)
@@ -85,12 +98,14 @@ class ListTasksWithJson(CommandLine):
         super().validate_project(project_id, project_member_roles=None)
 
         main_obj = ListTasksWithJsonMain(self.service)
+        temp_dir = Path(args.temp_dir) if args.temp_dir is not None else None
         task_list = main_obj.get_task_list(
             project_id=project_id,
             task_json=args.task_json,
             task_id_list=task_id_list,
             task_query=task_query,
             is_latest=args.latest,
+            temp_dir=temp_dir,
         )
 
         logger.debug(f"タスク一覧の件数: {len(task_list)}")
@@ -133,6 +148,12 @@ def parse_args(parser: argparse.ArgumentParser) -> None:
         "指定しない場合は、コマンドを実行した日の02:00(JST)頃のタスクの一覧が出力されます。",
     )
 
+    parser.add_argument(
+        "--temp_dir",
+        type=str,
+        help="``--task_json`` を指定しなかった場合、ダウンロードしたJSONファイルの保存先ディレクトリを指定できます。指定しない場合は、一時ディレクトリに保存されます。",
+    )
+
     argument_parser.add_format(
         choices=[FormatArgument.CSV, FormatArgument.JSON, FormatArgument.PRETTY_JSON, FormatArgument.TASK_ID_LIST],
         default=FormatArgument.CSV,

{annofabcli-1.113.0 → annofabcli-1.114.0}/annofabcli/task/list_all_tasks_added_task_history.py

@@ -60,31 +60,35 @@ class ListAllTasksAddedTaskHistoryMain:
 
         return task_list
 
-    def load_task_list(self, task_json_path: Path | None) -> list[dict[str, Any]]:
-        if task_json_path is not None:
-            with task_json_path.open(encoding="utf-8") as f:
-                return json.load(f)
-
-        # `NamedTemporaryFile`を使わない理由: Windowsで`PermissionError`が発生するため
-        # https://qiita.com/yuji38kwmt/items/c6f50e1fc03dafdcdda0 参考
-        with tempfile.TemporaryDirectory() as str_temp_dir:
-            task_json_path = Path(str_temp_dir) / f"{self.project_id}__task.json"
-            self.downloading_obj.download_task_json(self.project_id, str(task_json_path))
-            with task_json_path.open(encoding="utf-8") as f:
-                return json.load(f)
-
-    def load_task_history_dict(self, task_history_json_path: Path | None) -> TaskHistoryDict:
-        if task_history_json_path is not None:
-            with task_history_json_path.open(encoding="utf-8") as f:
-                return json.load(f)
-        else:
+    def load_task_list(self, task_json_path: Path | None, temp_dir: Path | None) -> list[dict[str, Any]]:
+        if task_json_path is None:
             # `NamedTemporaryFile`を使わない理由: Windowsで`PermissionError`が発生するため
             # https://qiita.com/yuji38kwmt/items/c6f50e1fc03dafdcdda0 参考
-            with tempfile.TemporaryDirectory() as str_temp_dir:
-                task_history_json_path = Path(str_temp_dir) / f"{self.project_id}__task_history.json"
-                self.downloading_obj.download_task_history_json(self.project_id, str(task_history_json_path))
-                with task_history_json_path.open(encoding="utf-8") as f:
-                    return json.load(f)
+            if temp_dir is not None:
+                task_json_path = self.downloading_obj.download_task_json_to_dir(self.project_id, temp_dir)
+            else:
+                with tempfile.TemporaryDirectory() as str_temp_dir:
+                    task_json_path = self.downloading_obj.download_task_json_to_dir(self.project_id, Path(str_temp_dir))
+                    with task_json_path.open(encoding="utf-8") as f:
+                        return json.load(f)
+
+        with task_json_path.open(encoding="utf-8") as f:
+            return json.load(f)
+
+    def load_task_history_dict(self, task_history_json_path: Path | None, temp_dir: Path | None) -> TaskHistoryDict:
+        if task_history_json_path is None:
+            # `NamedTemporaryFile`を使わない理由: Windowsで`PermissionError`が発生するため
+            # https://qiita.com/yuji38kwmt/items/c6f50e1fc03dafdcdda0 参考
+            if temp_dir is not None:
+                task_history_json_path = self.downloading_obj.download_task_history_json_to_dir(self.project_id, temp_dir)
+            else:
+                with tempfile.TemporaryDirectory() as str_temp_dir:
+                    task_history_json_path = self.downloading_obj.download_task_history_json_to_dir(self.project_id, Path(str_temp_dir))
+                    with task_history_json_path.open(encoding="utf-8") as f:
+                        return json.load(f)
+
+        with task_history_json_path.open(encoding="utf-8") as f:
+            return json.load(f)
 
     @staticmethod
     def match_task_with_conditions(
@@ -120,12 +124,13 @@ class ListAllTasksAddedTaskHistoryMain:
         task_history_json_path: Path | None,
         task_id_list: list[str] | None,
         task_query: TaskQuery | None,
+        temp_dir: Path | None,
     ):
         """
         タスク履歴情報を加えたタスク一覧を取得する。
         """
-        task_list = self.load_task_list(task_json_path)
-        task_history_dict = self.load_task_history_dict(task_history_json_path)
+        task_list = self.load_task_list(task_json_path, temp_dir)
+        task_history_dict = self.load_task_history_dict(task_history_json_path, temp_dir)
 
         filtered_task_list = self.filter_task_list(task_list, task_id_list=task_id_list, task_query=task_query)
 
@@ -163,11 +168,13 @@ class ListAllTasksAddedTaskHistory(CommandLine):
 
         self.validate_project(project_id, [ProjectMemberRole.OWNER, ProjectMemberRole.TRAINING_DATA_USER])
 
+        temp_dir = Path(args.temp_dir) if args.temp_dir is not None else None
         task_list = ListAllTasksAddedTaskHistoryMain(self.service, project_id).get_task_list_added_task_history(
             task_json_path=args.task_json,
             task_history_json_path=args.task_history_json,
             task_id_list=task_id_list,
             task_query=task_query,
+            temp_dir=temp_dir,
         )
 
         logger.info(f"タスク一覧の件数: {len(task_list)}")
@@ -200,6 +207,12 @@ def parse_args(parser: argparse.ArgumentParser) -> None:
         "JSONファイルは ``$ annofabcli task_history download`` コマンドで取得できます。",
     )
 
+    parser.add_argument(
+        "--temp_dir",
+        type=str,
+        help="``--task_json`` と ``--task_history_json`` を指定しなかった場合、ダウンロードしたJSONファイルの保存先ディレクトリを指定できます。指定しない場合は、一時ディレクトリに保存されます。",
+    )
+
     argument_parser.add_output()
 
     argument_parser.add_format(