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

@@ -15,7 +15,15 @@ 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)
+
+    folder_listing_enabled = (
+        fab_state_config.get_config(fab_constant.FAB_FOLDER_LISTING_ENABLED) == "true"
+    )
+
+    if folder_listing_enabled:
+        sorted_elements_dict = utils_fs.sort_ws_elements_with_divider(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 +33,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,
     )

src/fabric_cli/utils/fab_cmd_fs_utils.py

@@ -90,3 +90,27 @@ def sort_ws_elements(ws_elements: list[Union[Item, Folder]], show_details):
         {key: getattr(item, key) for key in columns if hasattr(item, key)}
         for item in sorted_elements
     ]
+
+
+def sort_ws_elements_with_divider(
+    ws_elements: list[Union[Item, Folder]], show_details: bool
+) -> list[dict]:
+    """Sort workspace elements: folders first, divider, then items."""
+    if not ws_elements:
+        return []
+
+    folders = [el for el in ws_elements if isinstance(el, Folder)]
+    items = [el for el in ws_elements if isinstance(el, Item)]
+    columns = ["name", "id"] if show_details else ["name"]
+
+    result = []
+    has_both = bool(folders and items)
+    if folders:
+        if has_both:
+            result.append({key: ("[Folders]" if key == "name" else "") for key in columns})
+        result.extend(sort_ws_elements(folders, show_details))
+    if items:
+        if has_both:
+            result.append({key: ("[Items]" if key == "name" else "") for key in columns})
+        result.extend(sort_ws_elements(items, show_details))
+    return result

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

@@ -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:
-      - Wed, 11 Feb 2026 12:01:42 GMT
+      - Thu, 05 Feb 2026 13:48:02 GMT
       Pragma:
       - no-cache
       RequestId:
-      - 523bf25d-7c17-488c-abf7-cb5143f4dcca
+      - af55f273-fdb0-41c9-bf85-607803366fb5
       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": "8345c10e-7b97-44ce-8111-806b95aad368", "displayName": "fabriccli_WorkspacePerTestclass_000001",
+      string: '{"id": "ebe5f85c-0343-4508-9d2d-a8299cfea504", "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:
-      - '190'
+      - '187'
       Content-Type:
       - application/json; charset=utf-8
       Date:
-      - Wed, 11 Feb 2026 12:01:51 GMT
+      - Thu, 05 Feb 2026 13:48:09 GMT
       Location:
-      - https://api.fabric.microsoft.com/v1/workspaces/8345c10e-7b97-44ce-8111-806b95aad368
+      - https://api.fabric.microsoft.com/v1/workspaces/ebe5f85c-0343-4508-9d2d-a8299cfea504
       Pragma:
       - no-cache
       RequestId:
-      - 02e2ce7e-93b5-4e49-b0e0-a0b5b9705974
+      - 831b42b8-59e6-45bf-96b0-7985c7063e11
       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": "8345c10e-7b97-44ce-8111-806b95aad368",
+        "My workspace", "description": "", "type": "Personal"}, {"id": "ebe5f85c-0343-4508-9d2d-a8299cfea504",
         "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:
-      - '2937'
+      - '2901'
       Content-Type:
       - application/json; charset=utf-8
       Date:
-      - Wed, 11 Feb 2026 12:05:04 GMT
+      - Thu, 05 Feb 2026 13:48:51 GMT
       Pragma:
       - no-cache
       RequestId:
-      - 020a5b97-907a-43e0-a88b-9ddd69410743
+      - c3f8f00d-5ab2-48c3-813c-b155b598a7d0
       Strict-Transport-Security:
       - max-age=31536000; includeSubDomains
       X-Content-Type-Options:
@@ -266,108 +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/8345c10e-7b97-44ce-8111-806b95aad368/items
-  response:
-    body:
-      string: '{"value": [{"id": "b51a7eb5-9481-425a-8037-d6723709f8d4", "type": "SQLEndpoint",
-        "displayName": "fabcli000002dtdm", "description": "", "workspaceId": "8345c10e-7b97-44ce-8111-806b95aad368",
-        "folderId": "dae78c10-fe9c-4e10-a115-1845eb5b6ef9"}, {"id": "13372126-888e-466b-a7b9-8b635c6f8333",
-        "type": "Lakehouse", "displayName": "fabcli000002dtdm", "description": "",
-        "workspaceId": "8345c10e-7b97-44ce-8111-806b95aad368", "folderId": "dae78c10-fe9c-4e10-a115-1845eb5b6ef9"}]}'
-    headers:
-      Access-Control-Expose-Headers:
-      - RequestId
-      Cache-Control:
-      - no-store, must-revalidate, no-cache
-      Content-Encoding:
-      - gzip
-      Content-Length:
-      - '247'
-      Content-Type:
-      - application/json; charset=utf-8
-      Date:
-      - Wed, 11 Feb 2026 12:05:05 GMT
-      Pragma:
-      - no-cache
-      RequestId:
-      - f9198688-df06-40f1-b2f1-83785cc3e9fd
-      Strict-Transport-Security:
-      - max-age=31536000; includeSubDomains
-      X-Content-Type-Options:
-      - nosniff
-      X-Frame-Options:
-      - deny
-      home-cluster-uri:
-      - https://wabi-us-central-b-primary-redirect.analysis.windows.net/
-      request-redirected:
-      - 'true'
-    status:
-      code: 200
-      message: OK
-- request:
-    body: null
-    headers:
-      Accept:
-      - '*/*'
-      Accept-Encoding:
-      - gzip, deflate
-      Connection:
-      - keep-alive
-      Content-Type:
-      - application/json
-      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/8345c10e-7b97-44ce-8111-806b95aad368/folders?recursive=True
-  response:
-    body:
-      string: '{"value": [{"id": "dae78c10-fe9c-4e10-a115-1845eb5b6ef9", "displayName":
-        "fabcli000001", "workspaceId": "8345c10e-7b97-44ce-8111-806b95aad368"}]}'
-    headers:
-      Access-Control-Expose-Headers:
-      - RequestId
-      Cache-Control:
-      - no-store, must-revalidate, no-cache
-      Content-Encoding:
-      - gzip
-      Content-Length:
-      - '143'
-      Content-Type:
-      - application/json; charset=utf-8
-      Date:
-      - Wed, 11 Feb 2026 12:05:06 GMT
-      Pragma:
-      - no-cache
-      RequestId:
-      - 13c26542-f28d-43eb-a690-d66c8693a81c
-      Strict-Transport-Security:
-      - max-age=31536000; includeSubDomains
-      X-Content-Type-Options:
-      - nosniff
-      X-Frame-Options:
-      - deny
-      home-cluster-uri:
-      - https://wabi-us-central-b-primary-redirect.analysis.windows.net/
-      request-redirected:
-      - 'true'
-    status:
-      code: 200
-      message: OK
-- request:
-    body: null
-    headers:
-      Accept:
-      - '*/*'
-      Accept-Encoding:
-      - gzip, deflate
-      Connection:
-      - keep-alive
-      Content-Type:
-      - application/json
-      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/8345c10e-7b97-44ce-8111-806b95aad368/folders?recursive=True
+    uri: https://api.fabric.microsoft.com/v1/workspaces/ebe5f85c-0343-4508-9d2d-a8299cfea504/items
   response:
     body:
       string: '{"value": [{"id": "dae78c10-fe9c-4e10-a115-1845eb5b6ef9", "displayName":
@@ -384,11 +283,11 @@ interactions:
       Content-Type:
       - application/json; charset=utf-8
       Date:
-      - Wed, 11 Feb 2026 12:05:06 GMT
+      - Thu, 05 Feb 2026 13:48:51 GMT
       Pragma:
       - no-cache
       RequestId:
-      - 9a08c101-6530-48a9-af1c-c0498ca10eb0
+      - c4c73c19-cae6-4865-b3b9-86e803fdf296
       Strict-Transport-Security:
       - max-age=31536000; includeSubDomains
       X-Content-Type-Options:
@@ -418,7 +317,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/8345c10e-7b97-44ce-8111-806b95aad368
+    uri: https://api.fabric.microsoft.com/v1/workspaces/ebe5f85c-0343-4508-9d2d-a8299cfea504
   response:
     body:
       string: ''
@@ -434,11 +333,11 @@ interactions:
       Content-Type:
       - application/octet-stream
       Date:
-      - Wed, 11 Feb 2026 12:05:08 GMT
+      - Thu, 05 Feb 2026 13:48:51 GMT
       Pragma:
       - no-cache
       RequestId:
-      - 4d32ff8d-8b20-43ef-9974-7c3a91fcc908
+      - 7af2a487-ebea-4831-a586-ab5259143e49
       Strict-Transport-Security:
       - max-age=31536000; includeSubDomains
       X-Content-Type-Options: