Package io.karatelabs.process

Class ProcessBuilder

java.lang.Object

io.karatelabs.process.ProcessBuilder

public class ProcessBuilder
extends Object

Builder for ProcessConfig. Provides fluent API for process configuration.

Method Summary

Modifier and Type	Method	Description
ProcessBuilder	args(String... args)
ProcessBuilder	args(List<String> args)
ProcessConfig	build()
static ProcessBuilder	create()
ProcessBuilder	env(String key, String value)
ProcessBuilder	env(Map<String,String> env)
ProcessBuilder	errorListener(Consumer<String> errorListener)
static ProcessBuilder	fromMap(Map<String,Object> options)
ProcessBuilder	line(String command)
ProcessBuilder	listener(Consumer<String> listener)
ProcessBuilder	logToContext(boolean log)
ProcessBuilder	redirectErrorStream(boolean redirect)
ProcessBuilder	timeout(Duration timeout)
ProcessBuilder	timeoutMillis(long millis)
static List<String>	tokenize(String command)	Tokenize a command line string into arguments.
ProcessBuilder	useShell(boolean useShell)
ProcessBuilder	workingDir(String dir)
ProcessBuilder	workingDir(Path dir)
static List<String>	wrapWithShell(List<String> args)	Wrap command with shell for shell features (pipes, env expansion, etc.)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

create

public static ProcessBuilder create()

tokenize

public static List<String> tokenize(String command)

Tokenize a command line string into arguments. Handles single quotes, double quotes, backslash escapes, and whitespace.

Behavior mirrors POSIX shell tokenization: - Single quotes preserve literal content (no escape processing) - Double quotes preserve content (backslash escapes work inside) - Backslash outside quotes escapes any character - Adjacent quoted/unquoted segments merge into single token

wrapWithShell

public static List<String> wrapWithShell(List<String> args)

Wrap command with shell for shell features (pipes, env expansion, etc.)

line

public ProcessBuilder line(String command)

args

public ProcessBuilder args(String... args)

args

public ProcessBuilder args(List<String> args)

workingDir

public ProcessBuilder workingDir(Path dir)

workingDir

public ProcessBuilder workingDir(String dir)

env

public ProcessBuilder env(Map<String,String> env)

env

public ProcessBuilder env(String key,
 String value)

useShell

public ProcessBuilder useShell(boolean useShell)

redirectErrorStream

public ProcessBuilder redirectErrorStream(boolean redirect)

timeout

public ProcessBuilder timeout(Duration timeout)

timeoutMillis

public ProcessBuilder timeoutMillis(long millis)

listener

public ProcessBuilder listener(Consumer<String> listener)

errorListener

public ProcessBuilder errorListener(Consumer<String> errorListener)

logToContext

public ProcessBuilder logToContext(boolean log)

build

public ProcessConfig build()

fromMap

public static ProcessBuilder fromMap(Map<String,Object> options)