Getting Started with Æsh Readline

<dependency>
  <groupId>org.aesh</groupId>
  <artifactId>readline</artifactId>
  <version>3.5</version>
</dependency>

dependencies {
    implementation 'org.aesh:readline:3.5'
}

import org.aesh.readline.Readline;
import org.aesh.readline.ReadlineBuilder;
import org.aesh.tty.terminal.TerminalConnection;

public class SimpleExample {

    public static void main(String... args) {
        TerminalConnection connection = new TerminalConnection();
        Readline readline = ReadlineBuilder.builder().enableHistory(false).build();
        
        read(connection, readline, "[prompt]$ ");
        connection.openBlocking();
    }

    private static void read(TerminalConnection connection, Readline readline, String prompt) {
        readline.readline(connection, prompt, input -> {
            if (input != null && input.equals("exit")) {
                connection.write("Goodbye!\n");
                connection.close();
            }
            else {
                connection.write("You entered: " + input + "\n");
                read(connection, readline, prompt);
            }
        });
    }
}

import org.aesh.readline.Readline;
import org.aesh.readline.ReadlineBuilder;
import org.aesh.readline.history.FileHistory;
import org.aesh.tty.terminal.TerminalConnection;
import java.io.File;

public class HistoryExample {

    public static void main(String... args) {
        TerminalConnection connection = new TerminalConnection();
        
        Readline readline = ReadlineBuilder.builder()
                .history(new FileHistory(new File(".history"), 100))
                .build();
        
        read(connection, readline, "[history]$ ");
        connection.openBlocking();
    }

    private static void read(TerminalConnection connection, Readline readline, String prompt) {
        readline.readline(connection, prompt, input -> {
            if (input != null && input.equals("exit")) {
                connection.close();
            }
            else {
                connection.write("Echo: " + input + "\n");
                read(connection, readline, prompt);
            }
        });
    }
}

import org.aesh.readline.Readline;
import org.aesh.readline.ReadlineBuilder;
import org.aesh.readline.completion.Completion;
import org.aesh.tty.terminal.TerminalConnection;
import java.util.Arrays;
import java.util.List;

public class CompletionExample {

    public static void main(String... args) {
        TerminalConnection connection = new TerminalConnection();
        
        List<Completion> completions = Arrays.asList(
                new Completion("hello", "Say hello"),
                new Completion("goodbye", "Say goodbye"),
                new Completion("exit", "Exit the program")
        );
        
        Readline readline = ReadlineBuilder.builder()
                .enableHistory(true)
                .build();
        
        read(connection, readline, "[prompt]$ ", completions);
        connection.openBlocking();
    }

    private static void read(TerminalConnection connection, Readline readline, 
                            String prompt, List<Completion> completions) {
        readline.readline(connection, prompt, completions, input -> {
            if (input != null) {
                if (input.equals("exit")) {
                    connection.close();
                }
                else if (input.equals("hello")) {
                    connection.write("Hello!\n");
                }
                else if (input.equals("goodbye")) {
                    connection.write("Goodbye!\n");
                }
                read(connection, readline, prompt, completions);
            }
        });
    }
}