cmdダウンロード - cmdソースコードのダウンロード

cmd

その他のソースコード

v1.4.3

ダウンロード

go-cmd/コマンド

このパッケージは、小さいながらも非常に便利な os/exec.Cmd のラッパーで、同時性の高い非同期リアルタイムアプリケーションで外部コマンドを安全かつ簡単に実行できるようにします。 Linux、macOS、Windows で動作します。基本的な使い方は次のとおりです。

 import (
	"fmt"
	"time"
	"github.com/go-cmd/cmd"
)

func main () {
	// Start a long-running process, capture stdout and stderr
	findCmd := cmd . NewCmd ( "find" , "/" , "--name" , "needle" )
	statusChan := findCmd . Start () // non-blocking

	ticker := time . NewTicker ( 2 * time . Second )

	// Print last line of stdout every 2s
	go func () {
		for range ticker . C {
			status := findCmd . Status ()
			n := len ( status . Stdout )
			fmt . Println ( status . Stdout [ n - 1 ])
		}
	}()

	// Stop command after 1 hour
	go func () {
		<- time . After ( 1 * time . Hour )
		findCmd . Stop ()
	}()

	// Check if command is done
	select {
	case finalStatus := <- statusChan :
		// done
	default :
		// no, still running
	}

	// Block waiting for command to exit, be stopped, or be killed
	finalStatus := <- statusChan
}

メソッドはStart 、 Stop 、 Status 3 つだけです。 go-cmd/Cmdには次の機能があるため、可能な場合はos/exec.Cmdよりもgo-cmd/Cmdを使用することをお勧めします。

チャネルベースのファイア・アンド・フォーゲット
リアルタイムの標準出力と標準エラー出力
リアルタイムステータス
完全かつ統合された返品
適切なプロセス終了
100% のテストカバレッジ、競合状態なし

チャネルベースのファイア・アンド・フォーゲット

上の例が示すように、コマンドを開始すると、何らかの理由でコマンドが終了したときに最終ステータスが送信されるチャネルがすぐに返されます。したがって、デフォルトではコマンドは非同期的に実行されますが、同期的に実行することも可能で簡単です。

 // Run foo and block waiting for it to exit
c := cmd . NewCmd ( "foo" )
s := <- c . Start ()

os/exec.Cmdで同様のことを実現するには、このパッケージがすでに実行しているすべてのことが必要です。

リアルタイムの標準出力と標準エラー出力

コマンドの実行中にstdout または stderr を読み取りたい場合はよくあります。一般的なアプローチは、 StdoutPipe を呼び出し、提供されたio.ReadCloserから読み取ることです。これは機能しますが、競合状態（ go test -race detects）を引き起こすため間違っており、ドキュメントにはそれが間違っていると記載されています。

したがって、パイプからのすべての読み取りが完了する前に Wait を呼び出すのは正しくありません。同じ理由で、StdoutPipe を使用するときに Run を呼び出すことは正しくありません。

適切な解決策は、 Stdoutのio.Writer設定することです。スレッドセーフでレース性のないものにするためには、おそらく N 個のゴルーチンが読み取られる間に、さらなる書き込み作業が必要になります。 go-cmd/Cmdこの作業を行いました。

リアルタイムステータス

リアルタイムの stdout および stderr と同様に、経過したランタイムなどを確認できるのは便利です。このパッケージにより、次のことが可能になります。 Status任意の goroutine からいつでも呼び出すことができ、次の構造体を返します。

 type Status struct {
    Cmd      string
    PID      int
    Complete bool
    Exit     int
    Error    error
    Runtime  float64 // seconds
    Stdout   [] string
    Stderr   [] string
}

完全かつ統合された返品

上記の構造体について言えば、Go の組み込みCmdすべての戻り情報を 1 か所にまとめませんが、Go は素晴らしいので問題ありません。ただし、時間を節約するために、 go-cmd/Cmd上記のStatus構造体を使用してコマンドに関するすべての情報を伝えます。コマンドが終了した場合でも、 Status呼び出すと最終ステータスが返されます。同じ最終ステータスが、 Startの呼び出しによって返されるステータスチャネルに送信されます。

適切なプロセス終了

os/exec/Cmd.Wait は、コマンドが強制終了された後でもブロックされる可能性があります。それは驚くべきことであり、問題を引き起こす可能性があります。ただし、 go-cmd/Cmd.Stop驚くことではありませんが、コマンドを確実に終了します。この問題はプロセスグループ ID に関係しています。コマンド PID を強制終了するのが一般的ですが、通常は代わりにそのプロセスグループ ID を強制終了する必要があります。 go-cmd/Cmd.Stopこれを実現するために必要な低レベルのマジックを実装します。