org.jruby.util

Class ShellLauncher

java.lang.Object

org.jruby.util.ShellLauncher

public class ShellLauncher
extends Object

This mess of a class is what happens when all Java gives you is Runtime.getRuntime().exec(). Thanks dude, that really helped.

Author:

nicksieger

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ShellLauncher.LaunchConfig
static class	ShellLauncher.POpenProcess

Constructor Summary

Constructors

Constructor and Description
ShellLauncher()

Method Summary

Methods

Modifier and Type	Method and Description
static Process	buildProcess(Ruby runtime, String[] args, String[] env, File pwd)
static int	execAndWait(Ruby runtime, IRubyObject[] rawArgs)
static int	execAndWait(Ruby runtime, IRubyObject[] rawArgs, Map mergeEnv)
static String[]	getCurrentEnv(Ruby runtime)
static long	getPidFromProcess(Process process)
static ShellLauncher.POpenProcess	popen(Ruby runtime, IRubyObject[] strings, Map env, IOOptions modes) Deprecated.
static ShellLauncher.POpenProcess	popen(Ruby runtime, IRubyObject[] strings, Map env, ModeFlags modes)
static ShellLauncher.POpenProcess	popen(Ruby runtime, IRubyObject string, IOOptions modes) Deprecated.
static ShellLauncher.POpenProcess	popen(Ruby runtime, IRubyObject string, Map env, ModeFlags modes)
static ShellLauncher.POpenProcess	popen(Ruby runtime, IRubyObject string, ModeFlags modes)
static ShellLauncher.POpenProcess	popen3(Ruby runtime, IRubyObject[] strings)
static ShellLauncher.POpenProcess	popen3(Ruby runtime, IRubyObject[] strings, boolean addShell)
static long	reflectPidFromProcess(Process process)
static Process	run(Ruby runtime, IRubyObject string)
static Process	run(Ruby runtime, IRubyObject[] rawArgs, boolean doExecutableSearch)
static Process	run(Ruby runtime, IRubyObject[] rawArgs, boolean doExecutableSearch, boolean forceExternalProcess)
static int	runAndWait(Ruby runtime, IRubyObject[] rawArgs)
static int	runAndWait(Ruby runtime, IRubyObject[] rawArgs, OutputStream output)
static int	runAndWait(Ruby runtime, IRubyObject[] rawArgs, OutputStream output, boolean doExecutableSearch)
static long[]	runAndWaitPid(Ruby runtime, IRubyObject[] rawArgs)
static long[]	runAndWaitPid(Ruby runtime, IRubyObject[] rawArgs, OutputStream output, boolean doExecutableSearch)
static long	runExternal(Ruby runtime, IRubyObject env, IRubyObject prog, IRubyObject options, IRubyObject args, boolean wait)
static int	runExternalAndWait(Ruby runtime, IRubyObject[] rawArgs, Map mergeEnv)
static long	runExternalWithoutWait(Ruby runtime, IRubyObject[] rawArgs)
static long	runExternalWithoutWait(Ruby runtime, IRubyObject env, IRubyObject prog, IRubyObject options, IRubyObject args)
static long	runWithoutWait(Ruby runtime, IRubyObject[] rawArgs)
static boolean	shouldUseShell(String command)
static InputStream	unwrapBufferedStream(InputStream filteredStream) Unwrap all filtering streams between the given stream and its actual unfiltered stream.
static OutputStream	unwrapBufferedStream(OutputStream filteredStream) Unwrap all filtering streams between the given stream and its actual unfiltered stream.

Methods inherited from class java.lang.Object

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

Constructor Detail

ShellLauncher

public ShellLauncher()

Method Detail

getCurrentEnv

public static String[] getCurrentEnv(Ruby runtime)

runAndWait

public static int runAndWait(Ruby runtime,
             IRubyObject[] rawArgs)

runAndWaitPid

public static long[] runAndWaitPid(Ruby runtime,
                   IRubyObject[] rawArgs)

runWithoutWait

public static long runWithoutWait(Ruby runtime,
                  IRubyObject[] rawArgs)

runExternalAndWait

public static int runExternalAndWait(Ruby runtime,
                     IRubyObject[] rawArgs,
                     Map mergeEnv)

runExternalWithoutWait

public static long runExternalWithoutWait(Ruby runtime,
                          IRubyObject env,
                          IRubyObject prog,
                          IRubyObject options,
                          IRubyObject args)

runExternal

public static long runExternal(Ruby runtime,
               IRubyObject env,
               IRubyObject prog,
               IRubyObject options,
               IRubyObject args,
               boolean wait)

buildProcess

public static Process buildProcess(Ruby runtime,
                   String[] args,
                   String[] env,
                   File pwd)
                            throws IOException

Throws:

IOException

runExternalWithoutWait

public static long runExternalWithoutWait(Ruby runtime,
                          IRubyObject[] rawArgs)

execAndWait

public static int execAndWait(Ruby runtime,
              IRubyObject[] rawArgs)

execAndWait

public static int execAndWait(Ruby runtime,
              IRubyObject[] rawArgs,
              Map mergeEnv)

runAndWait

public static int runAndWait(Ruby runtime,
             IRubyObject[] rawArgs,
             OutputStream output)

runAndWait

public static int runAndWait(Ruby runtime,
             IRubyObject[] rawArgs,
             OutputStream output,
             boolean doExecutableSearch)

runAndWaitPid

public static long[] runAndWaitPid(Ruby runtime,
                   IRubyObject[] rawArgs,
                   OutputStream output,
                   boolean doExecutableSearch)

getPidFromProcess

public static long getPidFromProcess(Process process)

reflectPidFromProcess

public static long reflectPidFromProcess(Process process)

run

public static Process run(Ruby runtime,
          IRubyObject string)
                   throws IOException

Throws:

IOException

popen

public static ShellLauncher.POpenProcess popen(Ruby runtime,
                               IRubyObject string,
                               ModeFlags modes)
                                        throws IOException

Throws:

IOException

popen

public static ShellLauncher.POpenProcess popen(Ruby runtime,
                               IRubyObject[] strings,
                               Map env,
                               ModeFlags modes)
                                        throws IOException

Throws:

IOException

popen

public static ShellLauncher.POpenProcess popen(Ruby runtime,
                               IRubyObject string,
                               Map env,
                               ModeFlags modes)
                                        throws IOException

Throws:

IOException

popen

@Deprecated
public static ShellLauncher.POpenProcess popen(Ruby runtime,
                                          IRubyObject string,
                                          IOOptions modes)
                                        throws IOException

Deprecated.

Throws:

IOException

popen

@Deprecated
public static ShellLauncher.POpenProcess popen(Ruby runtime,
                                          IRubyObject[] strings,
                                          Map env,
                                          IOOptions modes)
                                        throws IOException

Deprecated.

Throws:

IOException

popen3

public static ShellLauncher.POpenProcess popen3(Ruby runtime,
                                IRubyObject[] strings)
                                         throws IOException

Throws:

IOException

popen3

public static ShellLauncher.POpenProcess popen3(Ruby runtime,
                                IRubyObject[] strings,
                                boolean addShell)
                                         throws IOException

Throws:

IOException

unwrapBufferedStream

public static OutputStream unwrapBufferedStream(OutputStream filteredStream)

Unwrap all filtering streams between the given stream and its actual unfiltered stream. This is primarily to unwrap streams that have buffers that would interfere with interactivity.

Parameters:

filteredStream - The stream to unwrap

Returns:

An unwrapped stream, presumably unbuffered

unwrapBufferedStream

public static InputStream unwrapBufferedStream(InputStream filteredStream)

Unwrap all filtering streams between the given stream and its actual unfiltered stream. This is primarily to unwrap streams that have buffers that would interfere with interactivity.

Parameters:

filteredStream - The stream to unwrap

Returns:

An unwrapped stream, presumably unbuffered

run

public static Process run(Ruby runtime,
          IRubyObject[] rawArgs,
          boolean doExecutableSearch)
                   throws IOException

Throws:

IOException

run

public static Process run(Ruby runtime,
          IRubyObject[] rawArgs,
          boolean doExecutableSearch,
          boolean forceExternalProcess)
                   throws IOException

Throws:

IOException

shouldUseShell

public static boolean shouldUseShell(String command)