Proc 0.8.1

Proc

一个无依赖的 System.Diagnostics.Process 加速器。

1. Proc.Exec() 用于快速单行命令
2. Proc.Start() 用于快速单行命令
   • 如果需要同时捕获控制台输出并在实时打印这些消息，请使用。
   • Proc.Start() 还允许您对 StandardIn 编写脚本并响应对话息
3. 将 System.Diagnostics.Process 包装为 IObservable
   • ProcessObservable 基于流的包装
   • EventBasedObservableProcess 基于事件的包装
4. 内置支持在执行硬 SIGKILL（Process.Kill()）之前向任何进程发送 SIGINT
   • 必须使用 StartArguments 上的 SendControlCFirst = true 设置

Proc.Exec

执行进程并使用默认的超时时间（4分钟）阻塞。此方法使用与控制台相同的会话，因此会打印二进制控制台输出。如果命令执行失败，则抛出 ProcExecException。有关更多选项，请参阅 ExecArguments

Proc.Exec("ipconfig", "/all");

Proc.Start

使用默认的超时时间（4分钟）启动进程并阻塞

var result = Proc.Start("ipconfig", "/all");

提供自定义超时和一个可以输出到控制台的身影IConsoleOutWriter，在当前行阻塞时

var result = Proc.Start("ipconfig", TimeSpan.FromSeconds(10), new ConsoleOutColorWriter());

可以通过传入StartArguments来传递更多选项，以控制进程应该如何启动。

var args = new StartArguments("ipconfig", "/all")
{
  WorkingDirectory = ..
}
Proc.Start(args, TimeSpan.FromSeconds(10));

静态的Proc.Start，如果没有指定，默认超时时间为4分钟。

结果具有以下属性

• 完成如果程序在超时前完成，则为true
• ConsoleOut列表包含了console输出信息作为LineOut实例，其中错误表示是否写入到stderr
• 过程代码

注意konvehicleOut无论是否提供了IConsoleOutWriter，都会设置为true

可观察过程

所有这一切的核心是一个 IObservable实例。它直接监听输出缓冲区，不等待新行就发射。

要手动创建一个可观察过程，请遵循以下模式

using (var p = new ObservableProcess(args))
{
	p.Subscribe(c => Console.Write(c.Characters));
	p.WaitForCompletion(TimeSpan.FromSeconds(2));
}

可观察项在订阅之前是冷的，并且不打算重复使用或多次订阅。如果需要共享订阅，请考虑ObjC的 Publish。

WanForCompletion （）调用阻塞，所以 P（）不会销毁，这会导致启动的进程关闭。

默认关闭方法是 السادس ，这是一个对进程的硬杀（SIGKILL）。

Proc的奇妙之处在于它还支持干扰干扰，允许进程干净地关闭。

var args = new StartArguments("elasticsearch.bat")
{
	SendControlCFirst = true
};

这将在Windows操作系统中首先尝试向运行进程的控制台发送控制+C，然后再回到关闭进程。Linux和OSX对该标志的支持仍在开发中，这就是为什么将其作为可选的功能。

处理byte[]字符可能不是你想要编程的，因此可观察过程还允许以下操作。

using (var p = new ObservableProcess(args))
{
	p.SubscribeLines(c => Console.WriteLine(c.Line));
	p.WaitForCompletion(TimeSpan.FromSeconds(2));
}

不是将byte[]作为在套接字上接收它们一样代理，而是缓冲，仅在水印上发射

在某些情况下，引入自己的单词边界非常有用。

public class MyProcObservable : ObservableProcess
{
	public MyProcObservable(string binary, params string[] arguments) : base(binary, arguments) { }

	public MyProcObservable(StartArguments startArguments) : base(startArguments) { }

	protected override bool BufferBoundary(char[] stdOut, char[] stdErr)
	{
		return base.BufferBoundary(stdOut, stdErr);
	}
}

在BufferBoundary内部返回true将产生一个行到SubscribeLine()。这可能是有用的，例如，如果您的进程在没有新行的情况下提示。

继续[Y/N]: <没有新行>

一个更具体的例子是当您在Windows上调用一个bat文件并发送一个SIGINT信号时，它会始终提示。

结束批处理工作(Y/N)?

这不会谒见SubscribeLines并阻塞任何不必要的等待处理。因此，可观察过程会处理此边缘情况，并在.TB上自动用Y在stdin中响应。

TITION>可观察过程会在OnCompleted （）之前发出BUFFER中的任何内容。

TITION>基于事件的可观察项

可观察过程的兄弟，使用了输出数据接收和错误数据接收，只能发射行