ls: add --sort-by FIELDS option

src/con_duct/cli.py

@@ -456,6 +456,13 @@ def _create_ls_parser() -> argparse.ArgumentParser:
         action="store_true",
         help="List entries in reverse order (most recent first).",
     )
+    parser.add_argument(
+        "--sort-by",
+        nargs="+",
+        metavar="FIELD",
+        choices=LS_FIELD_CHOICES,
+        help=f"Sort results by one or more fields. Available choices: {', '.join(sorted(LS_FIELD_CHOICES))}.",
+    )
     return parser
 
 

src/con_duct/ls.py

@@ -231,6 +231,21 @@ def ls(args: argparse.Namespace) -> int:
     )
     info_files = [path for path in args.paths if is_info_file(path)]
     run_data_raw = load_duct_runs(info_files, args.eval_filter)
+
+    sort_by = getattr(args, "sort_by", None)
+    if sort_by:
+        flat_data = [_flatten_dict(d) for d in run_data_raw]
+        run_data_raw = [
+            item
+            for _, item in sorted(
+                zip(flat_data, run_data_raw),
+                key=lambda x: tuple(
+                    (x[0].get(k) is None, x[0].get(k) if x[0].get(k) is not None else "")
+                    for k in sort_by
+                ),
+            )
+        ]
+
     output_rows = process_run_data(run_data_raw, args.fields, formatter)
 
     if args.reverse:

test/test_ls.py

@@ -223,6 +223,7 @@ def _run_ls(
                 format=fmt,
                 func=ls,
                 reverse=False,
+                sort_by=None,
             )
         buf = StringIO()
         with contextlib.redirect_stdout(buf):
@@ -255,6 +256,7 @@ def test_ls_with_filter(self) -> None:
             format="summaries",
             func=ls,
             reverse=False,
+            sort_by=None,
         )
         result = self._run_ls(paths, "summaries", args)
 
@@ -383,9 +385,48 @@ def test_ls_reverse(self) -> None:
             format="json",
             func=ls,
             reverse=True,
+            sort_by=None,
         )
         result_reversed = self._run_ls(paths, "json", args)
         parsed_reversed = json.loads(result_reversed)
         prefixes_reversed = [row["prefix"] for row in parsed_reversed]
 
         assert prefixes_reversed == list(reversed(prefixes_normal))
+
+    def test_ls_sort_by(self) -> None:
+        """Test --sort-by flag sorts entries by the specified field."""
+        paths = ["file1_info.json", "file2_info.json"]
+
+        args = argparse.Namespace(
+            paths=[os.path.join(self.temp_dir.name, path) for path in paths],
+            colors=False,
+            fields=["prefix", "schema_version"],
+            eval_filter=None,
+            format="json",
+            func=ls,
+            reverse=False,
+            sort_by=["prefix"],
+        )
+        result = self._run_ls(paths, "json", args)
+        parsed = json.loads(result)
+        prefixes = [row["prefix"] for row in parsed]
+        assert prefixes == sorted(prefixes)
+
+    def test_ls_sort_by_reverse(self) -> None:
+        """Test --sort-by combined with --reverse gives descending order."""
+        paths = ["file1_info.json", "file2_info.json"]
+
+        args = argparse.Namespace(
+            paths=[os.path.join(self.temp_dir.name, path) for path in paths],
+            colors=False,
+            fields=["prefix", "schema_version"],
+            eval_filter=None,
+            format="json",
+            func=ls,
+            reverse=True,
+            sort_by=["prefix"],
+        )
+        result = self._run_ls(paths, "json", args)
+        parsed = json.loads(result)
+        prefixes = [row["prefix"] for row in parsed]
+        assert prefixes == sorted(prefixes, reverse=True)