Class SystemHighlighter

java.lang.Object

org.jline.reader.impl.DefaultHighlighter

org.jline.console.impl.SystemHighlighter

All Implemented Interfaces:

Highlighter

public class SystemHighlighter
extends DefaultHighlighter

Highlighter implementation that provides syntax highlighting for commands and languages.

SystemHighlighter extends DefaultHighlighter to provide syntax highlighting for:

• Command syntax (command names, options, arguments)
• Programming language syntax (for various languages)
• File content based on file extensions

The highlighter uses nanorc syntax definitions for highlighting, making it compatible with existing nanorc configuration files. It can be customized with different styles and supports dynamic refreshing of highlighting rules.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static class	SystemHighlighter.FileHighlightCommand

Field Summary

Fields

Modifier and Type	Field	Description
protected final SyntaxHighlighter	argsHighlighter
protected final SyntaxHighlighter	commandHighlighter
protected int	commandIndex
protected final Map<String, SystemHighlighter.FileHighlightCommand>	fileHighlight
protected final SyntaxHighlighter	langHighlighter
protected final Map<String, SyntaxHighlighter>	specificHighlighter
protected final SystemRegistry	systemRegistry

Fields inherited from class DefaultHighlighter

errorIndex, errorPattern

Constructor Summary

Constructors

Constructor	Description
SystemHighlighter(SyntaxHighlighter commandHighlighter, SyntaxHighlighter argsHighlighter, SyntaxHighlighter langHighlighter)

Method Summary

Modifier and Type	Method	Description
void	addExternalHighlighterRefresh(Supplier<Boolean> refresh)
void	addFileHighlight(String... commands)
void	addFileHighlight(String command, String subcommand, Collection<String> fileOptions)
protected AttributedString	doCommandHighlight(String buffer)
protected AttributedString	doFileArgsHighlight(LineReader reader, String buffer, List<String> words, SystemHighlighter.FileHighlightCommand fhc)
protected AttributedString	doFileOptsHighlight(LineReader reader, String buffer, List<String> words, SystemHighlighter.FileHighlightCommand fhc)
AttributedString	highlight(LineReader reader, String buffer)	Highlights the provided text buffer with appropriate styling.
void	refresh(LineReader lineReader)	Refreshes the highlighter's configuration.
void	setSpecificHighlighter(String command, SyntaxHighlighter highlighter)
protected AttributedString	systemHighlight(LineReader reader, String buffer)

Methods inherited from class DefaultHighlighter

commandStyle, setErrorIndex, setErrorPattern

Methods inherited from class Object

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

Field Details

commandHighlighter

protected final SyntaxHighlighter commandHighlighter

argsHighlighter

protected final SyntaxHighlighter argsHighlighter

langHighlighter

protected final SyntaxHighlighter langHighlighter

systemRegistry

protected final SystemRegistry systemRegistry

fileHighlight

protected final Map<String, SystemHighlighter.FileHighlightCommand> fileHighlight

specificHighlighter

protected final Map<String, SyntaxHighlighter> specificHighlighter

commandIndex

protected int commandIndex

Constructor Details

SystemHighlighter

public SystemHighlighter(SyntaxHighlighter commandHighlighter,
 SyntaxHighlighter argsHighlighter,
 SyntaxHighlighter langHighlighter)

Method Details

setSpecificHighlighter

public void setSpecificHighlighter(String command,
 SyntaxHighlighter highlighter)

refresh

public void refresh(LineReader lineReader)

Description copied from interface: Highlighter

Refreshes the highlighter's configuration.

This method is called when the highlighter should reload or refresh its configuration, such as when color schemes change or when syntax rules are updated. The default implementation does nothing.

Parameters:

lineReader - The LineReader instance associated with this highlighter

addExternalHighlighterRefresh

public void addExternalHighlighterRefresh(Supplier<Boolean> refresh)

highlight

public AttributedString highlight(LineReader reader,
 String buffer)

Description copied from interface: Highlighter

Highlights the provided text buffer with appropriate styling.

This method is called by the LineReader to apply syntax highlighting to the current input line. It should analyze the buffer content and return an AttributedString with appropriate styling applied based on the content's syntax, structure, or other relevant characteristics.

Specified by:

highlight in interface Highlighter

Overrides:

highlight in class DefaultHighlighter

Parameters:

reader - The LineReader instance requesting highlighting

buffer - The text buffer to be highlighted

Returns:

An AttributedString containing the highlighted buffer with styling applied

addFileHighlight

public void addFileHighlight(String... commands)

addFileHighlight

public void addFileHighlight(String command,
 String subcommand,
 Collection<String> fileOptions)

systemHighlight

protected AttributedString systemHighlight(LineReader reader,
 String buffer)

doFileOptsHighlight

protected AttributedString doFileOptsHighlight(LineReader reader,
 String buffer,
 List<String> words,
 SystemHighlighter.FileHighlightCommand fhc)

doFileArgsHighlight

protected AttributedString doFileArgsHighlight(LineReader reader,
 String buffer,
 List<String> words,
 SystemHighlighter.FileHighlightCommand fhc)

doCommandHighlight

protected AttributedString doCommandHighlight(String buffer)