Dev.Terminals 2.0.0

Dev Terminals

This is a wrapper of the native OS terminal that can execute many commands and track command result.

Usage

Command

Create and starts a Command

Command.CreateAndStart(
	string commandPath,
	string arguments,
	string? workingDirectory,
	LogLevel? outputLogLevel)

using var command = Command.CreateAndStart(
      commandPath: "cmd.exe",
      arguments: "/c \"ping localhost>NUL && echo MyTestString\"",
      workingDirectory: "c:\\",
      outputLogLevel: LogLevel.Debug
);

Console.WriteLine(command.HasExited); // false

// Wait for the process to complete!
command.WaitForResult();

// Throws exception when Exit Code is not 0
command.EnsureExitCodeIs(0);

Console.WriteLine(command.HasExited); // true
Console.WriteLine(command.ExitCode); // 1
Console.WriteLine(command.TextOutput); // MyTestString

Create, executes, and wait for a Command

using var command = Command.CreateAndWait(
      commandPath: "cmd.exe",
      arguments: "/c \"....\""
);

Console.WriteLine(command.HasExited); // true

Shell

A shell helper methods to quickly execute commands

using static Dev.Terminals.TerminalFacade;

// Execute a string command in the default system shell
Shell("ping localhost");

// Execute a command in the default system shell
Shell(
  TerminalCommand.CreateParse("echo test"));

// Execute several command in the default system shell
Shell(
  TerminalCommand.Cd("/src") &&
  TerminalCommand.CreateParse("ls .") &&
  TerminalCommand.CreateParse("ping ..."));

Terminal

An InProcess terminal window that can execute multiple commands

// The linux `/bin/sh` shell syntax
var syntax = new UnixShSyntax();

// The windows `cmd.exe` shell syntax
var syntax = new WindowsCmdSyntax();

// Select one of the above depending on the OS
var currentOsSyntax = TerminalFacade.DefaultTerminalSyntax;

// create a terminal as the system default shell
var terminal = new Terminal(currentOsSyntax, consoleLogLevel: LogLevel.Verbose, workingDirectory: "c:\\");

// execute command
var result = terminal.Exec(TerminalCommand.CreateParse("ping localhost"));

// async execute command
var result2 = await terminal.ExecAsync(TerminalCommand.CreateParse("ping localhost"));