Skip to content

dialogs

Small dialog helpers for the TermTk frontend.

confirm(*, parent, title, text, on_yes)

Show a Yes/No confirmation dialog.

Calls on_yes only when the user selects Yes.

Source code in src/awesome_os/frontend/dialogs.py 
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
def confirm(
    *,
    parent: ttk.TTkWidget,
    title: str,
    text: str,
    on_yes: Callable[[], None],
) -> None:
    """Show a Yes/No confirmation dialog.

    Calls `on_yes` only when the user selects **Yes**.
    """
    mb = ttk.TTkMessageBox(
        parent=parent,
        title=TTkString(f" {title} ", ttk.TTkColor.fg("#00ff00") + ttk.TTkColor.bg("#004400")),
        icon=ttk.TTkMessageBox.Icon.Question,
        text=TTkString(text),
        standardButtons=(
            ttk.TTkMessageBox.StandardButton.Yes | ttk.TTkMessageBox.StandardButton.No
        ),
        defaultButton=ttk.TTkMessageBox.StandardButton.No,
    )

    _center_over_parent(widget=mb, parent=parent)

    def _on_selected(sb: ttk.TTkMessageBox.StandardButton) -> None:
        if sb == ttk.TTkMessageBox.StandardButton.Yes:
            on_yes()

    mb.buttonSelected.connect(_on_selected)

prompt_text(*, parent, title, label, initial, on_ok)

Prompt the user for a single line of text.

Calls on_ok with the user's input when the user clicks OK.

Source code in src/awesome_os/frontend/dialogs.py 
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
def prompt_text(
    *,
    parent: ttk.TTkWidget,
    title: str,
    label: str,
    initial: str,
    on_ok: Callable[[str], None],
) -> None:
    """Prompt the user for a single line of text.

    Calls `on_ok` with the user's input when the user clicks **OK**.
    """
    dialog = ttk.TTkWindow(
        parent=parent,
        title=TTkString(f" {title} ", ttk.TTkColor.fg("#00aaff") + ttk.TTkColor.bg("#003355")),
        size=(80, 18),
        border=True,
        layout=ttk.TTkVBoxLayout(),
    )
    _center_over_parent(widget=dialog, parent=parent)
    ttk.TTkLabel(parent=dialog, text=label, maxHeight=2)
    edit = ttk.TTkLineEdit(parent=dialog)
    edit.setText(initial)

    buttons = ttk.TTkFrame(parent=dialog, layout=ttk.TTkHBoxLayout())
    ok_btn = ttk.TTkButton(parent=buttons, text=TTkString("OK"))
    cancel_btn = ttk.TTkButton(parent=buttons, text=TTkString("Cancel"))

    def _accept() -> None:
        value = edit.text()
        dialog.close()
        # TermTk returns a TTkString-like object; normalize it to a plain str for callers.
        on_ok(str(value))

    def _cancel() -> None:
        dialog.close()

    ok_btn.clicked.connect(_accept)
    cancel_btn.clicked.connect(_cancel)