Gapotchenko.FX.Diagnostics.CommandLine 2022.2.7

Overview

The module provides primitives for command line manipulation.

CommandLineBuilder

CommandLineBuilder class from Gapotchenko.FX.Diagnostics.CommandLine module allows to dynamically build a command line on the fly. It provides the built-in support for characters than need escaping.

Semantically CommandLineBuilder is similar to StringBuilder class:

using Gapotchenko.FX.Diagnostics;

var clb = new CommandLineBuilder();
clb.AppendParameter("/b");
clb.AppendParameter(@"C:\Temp\Test 1.txt");
clb.AppendParameter(@"C:\Temp\Test 2.txt");

Console.WriteLine(clb.ToString());

The code above produces the following output:

/b "C:\Temp\Test 1.txt" "C:\Temp\Test 2.txt"

Note how some command line parameters were automatically quoted because they contained whitespace characters.

CommandLineBuilder supports a fluent interface just like conventional StringBuilder, so the code can be rewritten as:

var clb = new CommandLineBuilder()
    .AppendParameter("/b")
    .AppendParameter(@"C:\Temp\Test 1.txt")
    .AppendParameter(@"C:\Temp\Test 2.txt");

Console.WriteLine(clb.ToString());

The resulting command line can be used in various places, most notably for starting a new process:

using System.Diagnostics;

…
Process.Start("copy", clb.ToString());

CommandLine

CommandLine static class provides operations for command line manipulation.

Build

CommandLine.Build method allows to quickly build a command line string from a specified list of arguments. Basically, this is a shortcut to CommandLineBuilder class in a handy functional form:

string s = CommandLine.Build("/b", @"C:\Temp\Test 1.txt", @"C:\Temp\Test 2.txt");

Such a form is very useful in something like this:

Process.Start(
    "cmd",
    CommandLine.Build(
        "/C", "copy",
        "/b", @"C:\Temp\Test 1.txt", @"C:\Temp\Test 2.txt"));

Another cool thing: if you want to exclude some argument from a command line then you can just make it null:

string mode = null;

// 'mode' can be assigned to a non-null value if there is a need to specify it.

string s = CommandLine.Build(mode, @"C:\Temp\Test 1.txt", @"C:\Temp\Test 2.txt");
Console.WriteLine(s);

The code above produces the following output:

"C:\Temp\Test 1.txt" "C:\Temp\Test 2.txt"

This is a neat departure from a traditional .NET convention where it always throws ArgumentNullException. Instead, Gapotchenko.FX uses a slightly different philosophy. It does the best job possible under existing conditions by following common-sense expectations of a user.

Split

CommandLine.Split provides the opposite operation to CommandLine.Build. It allows to split a command line string into a list of arguments using the rules of a host operating system:

using Gapotchenko.FX.Diagnostics;

string s = "/b \"C:\\Temp\\Test 1.txt\" \"C:\\Temp\\Test 2.txt\"";

foreach (string arg in CommandLine.Split(s))
    Console.WriteLine(arg);

The code above produces the following output:

/b
C:\Temp\Test 1.txt
C:\Temp\Test 2.txt

Commonly Used Types

• Gapotchenko.FX.Diagnostics.CommandLine
• Gapotchenko.FX.Diagnostics.CommandLineBuilder

Other Modules

Let's continue with a look at some other modules provided by Gapotchenko.FX:

• Gapotchenko.FX
• Gapotchenko.FX.AppModel.Information
• Gapotchenko.FX.Collections
• Gapotchenko.FX.Console
• Gapotchenko.FX.Data
• Gapotchenko.FX.Diagnostics
  • ➴ Gapotchenko.FX.Diagnostics.CommandLine
  • Gapotchenko.FX.Diagnostics.Process
  • Gapotchenko.FX.Diagnostics.WebBrowser
• Gapotchenko.FX.IO
• Gapotchenko.FX.Linq
• Gapotchenko.FX.Math
• Gapotchenko.FX.Memory
• Gapotchenko.FX.Security.Cryptography
• Gapotchenko.FX.Text
• Gapotchenko.FX.Threading

Or look at the full list of modules.