SolimusWrapper 1.0.1

SolimusWrapper

Лёгкая и оптимизированная библиотека для работы с CLI процессами в .NET.

✨ Особенности

• 🚀 Fluent API — читаемый и удобный синтаксис
• 🔒 Immutable — потокобезопасные команды
• ⚡ Async/Await — полная асинхронность с CancellationToken
• 🔄 Pipes — перенаправление stdout, stderr, stdin
• ⏱️ Таймауты — автоматическое завершение процессов
• 🌍 Кросс-платформенность — Windows, Linux, macOS
• 📦 Zero Dependencies — никаких внешних зависимостей
• 🎯 Native AOT — поддержка trimming

📦 Установка

dotnet add package SolimusWrapper

🚀 Быстрый старт

using SolimusWrapper;

// Простой запуск
var result = await Command.Run("dotnet")
    .WithArguments("--version")
    .ExecuteAsync();

// Получить вывод
var output = await Command.Run("git")
    .WithArguments("status")
    .ExecuteAndReadOutputAsync();

📖 Примеры использования

Базовые операции

// Запуск с аргументами
await Command.Run("dotnet")
    .WithArguments("build", "-c", "Release")
    .ExecuteAsync();

// Получить stdout и stderr
var (stdOut, stdErr) = await Command.Run("dotnet")
    .WithArguments("build")
    .ExecuteAndReadAllAsync();

Вывод в реальном времени

await Command.Run("dotnet")
    .WithArguments("test")
    .WithStandardOutputPipe(PipeTarget.ToDelegate(Console.WriteLine))
    .WithStandardErrorPipe(PipeTarget.ToDelegate(line => 
        Console.WriteLine($"[ERR] {line}")))
    .ExecuteAsync();

Перенаправление в файл

await Command.Run("dotnet")
    .WithArguments("build", "-v", "detailed")
    .WithStandardOutputPipe(PipeTarget.ToFile("build.log"))
    .ExecuteAsync();

Передача данных в stdin

await Command.Run("grep")
    .WithArguments("error")
    .WithStandardInputPipe(PipeSource.FromString("line1\nerror here\nline3"))
    .ExecuteAsync();

// Из файла
await Command.Run("cat")
    .WithStandardInputPipe(PipeSource.FromFile("input.txt"))
    .ExecuteAsync();

Рабочая директория и переменные окружения

await Command.Run("npm")
    .WithArguments("install")
    .WithWorkingDirectory("/path/to/project")
    .WithEnvironmentVariable("NODE_ENV", "production")
    .ExecuteAsync();

Таймауты и отмена

// Таймаут
try
{
    await Command.Run("long-process")
        .WithTimeout(TimeSpan.FromSeconds(30))
        .ExecuteAsync();
}
catch (TimeoutException)
{
    Console.WriteLine("Процесс превысил лимит времени");
}

// Отмена
using var cts = new CancellationTokenSource();
await Command.Run("task").ExecuteAsync(cts.Token);

Обработка кодов выхода

// Исключение при ошибке (по умолчанию)
try
{
    await Command.Run("failing-command").ExecuteAsync();
}
catch (CommandExecutionException ex)
{
    Console.WriteLine($"Exit code: {ex.ExitCode}");
}

// Без исключения
var result = await Command.Run("might-fail")
    .WithValidation(false)
    .ExecuteAsync();

if (!result.IsSuccess)
    Console.WriteLine($"Failed with code: {result.ExitCode}");

CommandBuilder для условной логики

using SolimusWrapper.Builders;

var result = await new CommandBuilder("dotnet")
    .AddArgument("publish")
    .AddFlag("-v", verbose)
    .AddArgumentIfNotEmpty("-c", configuration)
    .AddArgumentIf(OperatingSystem.IsLinux(), "-r", "linux-x64")
    .SetTimeout(TimeSpan.FromMinutes(10))
    .ExecuteAsync();

Кросс-платформенные хелперы

// Shell (cmd на Windows, sh на Unix)
await CommandExtensions.Shell("echo Hello").ExecuteAsync();

// Список файлов
var files = await CommandExtensions.ListFiles().ExecuteAndReadOutputAsync();

// Ping
await CommandExtensions.Ping("google.com", 4)
    .WithStandardOutputPipe(PipeTarget.ToDelegate(Console.WriteLine))
    .ExecuteAsync();

📊 API Reference

Command

PipeTarget

PipeSource

CommandResult

🔧 Требования

• .NET 10.0 или выше

📄 Лицензия

MIT License - см.

🔗 Ссылки

• GitHub Repository
• Documentation
• Issues