Command API in OCP

[CarlSchwan]

Summary

Inspired by the new API from symfony/console

This will allow us to remove all our ugly stubs in many apps.

Can be used either on a class:

#[AsCommand(
     name: 'app:create-user',
     // this short description is shown when running "occ list"
     description: 'Creates a new user.',
     // this is shown when running the command with the "--help" option
     help: 'This command allows you to create a user...',
     // this allows you to show one or more usage examples (no need to add the command name)
     usages: ['bob', 'alice --as-admin'],
)]
class CreateUserCommand {
    public function __invoke(
        #[Argument(description: "The username of the user")] string $userId,
        IOutput $output,
    ): ExitCode {
        // ...
        return ExitCode::Success;
    }
}

Or on methods:

class UserCommands {
    #[AsCommand('app:user:create')]
    public function create(
        #[Argument(description: "The username of the user")] string $userId,
        IOutput $output,
    ): ExitCode {
        // ...

        return ExitCode::Success;
    }

    #[AsCommand('app:user:delete')]
    public function delete(
        #[Argument(description: "The username of the user")] string $userId,
        IOutput $output,
    ): ExitCode {
        // ...

        return ExitCode::Success;
    }

}

TODO

• ...

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)

AI (if applicable)

• The content of this PR was partly or fully generated using AI (the port of some of the files commands)

[come-nc]

This smell as missing const in IInput, and/or maybe a method getOutputFormat or something?

[come-nc]

Suggested change

	#[Argument(description: 'User to refresh mounts for')] string $user,
	#[Argument(description: 'User to refresh mounts for')]
	string $user,

I would prefer a line break after attribute, is that allowed by our php-cs currently?

[come-nc]

I think I like the idea.