spacr.qt.starplast

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

Classes

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

Functions

open_starplast([parent, root])

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

Module Contents

class spacr.qt.starplast.StarplastInstallDialog(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.starplast.StarplastUpdateCheckDialog(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.starplast.open_starplast(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

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

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

spacr/qt/starplast.py:227

open_starplast.check()

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

spacr/qt/starplast.py:309