1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
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
48
49
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
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
|
# SPDX-FileCopyrightText: © 2012-2022 Germar Reitze
# SPDX-FileCopyrightText: © 2024 Christian BUHTZ <c.buhtz@posteo.jp>
#
# SPDX-License-Identifier: GPL-2.0-or-later
#
# This file is part of the program "Back In Time" which is released under GNU
# General Public License v2 (GPLv2). See LICENSES directory or go to
# <https://spdx.org/licenses/GPL-2.0-or-later.html>.
"""Module offering several message boxes to inform user in the GUI."""
from PyQt6.QtCore import QTimer
from PyQt6.QtWidgets import (QApplication,
QInputDialog,
QLineEdit,
QMessageBox,
QWidget)
import qttools # pylint: disable=cyclic-import
def ask_password_dialog(parent, title, prompt, language_code, timeout):
"""Dev note (2025-07, buhtz):
Replace with extern use of zenity, yat, kdialog
e.g.
zenity --entry --title="foo" --text="text" --hide-text
yad --entry --title="foo" --text="text" --hide-text
kdialog --password "enter password"
"""
if parent is None:
app = qttools.create_qapplication()
translator = qttools.initiate_translator(language_code)
app.installTranslator(translator)
# pylint: disable-next=import-outside-toplevel
import icon # noqa: PLC0415
dialog = QInputDialog()
timer = QTimer()
if timeout is not None:
timer.timeout.connect(dialog.reject)
timer.setInterval(timeout * 1000)
timer.start()
dialog.setWindowIcon(icon.BIT_LOGO)
dialog.setWindowTitle(title)
dialog.setLabelText(prompt)
dialog.setTextEchoMode(QLineEdit.EchoMode.Password)
QApplication.processEvents()
result = dialog.exec()
timer.stop()
password = dialog.textValue() if result else ''
del dialog
return password
def info(text, title=None, widget_to_center_on=None):
"""Show a modal information message box.
The message box is centered on the primary screen if
``widget_to_center_on`` is not given.
Args:
text(str): The information text central to the dialog.
title(str): Title of the message box dialog.
widget_to_center_on(QWidget): Center the message box on that widget.
"""
QMessageBox.information(
widget_to_center_on,
title if title else ngettext('Information', 'Information', 1),
text)
def warning(text: str,
title: str = None,
widget_to_center_on: QWidget = None,
as_question: bool = False) -> bool | None:
"""Show a modal warning message box.
The message box is centered on the primary screen if
``widget_to_center_on`` is not given.
Args:
text: The warning message central to the dialog.
title: Title of the message box dialog (default: 'Warning').
widget_to_center_on: Center the message box on that widget.
as_question: Use Yes and No buttons.
"""
buttons = QMessageBox.StandardButton.Yes | QMessageBox.StandardButton.No \
if as_question else QMessageBox.StandardButton.Ok
answer = QMessageBox.warning(
widget_to_center_on,
title if title else _('Warning'),
text,
buttons
)
return answer == QMessageBox.StandardButton.Yes
def question(text, title=None, widget_to_center_on=None) -> bool:
"""Show a modal question message box.
The message box is centered on the primary screen if
``widget_to_center_on`` is not given.
Args:
text(str): The question central to the dialog.
title(str): Title of the message box dialog (default: 'Question').
widget_to_center_on(QWidget): Center the message box on that widget.
Return:
bool: ``True`` if the answer was "Yes", otherwise ``False``.
"""
answer = QMessageBox.question(
widget_to_center_on,
title if title else _('Question'),
text)
return answer == QMessageBox.StandardButton.Yes
def critical(parent, msg):
"""Shows an error message box.
Qt itseld does not distinguish between error and critical messages.
"""
return QMessageBox.critical(
parent,
_('Error'),
msg,
buttons=QMessageBox.StandardButton.Ok,
defaultButton=QMessageBox.StandardButton.Ok)
|
