Tyrrrz/CliWrap

Что это?

Ключевые возможности

• 01Гибкая неизменяемая настройка команд с помощью цепочек вызовов: аргументы, рабочая директория и переменные окружения.
• 02Гибкое перенаправление stdin, stdout и stderr в файлы, потоки, строки, делегаты или другие команды.
• 03Буферизованное выполнение и потоки событий с pull- или push-моделью для обработки вывода.
• 04Асинхронный API с поддержкой принудительной и корректной отмены.
• 05По умолчанию ненулевой код завершения приводит к исключению; проверку можно отключить.
• 06Без внешних зависимостей.

Сценарии использования

• Вызов внешних инструментов, например git, ffmpeg или docker, из приложения .NET.
• Передача вывода процесса в реальном времени в логи или интерфейс пользователя.
• Объединение инструментов командной строки в цепочки с перенаправлением ввода и вывода.
• Запуск долгих процессов с тайм-аутами и корректным завершением.

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

1. 1

   Установите NuGet-пакет CliWrap

   dotnet add package CliWrap
2. 2

   Импортируйте пространство имён и вызовите Cli.Wrap(...), указав путь к исполняемому файлу, а затем ExecuteAsync() в коде на C#

Что важно знать

• !Перед использованием проекта или его исходного кода README требует согласиться с политическими условиями использования, касающимися России и Украины.
• !Поддержка параметров политики ресурсов зависит от платформы.
• !Параметры учётных данных, кроме имени пользователя, доступны только в Windows.

В подборках

Темы

Частые вопросы

Что такое CliWrap?

Библиотека .NET для запуска процессов командной строки с гибкой настройкой, перенаправлением stdin/stdout/stderr и асинхронной отменой. CliWrap — библиотека .NET, которая предоставляет для System.Diagnostics.Process удобный неизменяемый API с цепочками вызовов и предназначена для запуска инструментов командной строки. Команду создают вызовом Cli.Wrap с путём к исполняемому файлу, затем задают аргументы, рабочую директорию, переменные окружения и другие параметры, после чего вызывают ExecuteAsync или один из методов более высокого уровня.

CliWrap можно использовать бесплатно? Какая у него лицензия?

CliWrap распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.

CliWrap всё ещё поддерживается?

Активно поддерживается. Последний коммит в CliWrap — 4 нояб. 2026 г..

Для чего можно использовать CliWrap?

Вызов внешних инструментов, например git, ffmpeg или docker, из приложения .NET. Передача вывода процесса в реальном времени в логи или интерфейс пользователя. Объединение инструментов командной строки в цепочки с перенаправлением ввода и вывода. Запуск долгих процессов с тайм-аутами и корректным завершением.

Как установить CliWrap?

Установите NuGet-пакет CliWrap: dotnet add package CliWrap Импортируйте пространство имён и вызовите Cli.Wrap(...), указав путь к исполняемому файлу, а затем ExecuteAsync() в коде на C#

Где скачать CliWrap?

Исходный код и инструкции по установке — на GitHub: https://github.com/Tyrrrz/CliWrap