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

[aviatco]

📥 Pull Request

✨ Description of new changes

Added a new -q/--query parameter to the ls and acl ls commands that allows users to specify which columns they want to display in the output. This enhancement provides more control over the output format and makes it easier to focus on specific properties.

This feature works across all resource types (workspace, item, OneLake etc...).
Use the -l flag to filter by fields that aren’t included in the default ls output.

Key Changes

• Added -q/--query parameter to ls and acls ls command parsers
• Updated ls and acls ls implementation to filter output columns based on query parameter and override -l flag when multiple fields are specified
• Added comprehensive test coverage for query functionality
• Updated documentation to reflect new capability

Examples

Basic usage with single field:

fab acl ls workspace1.workspace -q identity
fab fs ls -q name

Multiple fields:

fab acl ls workspace1.workspace -q identity name
fab fs ls -q name id

Testing

Added new test cases covering:

• Single field queries
• Multiple field queries
• Invalid field handling
• Query parameter interaction with different resource types (workspace, connection, gateway)
• Documentation
• Updated command reference in docs/commands/acls/index.md
• Added example usage in docs/examples/acl_examples.md
• Backwards Compatibility
• This change is fully backwards compatible. The -q/--query parameter is optional, and existing behavior is preserved when not using the parameter.