CJF.CommandLine 1.30.702.20526

主控台指令行介面(Command Line Interface) For .Net Core

使用方法：

Host.CreateDefaultBuilder(args)
    .UseConsoleLifetime(opts => opts.SuppressStatusMessages = true)
    // .UseCommandLine(). // No use prompt
    .UseCommandLine(opts => opts.Prompt = $"{CurrentUser}\x1B[93m#\x1B[39m ", AppendCommands)
    .Build();

命令設定方式：

使用自訂屬性 CommandAttribute 設定，如：

[Command("quit")]
static void CLI_Quit()
{
    Environment.Exit(0);
}

函示格式定義

欲綁定 CommandAttribute 自訂屬性的函示定義格式如下：

static void CLI_Mathod1() { /*...*/ }
static void CLI_Mathod2(CliCenter cli) { /*...*/ }
static void CLI_Mathod3(CliCenter cli, params string[] args) { /*...*/ }
static void CLI_Mathod3(params string[] args) { /*...*/ }
static void CLI_Mathod3(CommandAttribute cmd, params string[] args) { /*...*/ }
static void CLI_Mathod3(CliCenter cli, CommandAttribute cmd, params string[] args) { /*...*/ }

以上六種方式

以下為使用範例：

#region CLI : Show Command Help - 2 Parameters: CliCenter, string[]
[Command("show", "顯示內部資料。")]
[Command("echo", "顯示輸入的文字。", "show")]
static void CLI_HasSubCommand(CliCenter cli, params string[] args)
{
    if (args[0] == "do-exec")
        args = args[1..];
    Console.WriteLine($"> 輸入 \"\x1B[96m{cli.AnalyzeToFullCommand(string.Join(" ", args))} ?\x1B[39m\" 顯示子指令清單與說明");
    Console.WriteLine();
}
#endregion

#region CLI : quit - No Parameter
[Command("quit", "關閉本程式")]
[Command("quit", "關閉本程式", "do-exec", Tag = "config")]
static void CLI_Quit()
{
    Environment.Exit(0);
}
#endregion

#region CLI : exit - 1 Parameter: CliCenter
[Command("exit", "離開設定模式", Tag = "config")]
static void CLI_Exit(CliCenter cli)
{
    if (string.IsNullOrEmpty(cli.UseTag)) return;
    cli.UseTag = "";
    cli.Prompt = $"{CurrentUser}\x1B[93m#\x1B[39m ";
    cli.HistoryPool = "default";
}
#endregion

#region CLI : config - 1 Parameter: CliCenter
[Command(MODE_CONFIG, "進入設定模式")]
static void CLI_ConfigMode(CliCenter cli)
{
    cli.UseTag = "config";
    cli.Prompt = $"{CurrentUser}(\x1B[96m{cli.UseTag}\x1B[39m)\x1B[93m#\x1B[39m ";
    Console.WriteLine();
}
#endregion

#region CLI : show echo [String] - 1 Parameter: string[]
[Command(CliCenter.STRING_REGEX, "如包含空白，請用單或雙引號。", "show echo", IsRegular = true, RegularHelp = "[String]")]
static void CLI_Echo(params string[] args)
{
    Console.WriteLine($"> Echo: \"\x1B[92m{args[2]}\x1B[39m\"");
    Console.WriteLine();
}
#endregion