Add withcontext.go

Author: devlights

internal/examples/basic/cmdexec/README.md

@@ -7,3 +7,4 @@
 |oneshot.go|cmdexec\_oneshot|コマンドを一発実行して結果を取得するサンプルです|
 |oneshotwithstderr.go|cmdexec\_oneshot\_with\_stderr|コマンドを一発実行して結果を取得するサンプルです。(標準エラー出力も含む)|
 |stdinouterr.go|cmdexec\_stdinouterr|標準入力・標準出力・標準エラー出力を指定してコマンドを実行するサンプルです|
+|withcontext.go|cmdexec\_withcontext|コマンドを context.Context 付きで実行するサンプルです|

internal/examples/basic/cmdexec/examples.go

@@ -18,4 +18,5 @@ func (r *register) Regist(m mappings.ExampleMapping) {
 	m["cmdexec_oneshot"] = OneShot
 	m["cmdexec_oneshot_with_stderr"] = OneShotWithStderr
 	m["cmdexec_stdinouterr"] = Stdinouterr
+	m["cmdexec_withcontext"] = WithContext
 }

internal/examples/basic/cmdexec/withcontext.go

@@ -0,0 +1,53 @@
+package cmdexec
+
+import (
+	"context"
+	"errors"
+	"os/exec"
+	"runtime"
+	"time"
+
+	"github.com/devlights/gomy/output"
+)
+
+// WithContext は、context.Context 付きでコマンドを実行するサンプルです。
+func WithContext() error {
+	if runtime.GOOS == "windows" {
+		return errors.New("this example cannot run on Windows, sorry")
+	}
+
+	const (
+		Shell = "/bin/bash"
+	)
+
+	var (
+		rootCtx          = context.Background()
+		mainCtx, mainCxl = context.WithCancel(rootCtx)
+		procCtx, procCxl = context.WithTimeout(mainCtx, 500*time.Millisecond)
+	)
+
+	defer mainCxl()
+	defer procCxl()
+
+	var (
+		cmd *exec.Cmd
+		out []byte
+		err error
+	)
+
+	cmd = exec.CommandContext(procCtx, Shell, "-c", "sleep 1; echo ...done...")
+	out, err = cmd.Output()
+	if err != nil {
+		var exitErr *exec.ExitError
+		if errors.Is(procCtx.Err(), context.DeadlineExceeded) && errors.As(err, &exitErr) {
+			output.Stdoutf("[timeout]", "%[1]v(%[1]T)\n", err)
+			return nil
+		} else {
+			return err
+		}
+	}
+
+	output.Stdoutl("[output]", string(out))
+
+	return nil
+}