terminal.lua

• Index

Contents

• Functions
• Methods

Classes

• Canvas
• EditLine
• Sequence
• canvas.TimeSeriesGraph
• canvas.Viewport
• cli.Confirm
• cli.MultiSelect
• cli.Prompt
• cli.Select
• progress.Bar
• ui.Panel
• ui.panel.Bar
• ui.panel.ButtonBar
• ui.panel.Confirm
• ui.panel.KeyBar
• ui.panel.Screen
• ui.panel.Set
• ui.panel.TabStrip
• ui.panel.Text

Modules

• spec.helpers
• terminal
• terminal.clear
• terminal.cursor
• terminal.cursor.position
• terminal.cursor.shape
• terminal.cursor.visible
• terminal.draw
• terminal.draw.line
• terminal.input
• terminal.input.keymap
• terminal.output
• terminal.progress
• terminal.scroll
• terminal.text
• terminal.text.color
• terminal.text.width
• terminal.utils

Topics

• 1. Terminal
• 2. Terminal layer
• 3. Text handling
• 4. CLI widgets
• 5. Full-screen UI
• 6. Canvas (braille pixel graphics)
• CHANGELOG
• CONTRIBUTING
• MIT License

Examples

• async.lua
• canvas.lua
• car_race.lua
• cli.lua
• colors.lua
• cow.lua
• graph.lua
• headers.lua
• keymap.lua
• panel.lua
• panel_confirm.lua
• progress.lua
• progressbar.lua
• prompt-copas.lua
• screen.lua
• sequence.lua
• tabstrip.lua
• testscreen.lua
• text_panel.lua

Class cli.Select

A single-choice interactive menu widget for CLI tools.

This module provides a simple way to create a menu with a list of choices, allowing the user to navigate and select an option using keyboard input. The menu is displayed in the terminal, and the user can use the arrow keys to navigate through the options, or type to search for an option. The selected option is highlighted, and the user can confirm their choice by pressing Enter. Optionally the menu can also be cancelled by pressing <esc> or <ctrl+c>.

NOTE: you MUST call terminal.initialize before calling this widget's :run() method.

Usage:

local menu = cli.Select{
  prompt = "Select an option:",
  choices = {
    "Option 1",
    "Option 2",
    "Option 3"
  },
  default = 1,
  cancellable = true
}

local selected_index, selected_value = menu()  -- invokes the 'run' method
print("Selected index: " .. selected_index)
print("Selected value: " .. selected_value)

Functions

cli.Select (opts)

Create a new Select instance.

Methods

cli.select:clear_widget ()	Clears the widget.
cli.select:height ()	Returns the display height in rows.
cli.select:print_selection ()	Prints a one-line summary of the prompt and selected response.
cli.select:run ()	Executes the widget.
cli.select:set_selection (idx)	Set the current selection index.

Functions

cli.Select (opts)

Create a new Select instance.

Parameters:

• opts Options for the Select menu.
  • choices table List of choices (strings) to display.
  • default number Default choice index (1-based). (default 1)
  • prompt string Prompt message to display. (default "Select an option:")
  • cancellable boolean Whether the menu can be cancelled (by pressing <esc> or <ctrl+c>). (default false)
  • clear boolean Whether to clear the widget from screen after completion. (default false)
  • typeahead_delay number Seconds of inactivity after which the typeahead search buffer resets. (default 1.0)

Returns:

Select A new Select instance.

Methods

cli.select:clear_widget ()

Clears the widget.

cli.select:height ()

Returns the display height in rows.

Returns:

number The height of the menu in rows.

cli.select:print_selection ()

Prints a one-line summary of the prompt and selected response.

cli.select:run ()

Executes the widget.

Returns:

1. number The index of the selected choice (1-based)
2. string The selected choice

Or

1. nil If cancelled
2. string Error string "cancelled" if cancelled.

cli.select:set_selection (idx)

Set the current selection index.

Parameters:

• idx number The index to set as the current selection (1-based).