pyqt_reactive.protocols.widget_adapters

Widget adapters that wrap Qt widgets to implement OpenHCS ABCs.

Normalizes Qt’s inconsistent APIs: - QLineEdit.text() vs QSpinBox.value() vs QComboBox.currentData() - QLineEdit.setText() vs QSpinBox.setValue() vs QComboBox.setCurrentIndex() - QLineEdit.setPlaceholderText() vs QSpinBox.setSpecialValueText()

All adapters implement consistent interface via ABCs: - get_value() / set_value() for all widgets - set_placeholder() for all widgets - connect_change_signal() for all widgets

Mirrors MemoryTypeConverter pattern - adapters normalize inconsistent APIs.

Classes

CheckBoxAdapter	Adapter for QCheckBox implementing OpenHCS ABCs.
CheckboxGroupAdapter([parent])	Adapter for checkbox group (List[Enum]) implementing OpenHCS ABCs.
ComboBoxAdapter	Adapter for QComboBox implementing OpenHCS ABCs.
DoubleSpinBoxAdapter([parent])	Adapter for QDoubleSpinBox implementing OpenHCS ABCs.
LineEditAdapter	Adapter for QLineEdit implementing OpenHCS ABCs.
PyQtWidgetMeta(name, bases, namespace, /, ...)	Metaclass for PyQt widgets that need ABC support.
SpinBoxAdapter([parent])	Adapter for QSpinBox implementing OpenHCS ABCs.
adapter_class

class pyqt_reactive.protocols.widget_adapters.PyQtWidgetMeta(name, bases, namespace, /, **kwargs)

Metaclass for PyQt widgets that need ABC support.

class pyqt_reactive.protocols.widget_adapters.LineEditAdapter

Adapter for QLineEdit implementing OpenHCS ABCs.

Normalizes Qt API to OpenHCS contracts: - .text() → .get_value() - .setText() → .set_value() - .setPlaceholderText() → .set_placeholder() - .textChanged → .connect_change_signal()

get_value() → Any

Implement ValueGettable ABC.

set_value(value: Any) → None

Implement ValueSettable ABC.

set_placeholder(text: str) → None

Implement PlaceholderCapable ABC.

connect_change_signal(callback: Callable[[Any], None]) → None

Implement ChangeSignalEmitter ABC.

disconnect_change_signal(callback: Callable[[Any], None]) → None

Implement ChangeSignalEmitter ABC.

class pyqt_reactive.protocols.widget_adapters.SpinBoxAdapter(parent=None)

Adapter for QSpinBox implementing OpenHCS ABCs.

Handles None values using special value text mechanism. When value is None, displays placeholder text at minimum value.

__init__(parent=None)

get_value() → Any

Implement ValueGettable ABC.

set_value(value: Any) → None

Implement ValueSettable ABC.

set_placeholder(text: str) → None

Implement PlaceholderCapable ABC.

configure_range(minimum: float, maximum: float) → None

Implement RangeConfigurable ABC.

connect_change_signal(callback: Callable[[Any], None]) → None

Implement ChangeSignalEmitter ABC.

disconnect_change_signal(callback: Callable[[Any], None]) → None

Implement ChangeSignalEmitter ABC.

class pyqt_reactive.protocols.widget_adapters.DoubleSpinBoxAdapter(parent=None)

Adapter for QDoubleSpinBox implementing OpenHCS ABCs.

Handles None values and floating-point ranges.

__init__(parent=None)

get_value() → Any

Implement ValueGettable ABC.

set_value(value: Any) → None

Implement ValueSettable ABC.

set_placeholder(text: str) → None

Implement PlaceholderCapable ABC.

configure_range(minimum: float, maximum: float) → None

Implement RangeConfigurable ABC.

connect_change_signal(callback: Callable[[Any], None]) → None

Implement ChangeSignalEmitter ABC.

disconnect_change_signal(callback: Callable[[Any], None]) → None

Implement ChangeSignalEmitter ABC.

class pyqt_reactive.protocols.widget_adapters.ComboBoxAdapter

Adapter for QComboBox implementing OpenHCS ABCs.

Stores actual values in itemData, not just display text. Supports enum population and selection.

get_value() → Any

Implement ValueGettable ABC.

set_value(value: Any) → None

Implement ValueSettable ABC.

set_placeholder(text: str) → None

Implement PlaceholderCapable ABC.

populate_enum(enum_type: type) → None

Populate combobox with enum values.

Parameters:

enum_type – The Enum class to populate from

connect_change_signal(callback: Callable[[Any], None]) → None

Implement ChangeSignalEmitter ABC.

disconnect_change_signal(callback: Callable[[Any], None]) → None

Implement ChangeSignalEmitter ABC.

class pyqt_reactive.protocols.widget_adapters.CheckBoxAdapter

Adapter for QCheckBox implementing OpenHCS ABCs.

Returns bool values, treats None as False.

get_value() → Any

Implement ValueGettable ABC.

set_value(value: Any) → None

Implement ValueSettable ABC.

connect_change_signal(callback: Callable[[Any], None]) → None

Implement ChangeSignalEmitter ABC.

disconnect_change_signal(callback: Callable[[Any], None]) → None

Implement ChangeSignalEmitter ABC.

class pyqt_reactive.protocols.widget_adapters.CheckboxGroupAdapter(parent=None)

Adapter for checkbox group (List[Enum]) implementing OpenHCS ABCs.

Manages a group of NoneAwareCheckBox widgets for multi-selection. Returns List[Enum] or None (for placeholder state).

This eliminates duck typing - instead of checking for _checkboxes attribute, we use proper ABC inheritance.

__init__(parent=None)

checkbox_items() → tuple[tuple[Any, Any], ...]

Return enum-to-checkbox items for group-level placeholder logic.

checkbox_widgets() → tuple[Any, ...]

Return checkboxes managed by this group.

get_value() → Any

Implement ValueGettable ABC.

Returns:

• None if all checkboxes are in placeholder state (inherit from parent)

• List[Enum] of checked items if any checkbox has been clicked

set_value(value: Any) → None

Implement ValueSettable ABC.

Parameters:

value – None (placeholder state) or List[Enum] (concrete values)

connect_change_signal(callback: Callable[[Any], None]) → None

Implement ChangeSignalEmitter ABC.

Connects to all checkboxes in the group.

disconnect_change_signal(callback: Callable[[Any], None]) → None

Implement ChangeSignalEmitter ABC.

pyqt_reactive.protocols.widget_adapters.adapter_class

alias of CheckboxGroupAdapter