schrodinger.ui.qt.standard.controllers.source_selection_controller module¶

schrodinger.ui.qt.standard.controllers.source_selection_controller.resolveSources(sources: collections.abc.Collection[InputSource] | None, default_sources: Collection[InputSource], *, maestro_available: bool | None = None) → tuple[InputSource, ...]¶: Return a validated source collection for the current environment.

class schrodinger.ui.qt.standard.controllers.source_selection_controller.SourceSelectionController(*, parent: QWidget, source_combo: QComboBox, sources: Collection[InputSource], path_controller: PathBrowseController | None = None, default_source: InputSource | None = None, source_labels: collections.abc.Mapping[InputSource, str] | None = None)¶

Bases: QObject

Coordinate selection among path and Maestro project input sources.

This controller owns source-combo population and enablement, browse-button visibility, project synchronization, and active-source event routing. It does not own domain-specific validation, input resolution, or display widget visibility.

sourceChanged¶: A pyqtSignal emitted by instances of the class.

activeInputChanged¶: A pyqtSignal emitted by instances of the class.

__init__(*, parent: QWidget, source_combo: QComboBox, sources: Collection[InputSource], path_controller: PathBrowseController | None = None, default_source: InputSource | None = None, source_labels: collections.abc.Mapping[InputSource, str] | None = None) → None¶

sources() → tuple[InputSource, ...]¶: Return the configured input origins in display order.

source() → InputSource¶: Return the active input origin.

setSource(source: InputSource) → None¶: Select an enabled input origin.

resetToDefault() → None¶: Select the configured default input origin.

setSourceEnabled(source: InputSource, enabled: bool) → None¶: Enable or disable an origin while preserving an active one.

pathBrowseController() → PathBrowseController | None¶: Return the configured path controller, if present.

projectController() → MaestroProjectEntriesController | None¶: Return the configured project controller, if present.