yera.runtime.handlers.form_echo._answers

Choose which answers a form echo may show.

Symbols

def answer_rows — List every answer a form echo may show, nested answers included.
def answer_text — Format one answer as short plain text.
class AnswerRow — One line of a form echo.
def visible_answers — List the answers a form echo may show, in field order.

answer_rows

answer_rows(
    data: FormEchoData,
) → list[AnswerRow]

List every answer a form echo may show, nested answers included.

Secrets are omitted at every depth. A chosen variant shows its option, and each repeated row is numbered, with their fields indented beneath.

Parameters

data
type: FormEchoData

The echoed form submission.

Returns

type: list[AnswerRow]

The echo's lines in field order.

answer_text

answer_text(
    value: JsonValue,
) → str

Format one answer as short plain text.

Parameters

value
type: JsonValue

A submitted answer.

Returns

type: str

The answer as text, or an empty string for an unset answer.

AnswerRow

One line of a form echo.

Fields

depth
type: int (required)

How deeply the answer is nested inside groups, rows and variants.

label
type: str (required)

The field's label.

text
type: str (required)

The answer as plain text, or empty for a heading over nested answers.

Methods


AnswerRow.__init__

__init__(
    depth: int,
    label: str,
    text: str,
) → None

visible_answers

visible_answers(
    data: FormEchoData,
) → list[tuple[str, str, JsonValue]]

List the answers a form echo may show, in field order.

Parameters

data
type: FormEchoData

The echoed form submission.

Returns

type: list[tuple[str, str, JsonValue]]

(key, label, value) for each top-level answer that is not a secret.