CliWrap 中如何将命令输出重定向到 IProgress<string> 接口

在 .NET 开发中，System.IProgress 接口是一个非常实用的工具，它通常用于在异步操作中报告进度信息。这个接口最常见的用途是显示百分比进度条，但实际上它可以传递任何类型的进度信息，包括字符串消息。

CliWrap 作为一个强大的命令行工具包装库，提供了灵活的管道重定向功能。许多开发者可能不知道，CliWrap 已经内置了对 IProgress 的直接支持，无需编写额外的扩展方法。

基本用法

将命令行输出直接重定向到 Progress 非常简单：

var progress = new Progress<string>(msg => Console.WriteLine(msg));
var cmd = Cli.Wrap("foo") | progress.Report;

这种写法利用了 C# 的方法组转换特性，将 Progress.Report 方法直接作为 PipeTarget 使用。CliWrap 内部会自动处理流的读取和消息的分发。

高级场景

对于需要传递上下文信息的场景，可以这样处理：

var progress = new Progress<(string Context, string Msg)>();
var context = "Command1";

var cmd = Cli.Wrap("foo") 
    | PipeTarget.ToDelegate(msg => progress.Report((context, msg)));

实现原理

CliWrap 的这种简洁语法背后是强大的管道系统设计。当使用 IProgress.Report 作为管道目标时，CliWrap 会：

1. 自动创建一个 StreamReader 来读取命令输出流
2. 按行分割输出内容
3. 对每一行调用 Report 方法
4. 正确处理流结束和取消请求

最佳实践

在使用这种重定向方式时，建议：

1. 考虑输出内容的频率，避免过于频繁的报告影响性能
2. 对于长时间运行的命令，确保正确处理取消请求
3. 在 UI 应用中，注意跨线程调用问题

CliWrap 的这种设计体现了 .NET 生态系统中接口一致性的优势，使得不同组件能够无缝协作。开发者可以专注于业务逻辑，而不必担心底层的流处理细节。