admin-delegation occ - add output option for show command to support JSON formats

[printminion-co]

Overview

This PR enhances the occ admin-delegation:show command by adding support for JSON output formats, providing a more programmatic way to access delegation information.

Changes Made

• Enhanced Command Options: Added --output option to the admin-delegation:show command with support for:

  • plain (default) - existing table format
  • json - compact JSON output
  • json_pretty - formatted JSON output

• New Import: Added Symfony\Component\Console\Input\InputOption import to support the new option parameter

• Improved Data Structure: Implemented structured JSON output that includes:

  • Section ID and metadata
  • Setting names and class names
  • Authorized groups for each delegated setting
  • Proper nesting of sections and their associated settings

Usage

# Default table output (unchanged)
occ admin-delegation:show

# JSON output
occ admin-delegation:show --output=json

# Pretty-printed JSON output  
occ admin-delegation:show --output=json_pretty

JSON Output

[
    {
        "id": "overview",
        "name": "Overview",
        "settings": [
            {
                "name": "Security & setup checks",
                "className": "OCA\\Settings\\Settings\\Admin\\Overview",
                "delegatedGroups": []
            }
        ]
    },
    {
        "id": "server",
        "name": "Basic settings",
        "settings": [
            {
                "name": "Background jobs",
                "className": "OCA\\Settings\\Settings\\Admin\\Server",
                "delegatedGroups": []
            }
        ]
    },
    {
        "id": "sharing",
        "name": "Sharing",
        "settings": [
            {
                "name": "Global",
                "className": "OCA\\Settings\\Settings\\Admin\\Sharing",
                "delegatedGroups": []
            }
        ]
    },
    {
        "id": "theming",
        "name": "Theming",
        "settings": [
            {
                "name": "Global",
                "className": "OCA\\Theming\\Settings\\Admin",
                "delegatedGroups": []
            }
        ]
    },
    {
        "id": "ai",
        "name": "Assistant",
        "settings": [
            {
                "name": "Artificial Intelligence",
                "className": "OCA\\Settings\\Settings\\Admin\\ArtificialIntelligence",
                "delegatedGroups": []
            }
        ]
    },
    {
        "id": "admindelegation",
        "name": "Administration privileges",
        "settings": [
            {
                "name": "Users",
                "className": "OCA\\Settings\\Settings\\Admin\\Users",
                "delegatedGroups": []
            },
            {
                "name": "Webhooks",
                "className": "OCA\\WebhookListeners\\Settings\\Admin",
                "delegatedGroups": []
            }
        ]
    }
]

Benefits

• API Integration: Enables easier integration with external tools and scripts
• Automation: Facilitates automated processing of delegation configurations
• Backward Compatibility: Maintains existing table output as the default behavior
• Structured Data: Provides consistently formatted delegation data for programmatic consumption

Technical Details

• Leverages the existing Base class output formatting methods
• Maintains the same data collection logic for consistency
• Proper error handling and fallback to default plain output

Files Changed

• apps/settings/lib/Command/AdminDelegation/Show.php

This enhancement improves the usability of the admin delegation system for both interactive use and automation scenarios.

Checklist

• Code is properly formatted
• Sign-off message is added to all commits
• Tests (unit, integration, api and/or acceptance) are included
• Screenshots before/after for front-end changes
• Documentation (manuals or wiki) has been updated or is not required
• Backports requested where applicable (ex: critical bugfixes)
• Labels added where applicable (ex: bug/enhancement, 3. to review, feature component)
• Milestone added for target branch/version (ex: 32.x for stable32)

[Copilot]

Pull Request Overview

This PR enhances the occ admin-delegation:show command by adding JSON output format support, enabling programmatic access to delegation information while maintaining backward compatibility with the existing table format.

• Added --output option with support for plain, json, and json_pretty formats
• Refactored data collection and formatting logic to support structured JSON output
• Implemented proper validation and error handling for output format options

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[come-nc]

When extending OC\Core\Command\Base, there is already an output option, you do not need to add it.

[come-nc]

Failures are not related

[printminion-co]

/backport to stable31

[come-nc]

/backport to stable32

[github-actions]

Hello there,
Thank you so much for taking the time and effort to create a pull request to our Nextcloud project.

We hope that the review process is going smooth and is helpful for you. We want to ensure your pull request is reviewed to your satisfaction. If you have a moment, our community management team would very much appreciate your feedback on your experience with this PR review process.

Your feedback is valuable to us as we continuously strive to improve our community developer experience. Please take a moment to complete our short survey by clicking on the following link: https://cloud.nextcloud.com/apps/forms/s/i9Ago4EQRZ7TWxjfmeEpPkf6

Thank you for contributing to Nextcloud and we hope to hear from you soon!

(If you believe you should not receive this message, you can add yourself to the blocklist.)