pyqt_reactive.widgets.enhanced_path_widget

Enhanced Path Widget for PyQt6 GUI

Provides intelligent path selection with browse button functionality. Uses standard Qt dialogs for consistency with the rest of OpenHCS.

Classes

EnhancedPathWidget(param_name, current_value)	Enhanced path widget with browse button using standard Qt dialogs.
PathBehavior([is_directory, extensions, ...])	Defines behavior for path widget based on parameter analysis.
PathBehaviorDetector()	Detects appropriate path behavior from parameter names and docstring hints.

class pyqt_reactive.widgets.enhanced_path_widget.PathBehavior(is_directory: bool = False, extensions: List[str] | None = None, cache_key: PathCacheKey = PathCacheKey.GENERAL, description: str = 'path')

Defines behavior for path widget based on parameter analysis.

is_directory: bool = False

extensions: List[str] | None = None

cache_key: PathCacheKey = 'general'

description: str = 'path'

property title: str

Generate appropriate dialog title.

property file_filter: str

Generate Qt file filter string.

__init__(is_directory: bool = False, extensions: List[str] | None = None, cache_key: PathCacheKey = PathCacheKey.GENERAL, description: str = 'path') → None

class pyqt_reactive.widgets.enhanced_path_widget.PathBehaviorDetector

Detects appropriate path behavior from parameter names and docstring hints.

static detect_behavior(param_name: str, param_info: ParameterInfo | None = None) → PathBehavior

Detect path behavior from parameter name and optional parameter info.

Parameters:

• param_name – Parameter name to analyze

• param_info – Optional parameter info with docstring description

Returns:

PathBehavior with detected settings

class pyqt_reactive.widgets.enhanced_path_widget.EnhancedPathWidget(param_name: str, current_value: Any, param_info: ParameterInfo | None = None, color_scheme=None)

Enhanced path widget with browse button using standard Qt dialogs.

path_changed

int = …, arguments: Sequence = …) -> PYQT_SIGNAL

types is normally a sequence of individual types. Each type is either a type object or a string that is the name of a C++ type. Alternatively each type could itself be a sequence of types each describing a different overloaded signal. name is the optional C++ name of the signal. If it is not specified then the name of the class attribute that is bound to the signal is used. revision is the optional revision of the signal that is exported to QML. If it is not specified then 0 is used. arguments is the optional sequence of the names of the signal’s arguments.

Type:

pyqtSignal(*types, name

Type:

str = …, revision

__init__(param_name: str, current_value: Any, param_info: ParameterInfo | None = None, color_scheme=None)

Initialize enhanced path widget.

Parameters:

• param_name – Parameter name for behavior detection

• current_value – Current path value

• param_info – Optional parameter info with docstring

• color_scheme – Color scheme for styling

set_path(value: Any)

Set path value without triggering signals.

get_path()

Get current path value, returning None for empty strings.

get_value()

Implement ValueGettable ABC - alias for get_path().

set_value(value: Any)

Implement ValueSettable ABC - alias for set_path().