Package org.jline.terminal.impl.exec

Class ExecTerminalProvider

java.lang.Object

org.jline.terminal.impl.exec.ExecTerminalProvider

All Implemented Interfaces:

TerminalProvider

public class ExecTerminalProvider
extends Object
implements TerminalProvider

A terminal provider implementation that uses external commands to interact with the terminal.

The ExecTerminalProvider class provides a TerminalProvider implementation that uses external commands (such as stty, tput, etc.) to interact with the terminal. This approach allows JLine to work in environments where native libraries are not available or cannot be used, by relying on standard command-line utilities that are typically available on Unix-like systems.

This provider is typically used as a fallback when more direct methods of terminal interaction (such as JNI or JNA) are not available. While it provides good compatibility, it may have higher overhead due to the need to spawn external processes for many operations.

The provider name is "exec", which can be specified in the org.jline.terminal.provider system property to force the use of this provider.

See Also:

• TerminalProvider
• ExecPty

Constructor Summary

Constructors

Constructor	Description
ExecTerminalProvider()

Method Summary

Modifier and Type	Method	Description
Pty	current(SystemStream systemStream)	Creates a Pty for the current terminal.
boolean	isPosixSystemStream(SystemStream stream)
boolean	isSystemStream(SystemStream stream)	Checks if the specified system stream is available on this platform.
boolean	isWindowsSystemStream(SystemStream stream)
String	name()	Returns the name of this terminal provider.
protected static ProcessBuilder.Redirect	newDescriptor(FileDescriptor fd)
Terminal	newTerminal(String name, String type, InputStream in, OutputStream out, Charset encoding, Terminal.SignalHandler signalHandler, boolean paused, Attributes attributes, Size size)	Creates a new terminal with custom input and output streams.
Terminal	posixSysTerminal(String name, String type, boolean ansiPassThrough, Charset encoding, boolean nativeSignals, Terminal.SignalHandler signalHandler, boolean paused, SystemStream systemStream)	Creates a terminal connected to a system stream on POSIX systems.
String	systemStreamName(SystemStream stream)	Returns the name of the specified system stream on this platform.
int	systemStreamWidth(SystemStream stream)	Returns the width (number of columns) of the specified system stream.
Terminal	sysTerminal(String name, String type, boolean ansiPassThrough, Charset encoding, boolean nativeSignals, Terminal.SignalHandler signalHandler, boolean paused, SystemStream systemStream)	Creates a terminal connected to a system stream.
String	toString()
Terminal	winSysTerminal(String name, String type, boolean ansiPassThrough, Charset encoding, boolean nativeSignals, Terminal.SignalHandler signalHandler, boolean paused, SystemStream systemStream)	Creates a terminal connected to a system stream on Windows.

Methods inherited from class java.lang.Object

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

Constructor Details

ExecTerminalProvider

public ExecTerminalProvider()

Method Details

name

public String name()

Returns the name of this terminal provider.

This method returns the name of this terminal provider, which is "exec". This name can be specified in the org.jline.terminal.provider system property to force the use of this provider.

Specified by:

name in interface TerminalProvider

Returns:

the name of this terminal provider ("exec")

current

public Pty current(SystemStream systemStream)
            throws IOException

Creates a Pty for the current terminal.

This method creates an ExecPty instance for the current terminal by executing the 'tty' command to determine the terminal device name. It is used to obtain a Pty object that can interact with the current terminal using external commands.

Parameters:

systemStream - the system stream to associate with the Pty

Returns:

a new ExecPty instance for the current terminal

Throws:

IOException - if the current terminal is not a TTY or if an error occurs while executing the 'tty' command

sysTerminal

public Terminal sysTerminal(String name,
 String type,
 boolean ansiPassThrough,
 Charset encoding,
 boolean nativeSignals,
 Terminal.SignalHandler signalHandler,
 boolean paused,
 SystemStream systemStream)
                     throws IOException

Creates a terminal connected to a system stream.

This method creates a terminal that is connected to one of the standard system streams (standard input, standard output, or standard error). It uses the ExecPty implementation to interact with the terminal using external commands.

Specified by:

sysTerminal in interface TerminalProvider

Parameters:

name - the name of the terminal

type - the terminal type (e.g., "xterm", "dumb")

ansiPassThrough - whether to pass through ANSI escape sequences

encoding - the character encoding to use

nativeSignals - whether to use native signal handling

signalHandler - the signal handler to use

paused - whether the terminal should start in a paused state

systemStream - the system stream to connect to

Returns:

a new terminal connected to the specified system stream

Throws:

IOException - if an I/O error occurs

winSysTerminal

public Terminal winSysTerminal(String name,
 String type,
 boolean ansiPassThrough,
 Charset encoding,
 boolean nativeSignals,
 Terminal.SignalHandler signalHandler,
 boolean paused,
 SystemStream systemStream)
                        throws IOException

Creates a terminal connected to a system stream on Windows.

This method creates a terminal that is connected to one of the standard system streams on Windows. It uses the ExecPty implementation to interact with the terminal using external commands.

Note that on Windows, the exec provider has limited functionality and may not work as well as the native providers (JNI, JNA, etc.).

Parameters:

name - the name of the terminal

type - the terminal type (e.g., "xterm", "dumb")

ansiPassThrough - whether to pass through ANSI escape sequences

encoding - the character encoding to use

nativeSignals - whether to use native signal handling

signalHandler - the signal handler to use

paused - whether the terminal should start in a paused state

systemStream - the system stream to connect to

Returns:

a new terminal connected to the specified system stream

Throws:

IOException - if an I/O error occurs

posixSysTerminal

public Terminal posixSysTerminal(String name,
 String type,
 boolean ansiPassThrough,
 Charset encoding,
 boolean nativeSignals,
 Terminal.SignalHandler signalHandler,
 boolean paused,
 SystemStream systemStream)
                          throws IOException

Creates a terminal connected to a system stream on POSIX systems.

This method creates a terminal that is connected to one of the standard system streams on POSIX systems (Linux, macOS, etc.). It uses the ExecPty implementation to interact with the terminal using external commands.

Parameters:

name - the name of the terminal

type - the terminal type (e.g., "xterm", "dumb")

ansiPassThrough - whether to pass through ANSI escape sequences

encoding - the character encoding to use

nativeSignals - whether to use native signal handling

signalHandler - the signal handler to use

paused - whether the terminal should start in a paused state

systemStream - the system stream to connect to

Returns:

a new terminal connected to the specified system stream

Throws:

IOException - if an I/O error occurs

newTerminal

public Terminal newTerminal(String name,
 String type,
 InputStream in,
 OutputStream out,
 Charset encoding,
 Terminal.SignalHandler signalHandler,
 boolean paused,
 Attributes attributes,
 Size size)
                     throws IOException

Creates a new terminal with custom input and output streams.

This method creates a terminal that is connected to the specified input and output streams. It creates an ExternalTerminal that emulates the line discipline functionality typically provided by the operating system's terminal driver.

Specified by:

newTerminal in interface TerminalProvider

Parameters:

name - the name of the terminal

type - the terminal type (e.g., "xterm", "dumb")

in - the input stream to read from

out - the output stream to write to

encoding - the character encoding to use

signalHandler - the signal handler to use

paused - whether the terminal should start in a paused state

attributes - the initial terminal attributes

size - the initial terminal size

Returns:

a new terminal connected to the specified streams

Throws:

IOException - if an I/O error occurs

isSystemStream

public boolean isSystemStream(SystemStream stream)

Checks if the specified system stream is available on this platform.

This method determines whether the specified system stream (standard input, standard output, or standard error) is available for use on the current platform. It checks both POSIX and Windows system streams.

Specified by:

isSystemStream in interface TerminalProvider

Parameters:

stream - the system stream to check

Returns:

true if the system stream is available, false otherwise

isWindowsSystemStream

public boolean isWindowsSystemStream(SystemStream stream)

isPosixSystemStream

public boolean isPosixSystemStream(SystemStream stream)

systemStreamName

public String systemStreamName(SystemStream stream)

Returns the name of the specified system stream on this platform.

This method returns a platform-specific name or identifier for the specified system stream. The name may be used for display purposes or for accessing the stream through platform-specific APIs.

Specified by:

systemStreamName in interface TerminalProvider

Parameters:

stream - the system stream

Returns:

the name of the system stream on this platform

systemStreamWidth

public int systemStreamWidth(SystemStream stream)

Returns the width (number of columns) of the specified system stream.

This method determines the width of the terminal associated with the specified system stream. The width is measured in character cells and represents the number of columns available for display.

This implementation uses the 'tput cols' command to determine the terminal width. If the command fails or returns an invalid value, a default width of 80 columns is returned.

Specified by:

systemStreamWidth in interface TerminalProvider

Parameters:

stream - the system stream

Returns:

the width of the system stream in character columns

newDescriptor

protected static ProcessBuilder.Redirect newDescriptor(FileDescriptor fd)

toString

public String toString()

Overrides:

toString in class Object