MintPlayer.CliGenerator 10.21.0

CLI command generators

Create structured CLI applications with nested commands and dependency injection support using the CliCommand source generator.

1. Annotate your root command with [CliRootCommand] and mark each command (and subcommand) with [CliCommand].
2. Define command options with [CliOption] and positional arguments with [CliArgument] on mutable properties.
3. Implement MintPlayer.CliGenerator.Attributes.ICliCommand so each command exposes an Execute(CancellationToken) handler returning a task-based exit code.
4. Register your commands with the generated Add<MyCommand>CommandTree extension and invoke them through the generated helpers.
5. Use [CliParentCommand(typeof(ParentCommand))] on a non-nested partial command class to attach it under an existing command without nesting the type in code. This enables splitting large command trees across multiple files.

[CliRootCommand(Name = "demo", Description = "Sample CLI")]
public partial class DemoCommand : ICliCommand
{
    [CliOption("--verbose", "-v")] public bool Verbose { get; set; }

    public Task<int> Execute(CancellationToken cancellationToken)
    {
        if (Verbose)
        {
            Console.WriteLine("Verbose mode active");
        }
        return Task.FromResult(0);
    }
}

// In another file:
[CliCommand("greet", Description = "Greets a person")]
[CliParentCommand(typeof(DemoCommand))]
public partial class Greet : ICliCommand
{
    private readonly IGreetingService greetingService;
    public Greet(IGreetingService greetingService) => this.greetingService = greetingService;

    [CliArgument(0)] public string Name { get; set; } = "world";
    [CliOption("--times", DefaultValue = 1)] public int Times { get; set; }

    public async Task<int> Execute(CancellationToken cancellationToken)
    {
        for (var i = 0; i < Times; i++)
            await greetingService.GreetAsync(Name, cancellationToken);
        return 0;
    }
}

var builder = Host.CreateApplicationBuilder(args);
builder.Services.AddDemoCommandTree();
builder.Services.AddSingleton<IGreetingService, GreetingService>();
var app = builder.Build();
return await app.Services.InvokeDemoCommandAsync(args);

The generator creates:

• Scoped service registrations for all commands in the tree.
• Methods that build System.CommandLine command hierarchies and wire options and arguments automatically.
• Extensions on IServiceCollection and IServiceProvider to register and execute the command tree.
• Recognition of non-nested partial command classes linked via [CliParentCommand].