qtmvvm 1.0.0

MVVM library for Qt with observable properties and data bindings.

QtMVVM

MVVM-библиотека для Qt с наблюдаемыми свойствами и привязками данных.

Языки: 🇬🇧 English | 🇷🇺 Русский

Установка

uv add qtmvvm

Быстрый старт

1. Создание наблюдаемых свойств

from qtmvvm import ObservableProperty

# Создание свойства с начальным значением
name = ObservableProperty("John")
age = ObservableProperty(25)

# Получение значения
print(name.value)  # "John"
print(name())      # "John"

# Установка значения
name.value = "Jane"
age(30)            # Альтернативный синтаксис

2. Создание ViewModel

from qtmvvm import BaseViewModel, computed_property

class PersonViewModel(BaseViewModel):
    # Простые свойства
    name: str = "John"
    age: int = 25
    
    # Вычисляемое свойство (только для чтения, авто-обновление)
    @computed_property(depends_on=["name", "age"])
    def description(self):
        return f"{self.name}, {self.age} лет"

# Использование
vm = PersonViewModel()
print(vm.name)         # "John"
print(vm.description)  # "John, 25 лет"

vm.name = "Jane"
print(vm.description)  # "Jane, 25 лет" (авто-обновление!)

3. Использование операторов биндингов

QtMVVM предоставляет три оператора для привязки данных:

Оператор	Направление	Описание
>>	Свойство → Виджет	1-way биндинг
@	Свойство ↔ Виджет	2-way биндинг
<<	Сигнал → Свойство	Биндинг сигнала

1-Way биндинг (>>)

from qtmvvm import ObservableProperty
from qtpy.QtWidgets import QLabel

name = ObservableProperty("John")
label = QLabel()

name >> label  # При изменении name, label обновляется автоматически
name.value = "Jane"  # label.text = "Jane"

2-Way биндинг (@)

from qtmvvm import ObservableProperty
from qtpy.QtWidgets import QLineEdit

name = ObservableProperty("John")
edit = QLineEdit()

name @ edit  # Синхронизация в обоих направлениях

edit.setText("Jane")  # name.value = "Jane"
name.value = "Bob"    # edit.text = "Bob"

Биндинг сигнала (<<)

from qtmvvm import ObservableProperty
from qtpy.QtWidgets import QPushButton

click_count = ObservableProperty(0)
button = QPushButton("Click me")

click_count << button.clicked  # Каждый клик увеличивает click_count

4. Использование Command

Command оборачивает методы ViewModel для привязки к кнопкам с автоматической блокировкой во время выполнения.

from qtmvvm import BaseViewModel, command
from qtpy.QtWidgets import QPushButton

class CounterViewModel(BaseViewModel):
    count: int = 0

    @command
    def increment(self):
        self.count += 1

    @command
    async def load_data(self):
        import asyncio
        await asyncio.sleep(1)  # Асинхронная операция

vm = CounterViewModel()

# Привязка к кнопкам
inc_btn = QPushButton("+")
load_btn = QPushButton("Load")

vm.increment << inc_btn    # Клик → increment()
vm.load_data << load_btn   # Кнопка блокируется во время загрузки

Документация

• Полная документация (Русский) — подробное API reference, все миксины биндингов и расширенные примеры
• Full Documentation (English)