A powerful and flexible command-line parsing library for .NET 10 with full integration with Microsoft.Extensions.Hosting, dependency injection, and middleware pipeline support.
Features
Modern .NET 10 - Built for the latest .NET platform
Multiple Parsing Styles - Supports POSIX (-v), GNU (--verbose), and Windows (/v) style arguments
Hierarchical Commands - Create nested subcommands like git remote add
IHostBuilder Integration - Seamless integration with .NET Generic Host
Dependency Injection - Full DI support for commands and services
Middleware Pipeline - Extensible middleware system following Open/Closed Principle (SOLID)
Type-Safe Parsing - Strongly-typed argument parsing with validation
Fluent API - Clean and intuitive configuration syntax
Architecture
graph TB
A[CliCoreKit.Core] -->|Provides| B[Command Parsing]
A -->|Provides| C[Command Routing]
A -->|Provides| D[Middleware Pipeline]
E[CliCoreKit.Hosting] -->|Extends| F[IHostBuilder]
E -->|Uses| A
G[Your CLI App] -->|References| E
G -->|Uses| H[Microsoft.Extensions.Hosting]
using Monbsoft.CliCoreKit.Core;
public class GreetCommand : ICommand
{
public Task<int> ExecuteAsync(CommandContext context, CancellationToken cancellationToken = default)
{
var name = context.GetOptionValue("name") ?? "World";
Console.WriteLine($"Hello, {name}!");
return Task.FromResult(0);
}
}
2. Configure Your CLI Application
using Microsoft.Extensions.Hosting;
using Monbsoft.CliCoreKit.Hosting;
var host = Host.CreateDefaultBuilder(args)
.ConfigureCli(cli =>
{
cli.AddCommand<GreetCommand>("greet", "Greet a user")
.UseValidation();
})
.Build();
return await host.RunCliAsync(args);
3. Run Your Application
dotnet run -- greet --name John
# Output: Hello, John!
public Task<int> ExecuteAsync(CommandContext context, CancellationToken cancellationToken)
{
// Check if option exists
bool verbose = context.HasOption("verbose") || context.HasOption("v");
// Get option value
string? output = context.GetOptionValue("output");
// Get typed value
if (context.TryGetOption<int>("port", out var port))
{
Console.WriteLine($"Using port: {port}");
}
// Get positional arguments
var file1 = context.GetPositional(0);
var file2 = context.GetPositional(1);
// Get all positional arguments
foreach (var file in context.Positional)
{
Console.WriteLine($"Processing: {file}");
}
return Task.FromResult(0);
}
Advanced Configuration
Custom Argument Parser Options
var parserOptions = new ArgumentParserOptions
{
AllowWindowsStyle = true,
AllowCombinedShortOptions = true
};
var parser = new ArgumentParser(parserOptions);
var router = new CommandRouter(registry, parser);
Command Validation
Define option requirements:
var definition = new CommandDefinition
{
Name = "deploy",
CommandType = typeof(DeployCommand),
Options = new List<OptionDefinition>
{
new()
{
Name = "environment",
ShortName = 'e',
Description = "Target environment",
IsRequired = true,
ValueType = typeof(string)
},
new()
{
Name = "force",
ShortName = 'f',
Description = "Force deployment",
IsRequired = false
}
}
};
Manual Command Registration
For advanced scenarios, you can manually configure commands:
cli.ConfigureCommands((serviceProvider, registry) =>
{
var definition = new CommandDefinition
{
Name = "custom",
Description = "Custom command with complex setup",
CommandType = typeof(CustomCommand),
Options = new List<OptionDefinition>
{
new() { Name = "option1", IsRequired = true }
}
};
registry.Register(definition);
});
