SolimusWrapper 1.0.2

SolimusWrapper

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

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

• 🚀 Fluent API — читаемый и удобный синтаксис
• 🔒 Immutable — потокобезопасные команды
• ⚡ Async/Await — полная асинхронность
• 🔄 Pipes — перенаправление stdout, stderr, stdin
• ⏱️ Таймауты — автоматическое завершение процессов
• 🔁 Retry Logic — повторные попытки с exponential backoff
• 🛡️ Shell Escaping — защита от инъекций команд
• 📝 Structured Logging — логирование в консоль и файлы
• 🌍 Кросс-платформенность — Windows, Linux, macOS
• 📦 Zero Dependencies — никаких внешних зависимостей

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

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")
    .WithStandardOutputPipe(PipeTarget.ToDelegate(Console.WriteLine))
    .WithStandardErrorPipe(PipeTarget.ToFile("errors.log"))
    .ExecuteAsync();

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

await Command.Run("long-process")
    .WithTimeout(TimeSpan.FromSeconds(30))
    .ExecuteAsync(cancellationToken);

🔁 Retry Logic

// Exponential backoff
var result = await Command.Run("curl")
    .WithArguments("https://api.example.com")
    .ExecuteWithRetryAsync(RetryOptions.Exponential(maxAttempts: 3));

// С настройками
await Command.Run("flaky-api")
    .ExecuteWithRetryAsync(options =>
    {
        options.MaxAttempts = 5;
        options.Delay = TimeSpan.FromSeconds(1);
        options.BackoffMultiplier = 2.0;
        options.OnRetry = attempt => Console.WriteLine($"Retry {attempt.AttemptNumber}...");
    });

🛡️ Shell Escaping

// Автоматическое экранирование опасных символов
var userInput = "file; rm -rf /";

await Command.Run("cat")
    .WithSafeArguments(userInput)
    .ExecuteAsync();

// Проверка на инъекции
if (ShellEscaper.LooksLikeInjection(userInput))
    Console.WriteLine("Опасный ввод!");

📝 Structured Logging

// Консольное логирование
await Command.Run("dotnet")
    .WithArguments("build")
    .WithConsoleLogging()
    .ExecuteAsync();

// Файловое логирование с маскированием паролей
using var logger = new FileCommandLogger("commands.log", new LoggingOptions 
{ 
    MaskSensitiveData = true 
});

await Command.Run("deploy")
    .WithArguments("--token", "secret123")
    .WithLogger(logger)
    .ExecuteAsync();

CommandBuilder

using SolimusWrapper.Builders;

await new CommandBuilder("dotnet")
    .AddArgument("publish")
    .AddFlag("-v", verbose)
    .AddArgumentIfNotEmpty("-c", configuration)
    .AddArgumentIf(OperatingSystem.IsLinux(), "-r", "linux-x64")
    .SetTimeout(TimeSpan.FromMinutes(10))
    .UseConsoleLogging()
    .ExecuteWithRetryAsync(RetryOptions.Default);

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

// Работает на Windows, Linux, macOS
var files = await CommandExtensions.ListFiles().ExecuteAndReadOutputAsync();
var pwd = await CommandExtensions.GetCurrentDirectory().ExecuteAndReadOutputAsync();

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

📊 API

🔧 Требования

• .NET 10.0+

📄 Лицензия

MIT License

🔗 Ссылки

• GitHub
• Документация
• Issues