.NET core command line parser
- multi level nested command parsers
- mandatory/optional short/long flags with/without value ; global flags
- parameter and array of parameters
- automatic standard usage ( color supported )
- automatic bash completions
dotnet new console --use-program-main -n test
cd test
dotnet add package netcore-cmdline
dotnet runto execute
example-01from command line can set path with something likeexport PATH=$PATH:~/opensource/netcore-cmdline/examples/example-01/bin/Debug/netcoreapp3.0
using SearchAThing;
namespace example_01
{
class Program
{
static void Main(string[] args)
{
// create main parser
CmdlineParser.Create("sample application", (parser) =>
{
var xflag = parser.AddShort("x", "my first flag");
var yflag = parser.AddShort("y", "my second flag");
// global flag with auto invoked action when matches that print usage for nested MatchParser
parser.AddShort("h", "show usage", null, (item) => item.MatchParser.PrintUsage());
// entrypoint for parser level cmdline match
parser.OnCmdlineMatch(() =>
{
if (xflag) System.Console.WriteLine($"x flag used");
if (yflag) System.Console.WriteLine($"y flag used");
});
// call this once at toplevel parser only
parser.Run(args);
});
}
}
}
using SearchAThing;
namespace example_01
{
class Program
{
static void Main(string[] args)
{
CmdlineParser.Create("sample application", (parser) =>
{
var xflag = parser.AddShort("x", "my first flag", "XVAL");
var yflag = parser.AddShort("y", "my second flag", "YVAL");
var vflag = parser.AddShortLong("v", "value", "a value flag", "VAL");
parser.AddShortLong("h", "help", "show usage", null, (item) => item.MatchParser.PrintUsage());
parser.OnCmdlineMatch(() =>
{
if (xflag) System.Console.WriteLine($"x flag used [{(string)xflag}]");
if (yflag) System.Console.WriteLine($"y flag used [{(string)yflag}]");
if (vflag) System.Console.WriteLine($"value specified [{(string)vflag}]");
});
parser.Run(args);
});
}
}
}devel0@tuf:~$ example-01 -h
Usage: example-01 FLAGS
sample application
Optional flags:
-x=XVAL my first flag
-y=YVAL my second flag
-v,--value=VAL a value flag
Global flags:
-h,--help show usage
devel0@tuf:~$ example-01 -x 1 -y 2 -v 3
x flag used [1]
y flag used [2]
value specified [3]
devel0@tuf:~$ example-01 -x 1 -y 2 --value 3
x flag used [1]
y flag used [2]
value specified [3]
devel0@tuf:~$ example-01 -x 1 -y 2 -v=3
x flag used [1]
y flag used [2]
value specified [3]
devel0@tuf:~$ example-01 -x 1 -y 2 --value=3
x flag used [1]
y flag used [2]
value specified [3]using SearchAThing;
namespace example_01
{
class Program
{
static void Main(string[] args)
{
CmdlineParser.Create("sample application", (parser) =>
{
var xflag = parser.AddShort("x", "test flag");
var param1 = parser.AddParameter("param1", "first parameter");
var param2 = parser.AddParameter("param2", "second parameter");
parser.AddShort("h", "show usage", null, (item) => item.MatchParser.PrintUsage());
parser.OnCmdlineMatch(() =>
{
System.Console.WriteLine(parser);
});
parser.Run(args);
});
}
}
}devel0@tuf:~$ example-01 -x a bcd
TYPE SHORT-NAME LONG-NAME DESCRIPTION GLOBAL MANDATORY MATCHES VALUE
--------------------------------------------------------------------------------------------
flag x test flag X
flag h show usage X
parameter param1 first parameter X a
parameter param2 second parameter X bcd
using SearchAThing;
using System.Linq;
namespace example_01
{
class Program
{
static void Main(string[] args)
{
CmdlineParser.Create("sample application", (parser) =>
{
var xflag = parser.AddShort("x", "test flag");
var param1 = parser.AddParameter("param1", "first parameter");
var param2 = parser.AddParameterArray("param2", "other params");
parser.AddShort("h", "show usage", null, (item) => item.MatchParser.PrintUsage());
parser.OnCmdlineMatch(() =>
{
System.Console.WriteLine($"param2 count = {param2.Count()}");
System.Console.WriteLine(parser);
});
parser.Run(args);
});
}
}
}devel0@tuf:~$ example-01 a
param2 count = 0
TYPE SHORT-NAME LONG-NAME DESCRIPTION GLOBAL MANDATORY MATCHES VALUE
------------------------------------------------------------------------------------------------
flag x test flag
flag h show usage X
parameter param1 first parameter X a
parameterArray param2 other params
devel0@tuf:~$ example-01 a b c
param2 count = 2
TYPE SHORT-NAME LONG-NAME DESCRIPTION GLOBAL MANDATORY MATCHES VALUE
------------------------------------------------------------------------------------------------------
flag x test flag
flag h show usage X
parameter param1 first parameter X a
parameterArray param2 other params X [ "b","c" ]
using SearchAThing;
using System.Linq;
namespace example_01
{
class Program
{
static void Main(string[] args)
{
CmdlineParser.Create("sample application", (parser) =>
{
var cmd1 = parser.AddCommand("cmd1", "sample command 1");
var cmd2 = parser.AddCommand("cmd2", "sample command 2");
var flag1 = parser.AddShortLong("f1", "test-flag1", "sample flag 1");
var flag2 = parser.AddShortLong("f2", "test-flag2", "sample flag 2");
var flag3 = parser.AddShortLong("f3", "my-flag3", "sample flag 3");
parser.AddShort("h", "show usage", null, (item) => item.MatchParser.PrintUsage());
var param = parser.AddParameter("item", "an odd number between 51 and 63");
param.OnCompletion((str) =>
{
var validSet = Enumerable.Range(50, 15).Where(r => r % 2 != 0).Select(w => w.ToString());
return validSet.Where(r => r.StartsWith(str));
});
parser.Run(args);
});
}
}
}- debugging
devel0@tuf:~$ SHOW_COMPLETIONS=2 example-01
cmd1
cmd2
devel0@tuf:~$ SHOW_COMPLETIONS=2 example-01 cmd2
51
53
55
57
59
61
63
devel0@tuf:~$ SHOW_COMPLETIONS=2 example-01 cmd2 5
51
53
55
57
59
devel0@tuf:~$ SHOW_COMPLETIONS=2 example-01 cmd2 6
61
63
devel0@tuf:~$ SHOW_COMPLETIONS=2 example-01 cmd2 63
devel0@tuf:~$- apply to bash completions
edit /etc/bash_completion.d/example-01 as follow ( note ${COM_LINE:2} to skip first dummy arg that is friendly name of the program )
_fn() {
#echo >> /tmp/completion-debug
#echo "COMP_LINE=${COMP_LINE}" >> /tmp/completion-debug
#SHOW_COMPLETIONS=2 example-01 ${COMP_LINE:2} >> /tmp/completion-debug
COMPREPLY=($(SHOW_COMPLETIONS=2 example-01 ${COMP_LINE:2}))
}
complete -F _fn example-01source it with . /etc/bash_completion then try as follows
using SearchAThing;
namespace example_01
{
class Program
{
static void Main(string[] args)
{
CmdlineParser.Create("sample application", (parser) =>
{
var cmdConfig = parser.AddCommand("config", "configuration", (pConfig) =>
{
pConfig.AddCommand("show", "show current config", (pConfigShow) =>
{
pConfigShow.OnCmdlineMatch(() => System.Console.WriteLine($"showing configuration..."));
});
pConfig.AddCommand("update", "update config item", (pConfigUpdate) =>
{
var param = pConfigUpdate.AddMandatoryParameter("var=value", "assign value to var");
pConfigUpdate.OnCmdlineMatch(() =>
{
System.Console.WriteLine($"setting [{(string)param}]");
});
});
});
// standard --help variant
parser.AddShortLong("h", "help", "show usage", null, (item) => item.MatchParser.PrintUsage());
parser.Run(args);
});
}
}
}
mkdir netcore-cmdline
cd netcore-cmdline
dotnet new sln
dotnet new classlib -n netcore-cmdline
cd netcore-cmdline
dotnet add package netcore-util
cd ..
dotnet sln add netcore-cmdline
mkdir examples
cd examples
dotnet new console -n example-01
cd example-01
dotnet add reference ../../netcore-cmdline
cd ..
cd ..
dotnet sln add examples/example-01
dotnet restore
dotnet build