‫انتشار نسخهٔ پایدار System.CommandLine توسط مایکروسافت

• پارسینگ خودکار آرگومان‌ها و آپشن‌ها
• تولید خودکار --help و --version
• اعتبارسنجی ورودی‌ها
• پیشنهاد تکمیل دستورات (Suggestion)
• پشتیبانی از Response File (@file)
• میان‌افزارها (Middleware)
• ادغام کامل با Microsoft.Extensions.Hosting و Dependency Injection
• قابلیت انتشار به‌صورت dotnet tool
• محلی‌سازی متن کمک

dotnet add package System.CommandLine --version 2.0.0

dotnet new console -n DemoCli
cd DemoCli
dotnet add package System.CommandLine

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net10.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>

    <!-- این بخش باعث می‌شود بتوانید با dotnet pack → dotnet tool install -g demo اجرا کنید -->
    <PackAsTool>true</PackAsTool>
    <ToolCommandName>demo</ToolCommandName> <!-- نام دستوری که در ترمینال استفاده می‌شود -->
    <PackageId>DemoCli</PackageId>
    <Version>1.0.0</Version>
  </PropertyGroup>

</Project>

using System.CommandLine;
using System.CommandLine.Invocation;

var nameArg = new Argument<string>("name", "نام شخص برای سلام کردن");
var timesArg = new Argument<int>("times", "تعداد دفعات تکرار سلام")
{
    // مقدار پیش‌فرض اختیاری
    Arity = ArgumentArity.ZeroOrOne
};
timesArg.SetDefaultValue(1); // اگر مقدار ندهیم، یک بار اجرا شود

var upperOption = new Option<bool>(
    aliases: ["--uppercase", "-u"],
    description: "خروجی را با حروف بزرگ نمایش بده");

// زیر دستور greet
var greetCommand = new Command("greet", "چاپ پیام سلام")
{
    nameArg,
    timesArg,
    upperOption
};

// این خط جادویی است! تمام پارسینگ و بایندینگ خودکار انجام می‌شود
greetCommand.SetHandler((string name, int times, bool uppercase) =>
{
    var message = uppercase 
        ? $"HELLO, {name.ToUpperInvariant()}!" 
        : $"Hello, {name}!";

    for (int i = 0; i < times; i++)
        Console.WriteLine(message);

}, nameArg, timesArg, upperOption);

// دستور ریشه (root command)
var rootCommand = new RootCommand("ابزار دمو CLI ساخته‌شده با System.CommandLine 2.0")
{
    greetCommand
};

// این دو گزینه به‌صورت خودکار اضافه می‌شوند
rootCommand.AddGlobalOption(new Option<bool>(["--version"], "نمایش نسخه"));
rootCommand.Description = "یک ابزار ساده برای تست System.CommandLine";

return await rootCommand.InvokeAsync(args);

{
  "profiles": {
    "Greet Diane 3 times": {
      "commandName": "Project",
      "commandLineArgs": "greet Diane 3"
    },
    "Shout at Jack": {
      "commandName": "Project",
      "commandLineArgs": "greet Jack 1 -u"
    },
    "Shout 5 times": {
      "commandName": "Project",
      "commandLineArgs": "greet Jack 5 --uppercase"
    }
  }
}

dotnet pack -c Release
dotnet tool install --global --add-source ./nupkg demo

demo greet Ali 4 -u

var ageArg = new Argument<int>("age", "سن شخص");
ageArg.AddValidator(result =>
{
    if (result.GetValueOrDefault<int>() < 0)
        result.ErrorMessage = "سن نمی‌تواند منفی باشد!";
});

var colorOption = new Option<ConsoleColor>(["--color", "-c"], "رنگ متن")
{
    Arity = ArgumentArity.ExactlyOne
};

var builder = Host.CreateDefaultBuilder(args)
    .ConfigureServices(services => services.AddSingleton<MyService>())
    .UseCommandLine(rootCommand); // این extension جدید است!