Package net.hydromatic.morel

Class Shell

java.lang.Object

net.hydromatic.morel.Shell

public class Shell
extends Object

Command shell for ML, powered by JLine3.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	Shell.Config	Shell configuration.
private static class	Shell.ConfigImpl	Implementation of Shell.Config.
(package private) static interface	Shell.LineFn	Abstraction of a terminal's line reader.
(package private) static class	Shell.LineType	Type of line from Shell.LineFn.
(package private) static class	Shell.ReaderLineFn	Implementation of Shell.LineFn that reads from a reader.
(package private) static class	Shell.SubShell	Simplified shell that works in both interactive mode (where input and output is a terminal) and batch mode (where input is a file, and output is to an array of lines).
private static class	Shell.TerminalLineFn	Implementation of Shell.LineFn that reads from JLine's terminal.

Field Summary

Fields

Modifier and Type	Field	Description
private Shell.ConfigImpl	config
private org.jline.terminal.Terminal	terminal

Constructor Summary

Constructors

Constructor	Description
Shell(Shell.Config config, org.jline.terminal.Terminal terminal)	Creates a Shell.

Method Summary

Modifier and Type	Method	Description
private String	banner()	Generates a banner to be shown on startup.
private static boolean	canIgnoreLine(StringBuilder buf, String line)	Returns whether we can ignore a line.
static Shell	create(List<String> args, InputStream in, OutputStream out)	Creates a Shell.
static Shell	create(Shell.Config config, InputStream in, OutputStream out)	Creates a Shell.
(package private) static void	help(Consumer<String> outLines)
private static <T> T	instantiate(String className, Class<T> clazz)	Instantiates a class.
static void	main(String[] args)	Command-line entry point.
static Shell.Config	parse(Shell.Config config, List<String> argList)	Parses an argument list to an equivalent Config.
protected void	pause()	Pauses after creating the terminal.
void	run()
(package private) static void	usage(Consumer<String> outLines)

Methods inherited from class java.lang.Object

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

Field Detail

config

private final Shell.ConfigImpl config

terminal

private final org.jline.terminal.Terminal terminal

Constructor Detail

Shell

public Shell(Shell.Config config,
             org.jline.terminal.Terminal terminal)

Creates a Shell.

Method Detail

main

public static void main(String[] args)

Command-line entry point.

Parameters:

args - Command-line arguments

create

public static Shell create(List<String> args,
                           InputStream in,
                           OutputStream out)
                    throws IOException

Creates a Shell.

Throws:

IOException

create

public static Shell create(Shell.Config config,
                           InputStream in,
                           OutputStream out)
                    throws IOException

Creates a Shell.

Throws:

IOException

parse

public static Shell.Config parse(Shell.Config config,
                                 List<String> argList)

Parses an argument list to an equivalent Config.

usage

static void usage(Consumer<String> outLines)

help

static void help(Consumer<String> outLines)

pause

protected final void pause()

Pauses after creating the terminal.

Calls the value set by Shell.Config.withPauseFn(Runnable) which, for the default config, does nothing; the instance used in testing pauses for a few milliseconds, which gives classes time to load and makes test deterministic.

canIgnoreLine

private static boolean canIgnoreLine(StringBuilder buf,
                                     String line)

Returns whether we can ignore a line. We can ignore a line if it consists only of comments, spaces, and optionally semicolon, and if we are not on a continuation line.

banner

private String banner()

Generates a banner to be shown on startup.

run

public void run()

instantiate

@Nonnull
private static <T> T instantiate(String className,
                                 Class<T> clazz)

Instantiates a class.

Assumes that the class has a public no-arguments constructor.