ask_user

Supported ask_user question types.

Question types that require a non-empty choices list.

Derived from _requires_choices rather than written out, so it cannot omit a new choice-based QuestionType member. Note that requiring choices is not the same as being rendered as a choice list: the TUI has its own exhaustive dispatch in _QuestionWidget.compose.

Runtime membership view of QuestionType.

Derived via get_args so the membership checks in ask_user and auto_mode cannot drift from the alias when a new question type is added. That drift would be silent: an unrecognized type makes _ask_user_question_count return None, which drops the user's answers as same-turn authorization without any error.

Return whether an ask_user answer counts as "no answer".

The single definition of emptiness for an answer, shared by the TUI (which blocks submitting a required question) and by the Auto authorization path (which keeps unanswered questions out of the consent evidence). Both sides must agree: an answer the TUI accepts as empty must not read as consent evidence downstream.

A bare .strip() is wrong for multi_select, whose empty encoding is the truthy string []. Every other type is empty when it is blank.

Encode the selected values of a multi_select answer for the wire.

The answer stays one string so answers: list[str] keeps one slot per question, positionally matched. JSON is self-delimiting, so values carrying commas, quotes, or newlines round-trip exactly.

The encoding is opaque to a consumer that only moves the answer around. A consumer that tests whether the user answered at all must go through ask_user_answer_is_empty: an unselected multi_select encodes as the truthy string [], so a bare .strip() reads it as answered.

Get the glyph set for the current charset mode.

Return a safe configured editor name for user-facing hints.

A single choice option for a multiple choice or multi-select question.

A question to ask the user.

Free-form answer input for ask-user questions.

Adds two behaviors over the shared base:

• When the cursor is on the first or last line of a choice question's Other free-text input, Up/Down are handed back to the enclosing choice list instead of moving the text cursor.
• Escape deselects the checked custom multi-select option that owns this field (via the uncheck_other binding), instead of cancelling the whole prompt. check_action keeps the binding unmatched otherwise, so Escape still bubbles to AskUserMenu.action_cancel.

Interactive widget for asking the user questions.

Supports text input, multiple choice (pick exactly one), and multi-select (toggle one or more) questions. Choice questions always include an "Other" option for free-form input. Multi-select can combine multiple custom Other values with predefined options: filling one Other reveals an "Add another" row.

Discriminated union for the ask_user widget Future result.