com.rultor.shell

Class Terminal

java.lang.Object

com.rultor.shell.Terminal

@Immutable
@Loggable(value=1)
public final class Terminal
extends Object

Simplified terminal.

Since:

1.0

Version:

$Id$

Author:

Yegor Bugayenko (yegor@tpc2.com)

Constructor Summary

Constructors

Constructor and Description
Terminal(Shell shl) Public ctor.

Method Summary

Methods

Modifier and Type	Method and Description
static String	escape(String arg) Escape argument.
String	exec(String command) Run this command and return its output (fail on non-zero exit code).
String	exec(String command, String stdin) Run this command and return its output (fail on non-zero exit code).
static String	quotate(String arg) Quotate argument.

Methods inherited from class java.lang.Object

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

Constructor Detail

Terminal

public Terminal(@NotNull(message="shell can\'t be NULL")
        Shell shl)

Public ctor.

Parameters:

shl - Shell to use

Method Detail

escape

public static String escape(@NotNull(message="argument can\'t be NULL")
            String arg)

Escape argument.

Parameters:

arg - Argument

Returns:

Escaped

To do:

#34 This implementation is extremely bad and doesn't comply with any standards. Let's find out what is the right way to escape strings for BASH and implement it here

quotate

public static String quotate(@NotNull(message="argument can\'t be NULL")
             String arg)

Quotate argument.

Parameters:

arg - Argument

Returns:

Quotated

exec

@Loggable(value=1,
          limit=2147483647,
          ignore=java.io.IOException.class)
public String exec(@NotNull(message="command can\'t be NULL")
                                                            String command)
            throws IOException

Run this command and return its output (fail on non-zero exit code).

Parameters:

command - The command

Returns:

Output stream

Throws:

IOException - If some IO problem inside

exec

@Loggable(value=1,
          limit=2147483647,
          ignore=java.io.IOException.class)
public String exec(@NotNull(message="command can\'t be NULL")
                                                            String command,
                                                            @NotNull(message="stdin can\'t be NULL")
                                                            String stdin)
            throws IOException

Run this command and return its output (fail on non-zero exit code).

Parameters:

command - The command

stdin - Input stream

Returns:

Output stream

Throws:

IOException - If some IO problem inside