feat: Add query parameter support to ls and acl ls commands

docs/commands/acls/index.md

@@ -28,20 +28,23 @@ List access control entries for a workspace, item, or OneLake resource.
 **Usage:**
 
 ```
-fab acl ls <path> [-l]
+fab acl ls <path> [-l] [-q <fields>]
 ```
 
 **Parameters:**
 
 - `<path>`: Path to the resource.
 - `-l, --long`: Show detailed output. Optional.
+- `-q, --query`: Space-separated list of fields to display (e.g., 'identity role'). Shows only specified fields. Optional.
 
 **Examples:**
 
 ```
 fab acl ls workspace1.workspace
 fab acl ls lh1.lakehouse -l
 fab acl ls /Files/data -l
+fab acl ls workspace1.workspace -q identity          # Show only identity column
+fab acl ls workspace1.workspace -q "identity name"   # Show identity and name columns
 ```
 
 ---

docs/examples/acl_examples.md

@@ -38,6 +38,10 @@ fab acl ls ws1.Workspace
 
 # List detailed workspace permissions
 fab acl ls ws1.Workspace -l
+
+# List specific columns using query parameter
+fab acl ls ws1.Workspace -q identity           # Show only identity column
+fab acl ls ws1.Workspace -q "identity name"    # Show identity and name columns
 ```
 
 #### List Item Permissions
@@ -47,6 +51,10 @@ fab acl ls ws1.Workspace/lh1.Lakehouse
 
 # List detailed item permissions
 fab acl ls ws1.Workspace/lh1.Lakehouse -l
+
+# List specific columns for item permissions
+fab acl ls ws1.Workspace/lh1.Lakehouse -q type     # Show only type column
+fab acl ls ws1.Workspace/lh1.Lakehouse -q "type role"   # Show type and role columns
 ```
 
 #### List OneLake RBAC Permissions

src/fabric_cli/commands/acls/fab_acls_ls.py

@@ -81,6 +81,8 @@ def _ls_acls_workspace(workspace: Workspace, args: Namespace) -> None:
                     }
                 )
             sorted_acls = sorted(sorted_acls, key=lambda acl: acl["acl"])
+            columns = ["acl", "identity", "type"]
+
             columns = (
                 ["acl", "identity", "type", "objectId", "name"]
                 if show_all
@@ -132,11 +134,11 @@ def _ls_acls_gateway(gateway: VirtualWorkspaceItem, args: Namespace) -> None:
                 )
 
             sorted_acls = sorted(sorted_acls, key=lambda acl: acl["role"])
-            columns = (
-                ["id", "role", "principalId", "principalType"]
-                if show_all
-                else ["role", "principalId", "principalType"]
-            )
+
+            columns = ["role", "principalId", "principalType"]
+            if show_all:
+                columns.insert(0, "id")
+
             utils_ls.format_and_print_output(
                 data=sorted_acls,
                 columns=columns,
@@ -169,11 +171,10 @@ def _ls_acls_connection(connection: VirtualWorkspaceItem, args: Namespace) -> No
                 )
 
             sorted_acls = sorted(sorted_acls, key=lambda acl: acl["role"])
-            columns = (
-                ["id", "role", "principalId", "principalType"]
-                if show_all
-                else ["role", "principalId", "principalType"]
-            )
+
+            columns = ["role", "principalId", "principalType"]
+            if show_all:
+                columns.insert(0, "id")
 
             utils_ls.format_and_print_output(
                 data=sorted_acls,
@@ -221,11 +222,11 @@ def _ls_acls_item(item: Item, args: Namespace) -> None:
                 )
 
             sorted_acls = sorted(sorted_acls, key=lambda acl: acl["acl"])
-            columns = (
-                ["acl", "identity", "type", "id", "name"]
-                if show_all
-                else ["acl", "identity", "type"]
-            )
+
+            columns = ["acl", "identity", "type"]
+            if show_all:
+                columns.extend(["id", "name"])
+
             utils_ls.format_and_print_output(
                 data=sorted_acls,
                 columns=columns,
@@ -292,11 +293,10 @@ def _ls_acls_onelake(context: OneLakeItem, args: Namespace) -> None:
                     )
 
             sorted_acls = sorted(sorted_acls, key=lambda acl: acl["acl"])
-            columns = (
-                ["acl", "identity", "type", "details"]
-                if show_all
-                else ["acl", "identity", "type"]
-            )
+            columns = ["acl", "identity", "type"]
+            if show_all:
+                columns.extend(["id", "name"])
+
             utils_ls.format_and_print_output(
                 data=sorted_acls,
                 columns=columns,

src/fabric_cli/commands/fs/fab_fs_ls.py

@@ -32,6 +32,7 @@
 
 
 def exec_command(args, context: FabricElement):
+    args.long = bool(args.long) if args.long else (args.query is not None and bool(len(args.query) > 1))
     if isinstance(context, Tenant):
         ls_workspace.exec(context, args)
     elif isinstance(context, VirtualWorkspace):

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

@@ -8,7 +8,7 @@
 from fabric_cli.core.hiearchy.fab_folder import Folder
 from fabric_cli.core.hiearchy.fab_hiearchy import Item, Workspace
 from fabric_cli.utils import fab_cmd_fs_utils as utils_fs
-from fabric_cli.utils import fab_ui as utils_ui
+from fabric_cli.utils import fab_cmd_ls_utils as utils_ls
 
 
 def exec(workspace: Workspace, args):
@@ -21,9 +21,10 @@ def exec(workspace: Workspace, args):
         show_all or fab_state_config.get_config(fab_constant.FAB_SHOW_HIDDEN) == "true"
     )
 
-    utils_ui.print_output_format(
+    utils_ls.format_and_print_output(
+        sorted_elements_dict,
         args,
-        data=sorted_elements_dict,
-        hidden_data=VirtualItemContainerType if show_hidden else None,
-        show_headers=show_details,
+        show_details,
+        sorted_elements_dict[0].keys() if sorted_elements_dict else [],
+        VirtualItemContainerType if show_hidden else None,
     )

src/fabric_cli/core/fab_constant.py

@@ -256,6 +256,7 @@
 ERROR_INVALID_PATH = "InvalidPath"
 ERROR_INVALID_PROPERTY = "InvalidProperty"
 ERROR_INVALID_DETLA_TABLE = "InvalidDeltaTable"
+ERROR_INVALID_QUERY_FIELDS = "InvalidQueryFields"
 ERROR_INVALID_WORKSPACE_TYPE = "InvalidWorkspaceType"
 ERROR_INTERNAL_SERVER_ERROR = "InternalServerError"
 ERROR_UNSUPPORTED_ITEM_TYPE = "UnsupportedItemType"

src/fabric_cli/errors/common.py

@@ -11,6 +11,10 @@ class CommonErrors:
     def invalid_jmespath_query() -> str:
         return f"Invalid jmespath query (https://jmespath.org)"
 
+    @staticmethod
+    def invalid_parameter(invalid_fields: list, valid_columns: list) -> str:
+        return f"Invalid query field(s): {', '.join(invalid_fields)}. Available fields: {', '.join(valid_columns)}"
+
     @staticmethod
     def invalid_hostname(hostname: str) -> str:
         return f"Invalid hostname for '{hostname}'"

src/fabric_cli/parsers/fab_acls_parser.py

@@ -51,6 +51,14 @@ def register_parser(subparsers: _SubParsersAction) -> None:
         action="store_true",
         help="Show detailed output. Optional",
     )
+    ls_parser.add_argument(
+        "-q",
+        "--query",
+        metavar="",
+        nargs="+",
+        required=False,
+        help="Query to filter results. Optional",
+    )
 
     ls_parser.usage = f"{utils_error_parser.get_usage_prog(ls_parser)}"
     ls_parser.set_defaults(func=acls.ls_command)

src/fabric_cli/parsers/fab_fs_parser.py

@@ -15,7 +15,9 @@ def register_ls_parser(subparsers: _SubParsersAction) -> None:
         "# list all workspaces with details",
         "$ ls -l\n",
         "# list lakehouse tables",
-        "$ ls ws1.Workspace/lh1.Lakehouse/Tables",
+        "$ ls ws1.Workspace/lh1.Lakehouse/Tables\n",
+        "# list items with name matching a pattern",
+        "$ ls -q \"contains(name, 'report')\"",
     ]
 
     ls_parser = subparsers.add_parser(
@@ -43,6 +45,14 @@ def register_ls_parser(subparsers: _SubParsersAction) -> None:
         action="store_true",
         help="Show all. Optional",
     )
+    ls_parser.add_argument(
+        "-q",
+        "--query",
+        metavar="",
+        nargs="+",
+        required=False,
+        help="Query to filter results. Optional",
+    )
 
     ls_parser.usage = f"{utils_error_parser.get_usage_prog(ls_parser)}"
     ls_parser.set_defaults(func=fs.ls_command)

src/fabric_cli/utils/fab_cmd_ls_utils.py

@@ -7,8 +7,10 @@
 from fabric_cli.client import fab_api_capacity as capacity_api
 from fabric_cli.client import fab_api_workspace as workspace_api
 from fabric_cli.core.hiearchy.fab_hiearchy import VirtualWorkspaceItem
+from fabric_cli.errors import ErrorMessages
 from fabric_cli.utils import fab_ui as utils_ui
-
+from fabric_cli.core.fab_exceptions import FabricCLIError
+from fabric_cli.core import fab_constant
 
 def sort_elements(
     elements: list[dict[str, str]], key: str = "name"
@@ -76,7 +78,24 @@ def format_and_print_output(
     columns: list[str] = [],
     hidden_data=None,
 ) -> None:
-
+    # Handle query parameter
+    if hasattr(args, 'query') and args.query:
+        query_parts = args.query.split() if isinstance(args.query, str) else args.query
+
+        # Validate that all query fields exist in available columns
+        invalid_fields = [field for field in query_parts if field not in columns]
+        if invalid_fields:
+            raise FabricCLIError(
+                ErrorMessages.Common.invalid_parameter(invalid_fields, columns),
+                fab_constant.ERROR_INVALID_QUERY_FIELDS,
+            )
+
+        if len(query_parts) > 1:
+            # Multiple query parameters - simulate -l flag
+            show_details = True
+        columns = query_parts
+
+    # Project only requested columns
     filtered_data = [
         {key: item[key] for key in columns if key in item} for item in data
     ]