pyqt6-template-widgets 0.2.0

Template-based widgets and form helpers for PyQt6 applications

pyqt6-template-widgets

Template-based widgets and form helpers for PyQt6 applications. The library helps build simple data-driven interfaces from reusable card, list and form templates.

• CardTemplate описывает внешний вид карточки;
• FormTemplate и FormField описывают форму добавления/редактирования;
• TemplateListWindow показывает список и открывает форму;
• optional partner-management preset built on top of the template widgets;
• small calculation helpers are included for demo business rules.

Installation

pip install -e .

Template Example

from pyqt6_templates import CardTemplate, FormField, FormTemplate, TemplateListWindow

items = [
    {
        "partner_type": "Дилер",
        "name": "ООО Ромашка",
        "director": "Иванов Иван Иванович",
        "phone": "[phone]",
        "rating": 10,
        "discount": 10,
    }
]

card_template = CardTemplate(
    title="{partner_type} | {name}",
    lines=["{director}", "{phone}", "Рейтинг: {rating}"],
    badge="{discount}%",
)

form_template = FormTemplate(
    title_create="Добавить партнера",
    title_edit="Редактировать партнера",
    fields=[
        FormField("name", "Наименование:", required=True),
        FormField("partner_type", "Тип:", kind="choice", choices=["Дилер", "Оптовик"]),
        FormField("rating", "Рейтинг:", kind="number", minimum=0),
        FormField("director", "Директор:", required=True),
        FormField("phone", "Телефон:", required=True),
    ],
)

window = TemplateListWindow(
    title="Список партнеров",
    items=items,
    card_template=card_template,
    form_template=form_template,
)
window.run()

The full example is available in examples/template_demo.py.

Shoe store demo (full assignment flow)

A complete demo with test data, login, roles, products, orders, search/filter/sort and CRUD without changing the library:

python examples/shoe_store_demo.py

Test accounts: client1/123, manager1/123, admin1/123, or guest login.

Partner Preset

If your application manages partners, you can use the built-in preset:

from pyqt6_templates import Partner, PartnerListWindow

partner = Partner(
    partner_type="Дилер",
    name="ООО Ромашка",
    director="Иванов Иван Иванович",
    phone="[phone]",
    rating=10,
    total_sales=62000,
)

window = PartnerListWindow(
    partners=[partner],
    partner_types=["Дилер", "Оптовик"],
)
window.run()

Calculation Helpers

from pyqt6_templates import calculate_partner_discount, calculate_required_material

discount = calculate_partner_discount(62000)

material = calculate_required_material(
    product_type_id=1,
    material_type_id=2,
    product_count=10,
    parameter_1=2.5,
    parameter_2=3.0,
    product_type_coefficients={1: 1.2},
    material_defect_rates={2: 0.05},
)

PyPI Build

python -m pip install build twine
python -m build
python -m twine check dist/*
python -m twine upload dist/*

See docs/PYPI_UPDATE.md for version bump and update workflow.

What's new in 0.2.0

• conditional card colors via CardStyleRule
• image placeholder on cards (image_field)
• decimal form fields for prices
• TemplateListPage with search, filter, sort, delete
• list helpers: search_items, filter_items, sort_items