Package org.jline.reader
package org.jline.reader
JLine 3 Reader Package - Core components for building interactive command-line interfaces.
This package provides the fundamental interfaces and classes for creating interactive command-line applications with features such as:
- Line editing with customizable key bindings
- Command history navigation
- Tab completion with pluggable completion strategies
- Customizable syntax highlighting
- Password masking
- Custom prompt rendering
- Command parsing and tokenization
The main entry point is the LineReader
interface, which can be
instantiated using the LineReaderBuilder
. The LineReader provides
methods to read input from the user with various customization options.
Key components in this package include:
LineReader
- The main interface for reading lines from the consoleLineReaderBuilder
- Builder for creating LineReader instancesParser
- Interface for parsing command lines into tokensCompleter
- Interface for providing tab-completion candidatesHighlighter
- Interface for syntax highlightingHistory
- Interface for command history management
- Since:
- 3.0
-
ClassDescriptionMarker interface for objects that can be bound to key sequences in a KeyMap.Represents the editable text buffer in the LineReader.Represents a completion candidate for tab completion.A completer is the mechanism by which tab-completion candidates will be resolved.An extension of
ParsedLine
that, being aware of the quoting and escaping rules of theParser
that produced it, knows if and how a completion candidate should be escaped/quoted.Interface for matching and filtering completion candidates.Interface for launching external editors from within a JLine application.This exception is thrown byLineReader.readLine()
when user the user types ctrl-D).Exception thrown when parsing is incomplete due to unexpected end of input.The Expander interface provides functionality for expanding special syntax in command lines.The Highlighter interface provides syntax highlighting functionality for the LineReader.Console command history management interface.Represents a single history entry containing a command line and its metadata.Read lines from the console, with input editing.A builder for creating and configuringLineReader
instances.A macro that executes a sequence of keystrokes when invoked.Callback used to mask parts of the line for sensitive input like passwords.ParsedLine
objects are returned by theParser
during completion or when accepting the line.The Parser interface is responsible for parsing command lines into tokens.Redirects aWriter
to aLineReader
'sLineReader.printAbove(String)
method, which draws output above the current prompt / input line.A reference to aWidget
by name.Exception thrown when a syntax error is encountered during parsing.This exception is thrown byLineReader.readLine()
when user interrupt handling is enabled and the user types the interrupt character (ctrl-C).A Widget represents an action that can be bound to a key sequence in the LineReader.