readline prompt: Read (multi-line) input from the user with rich editing abilities. Takes the prompt text as an argument. The full prompt is the combination of the given prompt and the prompt marker ("> " by default) . See also readlineEx, readlineMaybe, enableMultiline, and setPromptMarker.

readlineEx prompt mbCompleter mbHighlighter: as readline but uses the given mbCompleter function to complete words on tab (instead of the default completer). and the given mbHighlighter function to highlight the input (instead of the default highlighter). See also readline and readlineExMaybe.

setHistory filename maxEntries: Enable history that is persisted to the given file path with a given maximum number of entries. Use -1 for the default entries (200). See also enableHistoryDuplicates.

Clear the history.

Isocline automatically adds input of more than 1 character to the history. This command removes the last entry.

historyAdd entry: add entry to the history.

Abstract list of current completions.

completeFileName compls input dirSep roots extensions: Complete filenames with the given input, a possible directory separator dirSep, a list of root folders roots to search from (by default ["."]), and a list of extensions to match (use [] to match any extension). The directory separator is used when completing directory names. For example, using g '/' as a directory separator, we get:

/ho         --> /home/
/home/.ba   --> /home/.bashrc

completeWord compl input isWordChar completer: Complete a word (or token) and calls the user completer function with just the current word (instead of the whole input) Takes the CompletionEnv environment compl, the current input, an possible isWordChar function, and a user defined completer function that is called with adjusted input which is limited to the word just before the cursor. Pass Nothing to isWordChar for the default not . separator where separator = c -> c elem " \t\r\n,.;:/\\(){}[]".

completeQuotedWord compl input isWordChar completer: Complete a word taking care of automatically quoting and escaping characters. Takes the CompletionEnv environment compl, the current input, and a user defined completer function that is called with adjusted input which is unquoted, unescaped, and limited to the word just before the cursor. For example, with a hello world completion, we get:

hel        -->  hello\ world
hello\ w   -->  hello\ world
hello w    -->                   # no completion, the word is just 'w'>
"hel       -->  "hello world" 
"hello w   -->  "hello world"

The call (completeWord compl prefx isWordChar fun) is a short hand for (completeQuotedWord compl prefx isWordChar '\\' "'\"" fun). Pass Nothing to isWordChar for the default not . separator where separator = c -> c elem " \t\r\n,.;:/\\(){}[]".

completeQuotedWordEx compl input isWordChar escapeChar quoteChars completer: Complete a word taking care of automatically quoting and escaping characters. Takes the CompletionEnv environment compl, the current input, and a user defined completer function that is called with adjusted input which is unquoted, unescaped, and limited to the word just before the cursor. Unlike completeQuotedWord, this function can specify the escape character and the quote characters. See also completeWord.

A completion entry

Create a completion with just a replacement

Is the given input a prefix of the completion replacement?

completionsFor input replacements: Filter those replacements that start with the given input, and return them as completions.

Convenience: creates a completer function directly from a list of candidate completion strings. Uses completionsFor to filter the input and completeWord to find the word boundary. For example: readlineEx "myprompt" (Just (wordCompleter completer)) Nothing.

Use an rich text formatted highlighter from inside a highlighter callback.

A style for formatted strings (Fmt). For example, a style can be "red" or "b #7B3050". See the full list of valid properties

A string with bbcode formatting. For example "[red]this is red[/]".n

Style a string, e.g. style "b red" "bold and red" (which is equivalent to "[b red]bold and red[/]"). See the repo for a full description of all styles.

Escape a string so no tags are interpreted as formatting.

Style a string that is printed as is without interpreting markup inside it (using plain).

Output rich formatted text containing bbcode. For example: putFmt "[b]bold [red]and red[/][/]" All unclosed tags are automatically closed (but see also styleOpen). See the repo for more information about formatted output.

Output rich formatted text containing bbcode's ending with a newline.

Define (or redefine) a style. For example styleDef "warning" "crimon underline", and then use it as putFmtLn "[warning]this is a warning[/]". This can be very useful for theming your application with semantic styles. See also formatted output

Open a style that is active for all putFmt and putFmtLn until it is closed again (styleClose).

Close a previously opened style.

Use a style over an action.

setPromptMarker marker multiline_marker: Set the prompt marker (by default "> "). and a possible different continuation prompt marker multiline_marker for multiline input (defaults to marker).

Disable or enable automatic tab completion after a completion to expand as far as possible if the completions are unique. (disabled by default). Returns the previous value.

Disable or enable color output (enabled by default). Returns the previous value.

Disable or enable sound (enabled by default). | A beep is used when tab cannot find any completion for example. Returns the previous value.

Disable or enable multi-line input (enabled by default). Returns the previous value.

Disable or enable duplicate entries in the history (duplicate entries are not allowed by default). Returns the previous value.

Disable or enable preview of a completion selection (enabled by default) Returns the previous value.

Disable or enable automatic indentation to line up the multiline prompt marker with the initial prompt marker (enabled by default). Returns the previous value. See also setPromptMarker.

Disable or enable syntax highlighting (enabled by default). Returns the previous value.

Disable or enable short inline help message (for history search etc.) (enabled by default). Pressing F1 always shows full help regardless of this setting. Returns the previous value.

Disable or enable automatic inline hinting (enabled by default) Returns the previous value.

Set the delay in milliseconds before a hint is displayed (500ms by default) See also enableHint

Disable or enable brace matching (enabled by default) Returns the previous value.

Disable or enable automatic close brace insertion (enabled by default) Returns the previous value.

Set pairs of matching braces, by default "(){}[]".

Set pairs of auto insertion braces, by default "(){}[]\"\"''".

setDefaultCompleter completer: Set a new tab-completion function completer that is called by Isocline automatically. The callback is called with a CompletionEnv context and the current user input up to the cursor. By default the completeFileName completer is used. This overwrites any previously set completer.

addCompletion compl completion: Inside a completer callback, add a new completion. If addCompletion returns True keep adding completions, but if it returns False an effort should be made to return from the completer callback without adding more completions.

addCompletionPrim compl completion deleteBefore deleteAfter: Primitive add completion, use with care and call only directly inside a completer callback. If addCompletion returns True keep adding completions, but if it returns False an effort should be made to return from the completer callback without adding more completions.

addCompletions compl completions: add multiple completions at once. If addCompletions returns True keep adding completions, but if it returns False an effort should be made to return from the completer callback without adding more completions.

completeWord compl input isWordChar completer: Complete a word,token and calls the user completer function with just the current word (instead of the whole input) Takes the CompletionEnv environment compl, the current input, an possible isWordChar function, and a user defined completer function that is called with adjusted input which is limited to the word just before the cursor. Pass Nothing to isWordChar for the default not . separator where separator = c -> c elem " \t\r\n,.;:/\\(){}[]".

completeWordPrim compl input isWordChar completer: Complete a word taking care of automatically quoting and escaping characters. Takes the CompletionEnv environment compl, the current input, and a user defined completer function that is called with adjusted input which is unquoted, unescaped, and limited to the word just before the cursor. For example, with a hello world completion, we get:

hel        -->  hello\ world
hello\ w   -->  hello\ world
hello w    -->                   # no completion, the word is just 'w'>
"hel       -->  "hello world" 
"hello w   -->  "hello world"

The call (completeWordPrim compl prefx isWordChar fun) is a short hand for (completeQuotedWordPrim compl prefx isWordChar '\\' "'\"" fun). Pass Nothing to isWordChar for the default not . separator where separator = c -> c elem " \t\r\n,.;:/\\(){}[]".

completeQuotedWordPrim compl input isWordChar escapeChar quoteChars completer: Complete a word taking care of automatically quoting and escaping characters. Takes the CompletionEnv environment compl, the current input, and a user defined completer function that is called with adjusted input which is unquoted, unescaped, and limited to the word just before the cursor. Unlike completeWord, this function takes an explicit function to determine word characters, the escape character, and a string of quote characters. See also completeWord.

As readline but returns Nothing on end-of-file or other errors (ctrl-C/ctrl-D).

As readlineEx but returns Nothing on end-of-file or other errors (ctrl-C/ctrl-D). See also readlineMaybe.

readlinePrim prompt mbCompleter mbHighlighter: as readline but uses the given mbCompleter function to complete words on tab (instead of the default completer). and the given mbHighlighter function to highlight the input (instead of the default highlighter). See also readlineEx and readlinePrimMaybe.

As readlinePrim but returns Nothing on end-of-file or other errors (ctrl-C/ctrl-D). See also readlineMaybe.

Get the current prompt marker.

Get the current prompt continuation marker for multi-line input.

If this returns True an effort should be made to stop completing and return from the callback.

Have any completions be generated so far?

Thread safe call to asynchronously send a stop event to a readline which behaves as if the user pressed ctrl-C, which will return with Nothing (or ""). Returns True if the event was successfully delivered.

Abstract highlight environment

Set a syntax highlighter. There can only be one highlight function, setting it again disables the previous one.

Set a syntax highlighter that uses a pure function that returns a bbcode formatted string (using style, plain etc). See highlightFmt for more information. There can only be one highlight function, setting it again disables the previous one.

Initialize the terminal for the term functions. Does nothing on most platforms but on windows enables UTF8 output and potentially enables virtual terminal processing. See also withTerm.

Done using term functions. See also withTerm.

Use the term functions (brackets termInit and termDone).

Flush terminal output. Happens automatically on newline ('\n') characters as well.

Write output to the terminal where ANSI CSI sequences are handled portably across platforms (including Windows).

Write output with a ending newline to the terminal where ANSI CSI sequences are handled portably across platforms (including Windows).

Set the terminal text color as a hexadecimal number 0xrrggbb. The color is auto adjusted for terminals with less colors.

Set the terminal text background color. The color is auto adjusted for terminals with less colors.

Set the terminal text color as an ANSI palette color (between 0 and 255). Use 256 for the default. The color is auto adjusted for terminals with less colors.

Set the terminal text background color as an ANSI palette color (between 0 and 255). Use 256 for the default. The color is auto adjusted for terminals with less colors.

Set the terminal text underline mode.

Set the terminal text reverse video mode.

Reset the terminal text mode to defaults