iSukces.CliTools 1.26.713.1

iSukces.CliTools

Polska wersja

Helper library for running external CLI tools from .NET applications. It provides classes for asynchronous process execution, argument building, environment variable handling, stdout/stderr capture, and returning process results in a consistent model.

Requirements

• .NET 10

Installation

NuGet package:

dotnet add package iSukces.CliTools

Usage

Minimal process execution:

var result = await new Cli
{
    FileName = "dotnet",
    Arguments = ["--info"]
}.RunAsync();

Console.WriteLine(result.Output);

Building command-line arguments:

var arguments = new ArgumentCollector();
arguments.Add("input.mp4");
arguments.Add("output.mp3", "output");
arguments.Add(true, "overwrite", "no-overwrite");

Main types

Cli

Runs external processes asynchronously. It supports executable file selection, arguments, working directory, environment variables, stdout/stderr redirection, and output display modes: All, Tail, and None.

ArgumentCollector

Builds CLI argument arrays. It supports plain arguments, prefixed options, boolean switches, numeric and text values, and snake_case conversion through AddSnake.

CliResult and CliException

CliResult stores the exit code, stdout, stderr, start time, finish time, duration, and full invocation data. CreateException creates a CliException with process error details.

Result<T> and Result

Operation result model containing a value, success status, exception, and optional CliResult. Make, MakeAsync, and FromCliCallEx wrap synchronous, asynchronous, and CLI calls.

EnvironmentUpdater

Prepares environment variables for a process, prepends directories to PATH, activates changes temporarily, and searches for executable files in configured paths.

TailConsoleOutput

Displays the last process output lines in the console. It is used by Cli when the Tail output mode is selected.

WindowsConsoleUtils

Contains EscapeCommandLineParameterIfNecessary, which escapes command-line arguments according to Windows parsing rules.

TextExtensions

Contains text extensions, including ToSnake and Coalesce.

Build

dotnet build ..\iSukces.Cli.sln

Project configuration

• Target framework: net10.0
• Package license: MIT

Disclaimer

This package only provides a .NET layer that starts the selected external process in the operating system. It acts as a bridge/facade for a tool supplied and installed outside this package.

This package does not include the executed tool, does not modify how it works, and is not responsible for its results, failures, environment requirements, resource usage, or any damages resulting from the use of that external tool.