spacr.qt.parascape

Install ParaScape separately, then launch and monitor its desktop process.

Classes

ParaScapeInstallDialog	Explain the alpha app and download size before installing in its own environment.
ParaScapeUpdateCheckDialog	Check PyPI off the GUI thread, allowing a cancelled check to open the installed app.

Functions

open_parascape([parent, root])

Check for updates on every open and offer pip upgrades before launching.

Module Contents

class spacr.qt.parascape.ParaScapeInstallDialog(parent=None, *, root=None, job=None, upgrade=False)

Bases: PySide6.QtWidgets.QDialog

Explain the alpha app and download size before installing in its own environment.

Parameters:

• parent – owning organism page.

• root – optional external-application root.

• job – optional installer substitute for tests.

Build the consent and progress controls; opening the dialog installs nothing.

closeEvent(event)

Keep the dialog alive until its installer thread has stopped.

Parameters:

event – Qt close event; ignored while cancellation is pending.

Returns:

None.

reject()

Cancel active subprocesses and defer closing until the worker has ended.

start()

Start the install after the explicit button press, keeping Qt responsive.

class spacr.qt.parascape.ParaScapeUpdateCheckDialog(parent=None, *, root=None)

Bases: PySide6.QtWidgets.QDialog

Check PyPI off the GUI thread, allowing a cancelled check to open the installed app.

Prepare an automatic, read-only update check.

__init__(parent=None, *, root=None)

Prepare an automatic, read-only update check.

closeEvent(event)

Prevent destruction of an active check thread.

Parameters:

event – Qt close event; ignored while the check is being cancelled.

Returns:

None.

reject()

Cancel the check and keep the dialog alive until its worker exits.

spacr.qt.parascape.open_parascape(parent=None, *, root=None)

Check for updates on every open and offer pip upgrades before launching.

Parameters:

• parent – organism page requesting the launch.

• root – optional external-application folder.

Returns:

child process, or None if cancelled or launch failed.

Nested helpers

ParaScapeUpdateCheckDialog.__init__.check(_source, *, root, cancel, progress)

Store the comparison until the worker’s finished signal arrives.

spacr/qt/parascape.py:227

open_parascape.check()

Reap the detached child and show failures without closing ParaScape on spaCR exit.

spacr/qt/parascape.py:309