CliWrap is a library that makes it easier to interact with command line interfaces. It provides a convenient wrapper around the target executable, allowing you to pass execution parameters and read the resulting output. The library can also handle errors reported by the underlying process, allows command cancellation and has both synchronous and asynchronous APIs.
- Using NuGet:
Install-Package CliWrap - Continuous integration
- Full abstraction over
System.Diagnostics.Process - Execute commands in a synchronous, asynchronous, fire-and-forget manner
- Pass in command line arguments, standard input and environment variables
- Get process exit code, standard output and standard error as the result
- Abort the execution early using
System.Threading.CancellationToken - Abort all executions at once, on demand
- Set up callbacks that trigger when a process writes to StdOut or StdErr
- Targets .NET Framework 4.5+, .NET Core 1.0+ and .NET Standard 2.0+
- No external dependencies
The Cli class was designed to have each instance treated as a member of your project. When you're wrapping around a command line interface, you can think of the interface itself as a singleton class and all its commands as methods of that class. Therefore, it is recommended to create a reusable instance of Cli for each target executable.
If you're executing processes that can potentially outlive the parent, especially if they use a lot of resources, it is recommended to call CancelAll() at some point before your application terminates.
using (var cli = new Cli("some_cli.exe"))
{
// Execute
var output = await cli.ExecuteAsync("command --option");
// ... or in synchronous manner:
// var output = cli.Execute("command --option");
// Throw an exception if CLI reported an error
output.ThrowIfError();
// Extract output
var code = output.ExitCode;
var stdOut = output.StandardOutput;
var stdErr = output.StandardError;
var startTime = output.StartTime;
var exitTime = output.ExitTime;
var runTime = output.RunTime;
}using (var cli = new Cli("some_cli.exe"))
{
cli.ExecuteAndForget("command --option");
}using (var cli = new Cli("some_cli.exe"))
{
var input = new ExecutionInput("command --option", "this is stdin");
var output = await cli.ExecuteAsync(input);
}using (var cli = new Cli("some_cli.exe"))
{
var input = new ExecutionInput("command --option");
input.EnvironmentVariables.Add("some_var", "some_value");
var output = await cli.ExecuteAsync(input);
}using (var cli = new Cli("some_cli.exe"))
using (var cts = new CancellationTokenSource())
{
cts.CancelAfter(TimeSpan.FromSeconds(1)); // e.g. timeout of 1 second
var output = await cli.ExecuteAsync("command --option", cts.Token);
}using (var cli = new Cli("some_cli.exe"))
{
var handler = new BufferHandler(
stdOutLine => Console.WriteLine("StdOut> " + stdOutLine),
stdErrLine => Console.WriteLine("StdErr> " + stdErrLine));
var output = await cli.ExecuteAsync("command --option", bufferHandler: handler);
}
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent