feat: shadow printing (#1)

Author: cmilesio

README.md

@@ -0,0 +1,12 @@
+//go:build !windows
+
+package execx
+
+const (
+	// CreateNewProcessGroup starts the process in a new process group.
+	CreateNewProcessGroup = 0x00000200
+	// CreateNewConsole creates a new console for the process.
+	CreateNewConsole = 0x00000010
+	// CreateNoWindow prevents console windows from being created.
+	CreateNoWindow = 0x08000000
+)

creationflags_nonwindows.go

@@ -0,0 +1,14 @@
+//go:build windows
+
+package execx
+
+import "syscall"
+
+const (
+	// CreateNewProcessGroup starts the process in a new process group.
+	CreateNewProcessGroup = syscall.CREATE_NEW_PROCESS_GROUP
+	// CreateNewConsole creates a new console for the process.
+	CreateNewConsole = syscall.CREATE_NEW_CONSOLE
+	// CreateNoWindow prevents console windows from being created.
+	CreateNoWindow = syscall.CREATE_NO_WINDOW
+)

creationflags_windows.go

@@ -12,8 +12,8 @@ func main() {
 	// Arg appends arguments to the command.
 
 	// Example: add args
-	cmd := execx.Command("go", "env").Arg("GOOS")
+	cmd := execx.Command("printf").Arg("hello")
 	out, _ := cmd.Output()
-	fmt.Println(out != "")
-	// #bool true
+	fmt.Print(out)
+	// hello
 }

examples/arg/main.go

@@ -12,7 +12,11 @@ func main() {
 	// CombinedOutput executes the command and returns stdout+stderr and any error.
 
 	// Example: combined output
-	out, _ := execx.Command("go", "env", "GOOS").CombinedOutput()
-	fmt.Println(out != "")
-	// #bool true
+	out, err := execx.Command("go", "env", "-badflag").CombinedOutput()
+	fmt.Print(out)
+	fmt.Println(err == nil)
+	// flag provided but not defined: -badflag
+	// usage: go env [-json] [-changed] [-u] [-w] [var ...]
+	// Run 'go help env' for details.
+	// false
 }

examples/combinedoutput/main.go

@@ -12,8 +12,8 @@ func main() {
 	// Command constructs a new command without executing it.
 
 	// Example: command
-	cmd := execx.Command("go", "env", "GOOS")
+	cmd := execx.Command("printf", "hello")
 	out, _ := cmd.Output()
-	fmt.Println(out != "")
-	// #bool true
+	fmt.Print(out)
+	// hello
 }

examples/command/main.go

@@ -9,12 +9,10 @@ import (
 )
 
 func main() {
-	// CreationFlags sets Windows creation flags.
+	// CreationFlags sets Windows process creation flags (for example, create a new process group).
 
 	// Example: creation flags
-	fmt.Println(execx.Command("go", "env", "GOOS").CreationFlags(0) != nil)
-	// #bool true
-	// Example: creation flags
-	fmt.Println(execx.Command("go", "env", "GOOS").CreationFlags(0) != nil)
-	// #bool true
+	out, _ := execx.Command("printf", "ok").CreationFlags(execx.CreateNewProcessGroup).Output()
+	fmt.Print(out)
+	// ok
 }

examples/creationflags/main.go

@@ -16,7 +16,7 @@ func main() {
 	// Example: graceful shutdown
 	proc := execx.Command("sleep", "2").Start()
 	_ = proc.GracefulShutdown(os.Interrupt, 100*time.Millisecond)
-	res, err := proc.Wait()
-	fmt.Println(err != nil || res.ExitCode != 0)
+	res, _ := proc.Wait()
+	fmt.Println(res.IsSignal(os.Interrupt))
 	// #bool true
 }

examples/gracefulshutdown/main.go

@@ -9,12 +9,10 @@ import (
 )
 
 func main() {
-	// HideWindow controls window visibility and sets CREATE_NO_WINDOW for console apps.
+	// HideWindow hides console windows and sets CREATE_NO_WINDOW for console apps.
 
 	// Example: hide window
-	fmt.Println(execx.Command("go", "env", "GOOS").HideWindow(true) != nil)
-	// #bool true
-	// Example: hide window
-	fmt.Println(execx.Command("go", "env", "GOOS").HideWindow(true) != nil)
-	// #bool true
+	out, _ := execx.Command("printf", "ok").HideWindow(true).Output()
+	fmt.Print(out)
+	// ok
 }

examples/hidewindow/main.go

@@ -14,7 +14,7 @@ func main() {
 	// Example: interrupt
 	proc := execx.Command("sleep", "2").Start()
 	_ = proc.Interrupt()
-	res, err := proc.Wait()
-	fmt.Println(err != nil || res.ExitCode != 0)
-	// #bool true
+	res, _ := proc.Wait()
+	fmt.Printf("%+v", res)
+	// {Stdout: Stderr: ExitCode:-1 Err:<nil> Duration:75.987ms signal:interrupt}
 }