Skip to content

visualdynamics.gui.disclaimer

disclaimer

The alpha notice: read and acknowledged before the window takes input.

Brandon, 2026-09-11: this is an alpha release, and a user should have to acknowledge, every time the application loads, that its results are to be checked. So the launcher shows this dialog after the window is built and before the event loop takes anything else. One enabled button, Quit, and a checkbox that enables Continue; nothing in the window is reachable until Continue is pressed. Every launch, by decision — a few seconds, and the point stays in front of the user for as long as the release is an alpha. Not in MainWindow, so the API and the tests' window fixture never meet it; the launcher's --no-disclaimer flag is for a script that opens the window and has already read this.

Classes:

Name Description
Disclaimer

The notice as a modal dialog. exec() answers Accepted only

Functions:

Name Description
acknowledged

Show the notice; True when the user read it and continued.

Classes

Disclaimer 

Disclaimer(parent: QWidget | None = None)

Bases: QDialog

The notice as a modal dialog. exec() answers Accepted only after the checkbox is ticked and Continue pressed; closing the dialog any other way is Quit.

Source code in src/visualdynamics/gui/disclaimer.py 
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
def __init__(self, parent: QWidget | None = None) -> None:
    super().__init__(parent)
    self.setWindowTitle(TITLE)
    self.setModal(True)
    layout = QVBoxLayout(self)
    self.notice: QLabel = QLabel(TEXT)
    self.notice.setWordWrap(True)
    self.notice.setOpenExternalLinks(True)
    self.notice.setTextInteractionFlags(
        Qt.TextInteractionFlag.TextBrowserInteraction)
    self.notice.setMaximumWidth(520)
    layout.addWidget(self.notice)
    self.acknowledged: QCheckBox = QCheckBox(ACKNOWLEDGEMENT)
    layout.addWidget(self.acknowledged)
    self.buttons: QDialogButtonBox = QDialogButtonBox()
    self.continue_button: QPushButton = self.buttons.addButton(
        'Continue', QDialogButtonBox.ButtonRole.AcceptRole)
    self.quit_button: QPushButton = self.buttons.addButton(
        'Quit', QDialogButtonBox.ButtonRole.RejectRole)
    self.continue_button.setEnabled(False)
    self.continue_button.setDefault(True)
    self.acknowledged.toggled.connect(self.continue_button.setEnabled)
    self.buttons.accepted.connect(self.accept)
    self.buttons.rejected.connect(self.reject)
    layout.addWidget(self.buttons)

Functions:

acknowledged 

acknowledged(parent: QWidget | None = None) -> bool

Show the notice; True when the user read it and continued.

Source code in src/visualdynamics/gui/disclaimer.py 
90
91
92
def acknowledged(parent: QWidget | None = None) -> bool:
    """Show the notice; True when the user read it and continued."""
    return Disclaimer(parent).exec() == QDialog.DialogCode.Accepted