style: add visual divider between folders and items in workspace listing

.changes/unreleased/optimization-20260203-163440.yaml

@@ -0,0 +1,6 @@
+kind: optimization
+body: Add visual divider between folders and items in `ls` command on workspaces with text output format
+time: 2026-02-03T16:34:40.477661885Z
+custom:
+    Author: ayeshurun
+    AuthorLink: https://github.com/ayeshurun

src/fabric_cli/commands/fs/ls/fab_fs_ls_item.py

@@ -10,12 +10,68 @@
 from fabric_cli.utils import fab_cmd_fs_utils as utils_fs
 from fabric_cli.utils import fab_cmd_ls_utils as utils_ls
 
+# Divider used to separate folders and items in workspace listings
+_DIVIDER = "------------------------------"
+
+
+def _sort_ws_elements_with_seperation(
+    ws_elements: list[Union[Item, Folder]], show_details: bool
+) -> list[dict]:
+    """
+    Groups elements by type (Folders first, then Items), sorts each group using sort_ws_elements,
+    and inserts a divider between non-empty groups.
+
+    Args:
+        ws_elements: List of workspace elements (Items and Folders)
+        show_details: Whether to include detailed columns
+
+    Returns:
+        list: Single list with folders first, divider, then items
+    """
+    if not ws_elements:
+        return []
+
+    result = []
+    first_group = True
+    type_order = [Folder, Item]
+
+    for typ in type_order:
+        group = [el for el in ws_elements if isinstance(el, typ)]
+        if group:
+            group_dicts = utils_fs.sort_ws_elements(group, show_details)
+            if not first_group:
+                divider = {"name": _DIVIDER}
+                if show_details:
+                    divider["id"] = ""
+                result.append(divider)
+            result.extend(group_dicts)
+            first_group = False
+
+    return result
+
 
 def exec(workspace: Workspace, args):
     show_details = bool(args.long)
     show_all = bool(args.all)
     ws_elements: list[Union[Item, Folder]] = utils_fs.get_ws_elements(workspace)
-    sorted_elements_dict = utils_fs.sort_ws_elements(ws_elements, show_details)
+
+    # Check if folder listing is enabled
+    folder_listing_enabled = (
+        fab_state_config.get_config(fab_constant.FAB_FOLDER_LISTING_ENABLED) == "true"
+    )
+
+    # Get output format from args or config
+    output_format = getattr(args, "output_format", None) or fab_state_config.get_config(
+        fab_constant.FAB_OUTPUT_FORMAT
+    )
+
+    # Use separation if folder listing is enabled, output is text format, and --long is not provided
+    if folder_listing_enabled and output_format == "text" and not show_details:
+        sorted_elements_dict = _sort_ws_elements_with_seperation(
+            ws_elements, show_details
+        )
+    else:
+        sorted_elements_dict = utils_fs.sort_ws_elements(ws_elements, show_details)
 
     show_hidden = (
         show_all or fab_state_config.get_config(fab_constant.FAB_SHOW_HIDDEN) == "true"
@@ -25,6 +81,6 @@ def exec(workspace: Workspace, args):
         data=sorted_elements_dict,
         args=args,
         show_details=show_details,
-        columns=sorted_elements_dict[0].keys() if sorted_elements_dict else [],
+        columns=list(sorted_elements_dict[0].keys()) if sorted_elements_dict else [],
         hidden_data=VirtualItemContainerType if show_hidden else None,
     )

tests/test_commands/recordings/test_commands/test_ls/class_setup.yaml

@@ -26,15 +26,15 @@ interactions:
       Content-Encoding:
       - gzip
       Content-Length:
-      - '2834'
+      - '1517'
       Content-Type:
       - application/json; charset=utf-8
       Date:
-      - Thu, 05 Feb 2026 13:47:58 GMT
+      - Sun, 16 Nov 2025 13:28:59 GMT
       Pragma:
       - no-cache
       RequestId:
-      - 2008fda1-a5a1-4dc4-a215-75cd81a5aa58
+      - a1ca655d-adf4-4a7a-8d2c-2dc3ab03e53b
       Strict-Transport-Security:
       - max-age=31536000; includeSubDomains
       X-Content-Type-Options:
@@ -75,15 +75,15 @@ interactions:
       Content-Encoding:
       - gzip
       Content-Length:
-      - '2834'
+      - '1517'
       Content-Type:
       - application/json; charset=utf-8
       Date:
-      - Thu, 05 Feb 2026 13:47:58 GMT
+      - Sun, 16 Nov 2025 13:29:00 GMT
       Pragma:
       - no-cache
       RequestId:
-      - 1d8c3a58-af0b-4078-a948-12b40a0292bb
+      - 4fb405d9-466a-4e9d-81f3-a61091331c8a
       Strict-Transport-Security:
       - max-age=31536000; includeSubDomains
       X-Content-Type-Options:
@@ -115,7 +115,7 @@ interactions:
   response:
     body:
       string: '{"value": [{"id": "00000000-0000-0000-0000-000000000004", "displayName":
-        "mocked_fabriccli_capacity_name", "sku": "F16", "region": "Central US", "state":
+        "mocked_fabriccli_capacity_name", "sku": "F2", "region": "Central US", "state":
         "Active"}]}'
     headers:
       Access-Control-Expose-Headers:
@@ -129,11 +129,11 @@ interactions:
       Content-Type:
       - application/json; charset=utf-8
       Date:
-      - Thu, 05 Feb 2026 13:48:02 GMT
+      - Sun, 16 Nov 2025 13:29:05 GMT
       Pragma:
       - no-cache
       RequestId:
-      - af55f273-fdb0-41c9-bf85-607803366fb5
+      - 9a962d92-07ed-4680-97dc-c07909f25e22
       Strict-Transport-Security:
       - max-age=31536000; includeSubDomains
       X-Content-Type-Options:
@@ -167,7 +167,7 @@ interactions:
     uri: https://api.fabric.microsoft.com/v1/workspaces
   response:
     body:
-      string: '{"id": "ebe5f85c-0343-4508-9d2d-a8299cfea504", "displayName": "fabriccli_WorkspacePerTestclass_000001",
+      string: '{"id": "7b82ecee-ed54-4d87-84dd-07511c5f5ad2", "displayName": "fabriccli_WorkspacePerTestclass_000001",
         "description": "Created by fab", "type": "Workspace", "capacityId": "00000000-0000-0000-0000-000000000004"}'
     headers:
       Access-Control-Expose-Headers:
@@ -177,17 +177,17 @@ interactions:
       Content-Encoding:
       - gzip
       Content-Length:
-      - '187'
+      - '189'
       Content-Type:
       - application/json; charset=utf-8
       Date:
-      - Thu, 05 Feb 2026 13:48:09 GMT
+      - Sun, 16 Nov 2025 13:29:14 GMT
       Location:
-      - https://api.fabric.microsoft.com/v1/workspaces/ebe5f85c-0343-4508-9d2d-a8299cfea504
+      - https://api.fabric.microsoft.com/v1/workspaces/7b82ecee-ed54-4d87-84dd-07511c5f5ad2
       Pragma:
       - no-cache
       RequestId:
-      - 831b42b8-59e6-45bf-96b0-7985c7063e11
+      - a9920ffb-8339-43a8-8f5b-ab313cafb507
       Strict-Transport-Security:
       - max-age=31536000; includeSubDomains
       X-Content-Type-Options:
@@ -219,7 +219,7 @@ interactions:
   response:
     body:
       string: '{"value": [{"id": "3634a139-2c9e-4205-910b-3b089a31be47", "displayName":
-        "My workspace", "description": "", "type": "Personal"}, {"id": "ebe5f85c-0343-4508-9d2d-a8299cfea504",
+        "My workspace", "description": "", "type": "Personal"}, {"id": "7b82ecee-ed54-4d87-84dd-07511c5f5ad2",
         "displayName": "fabriccli_WorkspacePerTestclass_000001", "description": "Created
         by fab", "type": "Workspace", "capacityId": "00000000-0000-0000-0000-000000000004"}]}'
     headers:
@@ -230,15 +230,15 @@ interactions:
       Content-Encoding:
       - gzip
       Content-Length:
-      - '2901'
+      - '1551'
       Content-Type:
       - application/json; charset=utf-8
       Date:
-      - Thu, 05 Feb 2026 13:48:51 GMT
+      - Sun, 16 Nov 2025 13:29:43 GMT
       Pragma:
       - no-cache
       RequestId:
-      - c3f8f00d-5ab2-48c3-813c-b155b598a7d0
+      - 760e6315-8597-44fc-807f-62840e999e08
       Strict-Transport-Security:
       - max-age=31536000; includeSubDomains
       X-Content-Type-Options:
@@ -266,7 +266,7 @@ interactions:
       User-Agent:
       - ms-fabric-cli/1.3.1 (ls; Linux; x86_64; 6.6.87.2-microsoft-standard-WSL2)
     method: GET
-    uri: https://api.fabric.microsoft.com/v1/workspaces/ebe5f85c-0343-4508-9d2d-a8299cfea504/items
+    uri: https://api.fabric.microsoft.com/v1/workspaces/7b82ecee-ed54-4d87-84dd-07511c5f5ad2/items
   response:
     body:
       string: '{"value": []}'
@@ -282,11 +282,11 @@ interactions:
       Content-Type:
       - application/json; charset=utf-8
       Date:
-      - Thu, 05 Feb 2026 13:48:51 GMT
+      - Sun, 16 Nov 2025 13:29:44 GMT
       Pragma:
       - no-cache
       RequestId:
-      - c4c73c19-cae6-4865-b3b9-86e803fdf296
+      - 8f711d74-2ab1-4d92-9c00-f90f31843fe1
       Strict-Transport-Security:
       - max-age=31536000; includeSubDomains
       X-Content-Type-Options:
@@ -316,7 +316,7 @@ interactions:
       User-Agent:
       - ms-fabric-cli/1.3.1 (ls; Linux; x86_64; 6.6.87.2-microsoft-standard-WSL2)
     method: DELETE
-    uri: https://api.fabric.microsoft.com/v1/workspaces/ebe5f85c-0343-4508-9d2d-a8299cfea504
+    uri: https://api.fabric.microsoft.com/v1/workspaces/7b82ecee-ed54-4d87-84dd-07511c5f5ad2
   response:
     body:
       string: ''
@@ -332,11 +332,11 @@ interactions:
       Content-Type:
       - application/octet-stream
       Date:
-      - Thu, 05 Feb 2026 13:48:51 GMT
+      - Sun, 16 Nov 2025 13:29:45 GMT
       Pragma:
       - no-cache
       RequestId:
-      - 7af2a487-ebea-4831-a586-ab5259143e49
+      - 87dce47d-17c3-48d7-8046-89b2600e75b1
       Strict-Transport-Security:
       - max-age=31536000; includeSubDomains
       X-Content-Type-Options: