mafw.steering_gui.views

Placeholder package for steering GUI views while the GUI is being scaffolded.

Author:

Bulgheroni Antonio (antonio.bulgheroni@ec.europa.eu)

Description:

UI views live here once they are implemented, keeping the controller agnostic of toolkit code.

class mafw.steering_gui.views.DatabaseEditor(parent: QWidget | None = None)

Bases: QWidget

Widget that exposes database backend selection and layered configuration.

_detect_backend_from_url(url: str | None) → str

Determine the backend type from the given URL.

This method analyses the provided URL to identify the corresponding backend type by matching URL prefixes or extracting the protocol. If no match is found, it defaults to the current backend or the default backend.

Parameters:

url – The URL string to be analysed for backend detection.

Returns:

A string representing the detected backend type.

_normalize_config(config: dict[str, Any] | None) → dict[str, Any]

Normalize the configuration dictionary to ensure consistent backend, URL, authentication, and parameters.

This method processes the input configuration dictionary to extract and normalize values for backend type, URL, authentication details, and backend-specific parameters, ensuring defaults are applied where necessary.

Parameters:

config – A dictionary containing configuration details such as backend, URL, authentication, and parameters. If None, defaults are applied.

Returns:

A dictionary with normalized configuration values including backend, URL, enabled status, authentication, parameters, and pragmas.

get_data() → dict[str, Any]

Return a normalized view of the current database configuration.

is_enabled() → bool

Return whether the database configuration group is active.

set_data(config: dict[str, Any] | None) → None

Populate the UI from a configuration dictionary without emitting signals.

class mafw.steering_gui.views.GlobalsEditor(parent: QWidget | None = None)

Bases: QWidget

Editor that exposes analysis metadata and global flags without touching the builder.

current_values() → tuple[str, str, bool, bool]

Return the current UI values without normalizing them.

set_data(analysis_name: str | None, description: str | None, new_only: bool | None, create_standard_tables: bool | None) → None

Populate the widgets and avoid re-triggering their change signals.

class mafw.steering_gui.views.GroupEditor(parent: QWidget | None = None)

Bases: QWidget

Widget used to edit group metadata and the processor list.

refresh() → None

Refresh the table root index after model updates.

set_group_item(item: PipelineItem) → None

Display the provided group item and its processors.

set_model(model: SteeringTreeModel) → None

Attach the steering tree model to the group editor.

class mafw.steering_gui.views.MetadataEditor(parent: QWidget | None = None)

Bases: QWidget

Provide a quick summary of the steering file when no specific section is active.

set_validation_level(level: ValidationLevel | None) → None

Update the combo to reflect the controller’s validation preference.

update_summary(analysis_name: str | None, processor_count: int, available_processors: int | None = None, available_db_modules: int | None = None, available_uis: int | None = None) → None

Refresh the summary labels to match the loaded model.

class mafw.steering_gui.views.PipelineEditor(parent: QWidget | None = None)

Bases: QWidget

Widget exposing the processor pipeline as a flat table plus toolbox actions.

refresh() → None

Refresh the processors root index after model resets.

set_model(model: SteeringTreeModel) → None

Attach the steering tree model and focus on the processors section.

class mafw.steering_gui.views.ProcessorEditor(parent: QWidget | None = None)

Bases: QWidget

Placeholder widget representing per-processor configuration editors.

class mafw.steering_gui.views.ProcessorParameterEditor(parent: QWidget | None = None)

Bases: QWidget

Widget used to edit parameters and metadata of a processor entry.

current_name() → str | None

Return the currently displayed processor full name.

set_processor_data(config: ProcessorConfig) → None

Populate the editor with processor configuration data.

class mafw.steering_gui.views.SteeringTreeView(parent: QWidget | None = None)

Bases: QWidget

Widget exposing the steering-file sections as a QTreeView.

_on_selection_changed(*_: object) → None

Emit the section key and pipeline selection for the new tree selection.

refresh() → None

Refresh expansion and selection after model updates.

select_pipeline_item(name: str) → None

Select a pipeline item by its processor/group name.

set_model(model: SteeringTreeModel) → None

Attach a steering tree model to the view.

class mafw.steering_gui.views.UIEditor(parent: QWidget | None = None)

Bases: QWidget

Widget that exposes the configured user interface and allows switching it.

set_available_interfaces(names: Iterable[str] | None) → None

Populate the combo box once plugins have produced their UI list.

set_current_interface(interface: str | None) → None

Request the combobox to display a specific interface without emitting signals.

Modules

database_editor	Expose the database editor UI for steering file configuration.
filter_editors	Editors for different filter types in the steering GUI.
filter_manager	Manager widget for filter configuration.
filter_tree	Tree view for displaying and interacting with processor filters.
globals_editor	Expose the globals editor fields required by the steering GUI.
group_editor	Group editor widget for managing processor groups.
meta_editor	Editor showing metadata when the root node is selected.
pipeline_editor	Pipeline editor widget exposing processors and groups in execution order.
processor_editor	Editor scaffolding for processor-specific configurations.
processor_parameter_editor	Processor parameter editor for steering GUI pipelines.
steering_tree	Present a hierarchical representation of the steering file sections.
ui_editor	Editor for selecting the user interface defined in a steering file.