deskkit 1.1.0__tar.gz

deskkit-1.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DeskKit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

deskkit-1.1.0/PKG-INFO

@@ -0,0 +1,185 @@
+Metadata-Version: 2.4
+Name: deskkit
+Version: 1.1.0
+Summary: Простой набор инструментов для создания десктоп-приложений с Qt и MySQL
+Author: DeskKit Team
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/deskkit/deskkit
+Project-URL: Documentation, https://github.com/deskkit/deskkit#readme
+Keywords: qt,pyqt,pyside,mysql,desktop,gui
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mysql-connector-python>=8.0.0
+Provides-Extra: pyqt
+Requires-Dist: PyQt6>=6.4; extra == "pyqt"
+Provides-Extra: pyside
+Requires-Dist: PySide6>=6.4; extra == "pyside"
+Provides-Extra: all
+Requires-Dist: PyQt6>=6.4; extra == "all"
+Requires-Dist: PySide6>=6.4; extra == "all"
+Dynamic: license-file
+
+# DeskKit
+
+**DeskKit** — Python-библиотека для быстрого создания десктоп-приложений с каталогом товаров, авторизацией и CRUD на базе **Qt** (PySide6 / PyQt6) и **MySQL** (`mysql-connector-python`).
+
+Название нейтральное: выглядит как обычный «desktop kit», без привязки к экзаменам.
+
+## Установка
+
+```bash
+# С PySide6 (рекомендуется)
+pip install deskkit[pyside]
+
+# Или с PyQt6
+pip install deskkit[pyqt]
+
+# Только ядро (нужен уже установленный Qt-биндинг)
+pip install deskkit
+pip install PySide6
+```
+
+## Быстрый старт
+
+### Режим по умолчанию — генерация готового проекта
+
+По умолчанию `export_project=True`: deskkit **генерирует автономный проект** с обычным Python-кодом. В сгенерированных файлах **нет импортов deskkit** — только PySide6/PyQt6 и mysql.connector, как будто приложение написано с нуля.
+
+```python
+from deskkit import AppConfig, ShopApp
+
+ShopApp(AppConfig(
+    title="Обувной магазин",
+    password="ваш_пароль",
+    database="shoe_store",
+    output_dir="obuvnoy_magazin",  # куда положить проект
+)).run()
+```
+
+На выходе:
+
+```
+obuvnoy_magazin/
+├── main.py              # точка входа
+├── settings.py          # настройки MySQL
+├── database.py          # mysql.connector
+├── auth.py
+├── catalog.py
+├── images_utils.py
+├── qt_loader.py         # PySide6 / PyQt6
+├── ui/                  # окна Qt
+├── sql/database.sql     # создание БД + данные
+├── requirements.txt
+└── images/
+```
+
+Дальше работаете **только с этой папкой** — сдавайте её на экзамен.
+
+### Параметры генерации
+
+| Параметр | По умолчанию | Описание |
+|----------|--------------|----------|
+| `export_project` | `True` | Сгенерировать автономный проект |
+| `output_dir` | slug от title | Папка результата |
+| `include_seed_data` | `True` | Тестовые данные в SQL |
+| `run_generated` | `True` | Запустить main.py после генерации |
+| `library_runtime` | `False` | Запуск через deskkit (без генерации) |
+
+### Запуск через библиотеку (режим разработки)
+
+```python
+ShopApp(AppConfig(
+    export_project=False,
+    library_runtime=True,
+)).run()
+```
+
+### Минимальный пример (legacy runtime)
+
+```python
+from deskkit import AppConfig, ShopApp
+
+ShopApp(AppConfig(
+    title="Обувной магазин",
+    user="root",
+    password="ваш_пароль",
+    database="shoe_store",
+    images_dir="images",
+    export_project=False,
+    library_runtime=True,
+)).run()
+```
+
+## Что уже реализовано
+
+| Требование демоэкзамена | DeskKit |
+|-------------------------|---------|
+| Подключение к MySQL | `AppConfig` + `Database` |
+| Авторизация (логин/пароль из БД) | `LoginWindow` |
+| Вход как гость | кнопка «Продолжить без авторизации» |
+| 4 интерфейса по ролям | гость, клиент, менеджер, администратор |
+| Каталог: фото + 9 полей | настраивается в `catalog_columns` |
+| Условное форматирование (3 правила) | скидка, нет в наличии, скидка ≥15% |
+| Поиск в реальном времени | по всем текстовым полям |
+| Сортировка по количеству ↑↓ | кнопка в панели |
+| Фильтр по поставщику + сброс | выпадающий список |
+| CRUD товаров (админ) | форма с 12+ полями |
+| Resize фото 300×200 | через Qt, без Pillow |
+| Валидация (цена, кол-во ≥ 0) | `validate_product_data` |
+| Удаление с проверкой заказов | `product_in_orders` |
+| Обработка ошибок | `QMessageBox` |
+| Навигация «Назад» | кнопка в форме редактирования |
+
+## Выбор Qt-бэкенда
+
+```bash
+# Переменная окружения
+set DESKKIT_QT=pyqt6    # Windows
+export DESKKIT_QT=pyside6  # Linux/macOS
+```
+
+Или в конфиге: `AppConfig(qt_backend="pyside6")`
+
+## Структура для PyPI
+
+```
+deskkit/
+├── pyproject.toml
+├── README.md
+├── LICENSE
+├── deskkit/
+│   ├── app.py          # ShopApp — главная точка входа
+│   ├── config.py       # AppConfig
+│   ├── database.py     # MySQL
+│   ├── auth.py         # авторизация
+│   ├── catalog.py      # поиск / фильтр / сортировка
+│   ├── images.py       # работа с фото
+│   └── ui/             # готовые окна Qt
+└── examples/
+    └── shoe_shop.py
+```
+
+## Публикация на PyPI
+
+```bash
+cd deskkit
+pip install build twine
+python -m build
+twine upload dist/*
+```
+
+## Лицензия
+
+MIT

deskkit-1.1.0/README.md

@@ -0,0 +1,152 @@
+# DeskKit
+
+**DeskKit** — Python-библиотека для быстрого создания десктоп-приложений с каталогом товаров, авторизацией и CRUD на базе **Qt** (PySide6 / PyQt6) и **MySQL** (`mysql-connector-python`).
+
+Название нейтральное: выглядит как обычный «desktop kit», без привязки к экзаменам.
+
+## Установка
+
+```bash
+# С PySide6 (рекомендуется)
+pip install deskkit[pyside]
+
+# Или с PyQt6
+pip install deskkit[pyqt]
+
+# Только ядро (нужен уже установленный Qt-биндинг)
+pip install deskkit
+pip install PySide6
+```
+
+## Быстрый старт
+
+### Режим по умолчанию — генерация готового проекта
+
+По умолчанию `export_project=True`: deskkit **генерирует автономный проект** с обычным Python-кодом. В сгенерированных файлах **нет импортов deskkit** — только PySide6/PyQt6 и mysql.connector, как будто приложение написано с нуля.
+
+```python
+from deskkit import AppConfig, ShopApp
+
+ShopApp(AppConfig(
+    title="Обувной магазин",
+    password="ваш_пароль",
+    database="shoe_store",
+    output_dir="obuvnoy_magazin",  # куда положить проект
+)).run()
+```
+
+На выходе:
+
+```
+obuvnoy_magazin/
+├── main.py              # точка входа
+├── settings.py          # настройки MySQL
+├── database.py          # mysql.connector
+├── auth.py
+├── catalog.py
+├── images_utils.py
+├── qt_loader.py         # PySide6 / PyQt6
+├── ui/                  # окна Qt
+├── sql/database.sql     # создание БД + данные
+├── requirements.txt
+└── images/
+```
+
+Дальше работаете **только с этой папкой** — сдавайте её на экзамен.
+
+### Параметры генерации
+
+| Параметр | По умолчанию | Описание |
+|----------|--------------|----------|
+| `export_project` | `True` | Сгенерировать автономный проект |
+| `output_dir` | slug от title | Папка результата |
+| `include_seed_data` | `True` | Тестовые данные в SQL |
+| `run_generated` | `True` | Запустить main.py после генерации |
+| `library_runtime` | `False` | Запуск через deskkit (без генерации) |
+
+### Запуск через библиотеку (режим разработки)
+
+```python
+ShopApp(AppConfig(
+    export_project=False,
+    library_runtime=True,
+)).run()
+```
+
+### Минимальный пример (legacy runtime)
+
+```python
+from deskkit import AppConfig, ShopApp
+
+ShopApp(AppConfig(
+    title="Обувной магазин",
+    user="root",
+    password="ваш_пароль",
+    database="shoe_store",
+    images_dir="images",
+    export_project=False,
+    library_runtime=True,
+)).run()
+```
+
+## Что уже реализовано
+
+| Требование демоэкзамена | DeskKit |
+|-------------------------|---------|
+| Подключение к MySQL | `AppConfig` + `Database` |
+| Авторизация (логин/пароль из БД) | `LoginWindow` |
+| Вход как гость | кнопка «Продолжить без авторизации» |
+| 4 интерфейса по ролям | гость, клиент, менеджер, администратор |
+| Каталог: фото + 9 полей | настраивается в `catalog_columns` |
+| Условное форматирование (3 правила) | скидка, нет в наличии, скидка ≥15% |
+| Поиск в реальном времени | по всем текстовым полям |
+| Сортировка по количеству ↑↓ | кнопка в панели |
+| Фильтр по поставщику + сброс | выпадающий список |
+| CRUD товаров (админ) | форма с 12+ полями |
+| Resize фото 300×200 | через Qt, без Pillow |
+| Валидация (цена, кол-во ≥ 0) | `validate_product_data` |
+| Удаление с проверкой заказов | `product_in_orders` |
+| Обработка ошибок | `QMessageBox` |
+| Навигация «Назад» | кнопка в форме редактирования |
+
+## Выбор Qt-бэкенда
+
+```bash
+# Переменная окружения
+set DESKKIT_QT=pyqt6    # Windows
+export DESKKIT_QT=pyside6  # Linux/macOS
+```
+
+Или в конфиге: `AppConfig(qt_backend="pyside6")`
+
+## Структура для PyPI
+
+```
+deskkit/
+├── pyproject.toml
+├── README.md
+├── LICENSE
+├── deskkit/
+│   ├── app.py          # ShopApp — главная точка входа
+│   ├── config.py       # AppConfig
+│   ├── database.py     # MySQL
+│   ├── auth.py         # авторизация
+│   ├── catalog.py      # поиск / фильтр / сортировка
+│   ├── images.py       # работа с фото
+│   └── ui/             # готовые окна Qt
+└── examples/
+    └── shoe_shop.py
+```
+
+## Публикация на PyPI
+
+```bash
+cd deskkit
+pip install build twine
+python -m build
+twine upload dist/*
+```
+
+## Лицензия
+
+MIT

deskkit-1.1.0/deskkit/__init__.py

@@ -0,0 +1,44 @@
+"""DeskKit — простые десктоп-приложения на Qt и MySQL."""
+
+from deskkit.app import ShopApp, run_app, run_from_json
+from deskkit.auth import AuthService, make_guest, user_display_name
+from deskkit.catalog import apply_catalog_filters, search_products, sort_products
+from deskkit.config import AppConfig
+from deskkit.database import Database
+from deskkit.exceptions import AuthError, DatabaseError, DeskKitError, ValidationError
+from deskkit.generator import export_project, run_generated
+from deskkit.images import load_pixmap, save_product_image, validate_product_data
+from deskkit.qt_backend import backend_name, init_qt
+from deskkit.roles import ADMIN, CLIENT, GUEST, MANAGER
+
+__version__ = "1.1.0"
+
+__all__ = [
+    "ShopApp",
+    "AppConfig",
+    "Database",
+    "AuthService",
+    "export_project",
+    "run_generated",
+    "run_app",
+    "run_from_json",
+    "apply_catalog_filters",
+    "search_products",
+    "sort_products",
+    "load_pixmap",
+    "save_product_image",
+    "validate_product_data",
+    "make_guest",
+    "user_display_name",
+    "init_qt",
+    "backend_name",
+    "ADMIN",
+    "CLIENT",
+    "GUEST",
+    "MANAGER",
+    "DeskKitError",
+    "DatabaseError",
+    "AuthError",
+    "ValidationError",
+    "__version__",
+]

deskkit-1.1.0/deskkit/app.py

@@ -0,0 +1,114 @@
+"""Точка входа — запуск готового приложения."""
+
+from __future__ import annotations
+
+import sys
+from typing import Callable
+
+from deskkit import qt_backend
+from deskkit.auth import AuthService
+from deskkit.config import AppConfig
+from deskkit.database import Database
+from deskkit.exceptions import DatabaseError
+from deskkit.images import ensure_images_dir
+from deskkit.ui.login_window import LoginWindow
+from deskkit.ui.main_window import MainWindow
+from deskkit.ui.styles import APP_STYLE
+
+qt_backend.init_qt()
+QtWidgets = qt_backend.QtWidgets
+
+
+class ShopApp:
+    """
+    Готовое приложение «из коробки».
+
+    Пример:
+        from deskkit import ShopApp, AppConfig
+
+        ShopApp(AppConfig(
+            title="Обувной магазин",
+            database="shoe_store",
+            password="root",
+        )).run()
+    """
+
+    def __init__(self, config: AppConfig | None = None):
+        self.config = config or AppConfig()
+        qt_backend.init_qt(self.config.qt_backend)
+        self.db = Database(self.config)
+        self.auth = AuthService(self.db)
+        self._app: QtWidgets.QApplication | None = None
+        self._main_window: MainWindow | None = None
+
+    def run(self) -> int:
+        """Запустить приложение или сгенерировать автономный проект."""
+        if self.config.export_project and not self.config.library_runtime:
+            from deskkit.generator import export_project, run_generated
+
+            out = export_project(self.config)
+            print(f"Проект создан: {out}")
+            if self.config.run_generated:
+                return run_generated(self.config, out)
+            return 0
+
+        return self._run_library()
+
+    def _run_library(self) -> int:
+        """Запуск через deskkit (режим разработки)."""
+        ensure_images_dir(self.config)
+
+        self._app = QtWidgets.QApplication.instance()
+        if self._app is None:
+            self._app = QtWidgets.QApplication(sys.argv)
+        self._app.setStyleSheet(APP_STYLE)
+
+        try:
+            if not self.db.test_connection():
+                QtWidgets.QMessageBox.critical(
+                    None,
+                    "Ошибка подключения",
+                    "Не удалось подключиться к базе данных.\n"
+                    "Проверьте настройки AppConfig.",
+                )
+                return 1
+        except DatabaseError as exc:
+            QtWidgets.QMessageBox.critical(None, "Ошибка подключения", str(exc))
+            return 1
+
+        if not self._show_login():
+            return 0
+        return qt_backend.exec_app(self._app)
+
+    def _show_login(self) -> bool:
+        def on_success(user: dict) -> None:
+            self._show_main()
+
+        login = LoginWindow(self.config, self.auth, on_success)
+        result = login.exec()
+        return result == QtWidgets.QDialog.DialogCode.Accepted
+
+    def _show_main(self) -> None:
+        if self._main_window:
+            self._main_window.close()
+
+        def on_logout() -> None:
+            self._show_login()
+
+        self._main_window = MainWindow(
+            self.config,
+            self.db,
+            self.auth,
+            on_logout=on_logout,
+        )
+        self._main_window.show()
+
+
+def run_app(config: AppConfig | None = None) -> int:
+    """Быстрый запуск приложения одной функцией."""
+    return ShopApp(config).run()
+
+
+def run_from_json(path: str) -> int:
+    """Запуск по JSON-файлу настроек."""
+    return ShopApp(AppConfig.from_json(path)).run()

deskkit-1.1.0/deskkit/auth.py

@@ -0,0 +1,72 @@
+"""Авторизация пользователей."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from deskkit.database import Database
+from deskkit.exceptions import AuthError
+from deskkit.roles import ADMIN, CLIENT, GUEST, MANAGER
+
+
+def make_guest() -> dict[str, Any]:
+    return {
+        "id_user": 0,
+        "login": "guest",
+        "first_name": "Гость",
+        "last_name": "",
+        "middle_name": None,
+        "id_role": 0,
+        "role_name": GUEST,
+    }
+
+
+def user_display_name(user: dict[str, Any]) -> str:
+    parts = [user.get("last_name", ""), user.get("first_name", "")]
+    middle = user.get("middle_name")
+    if middle:
+        parts.append(middle)
+    name = " ".join(p for p in parts if p).strip()
+    return name or user.get("login", "Пользователь")
+
+
+class AuthService:
+    def __init__(self, db: Database):
+        self.db = db
+        self.current_user: dict[str, Any] | None = None
+
+    @property
+    def role(self) -> str:
+        if not self.current_user:
+            return GUEST
+        return str(self.current_user.get("role_name", GUEST))
+
+    def login(self, login: str, password: str) -> dict[str, Any]:
+        if not login.strip() or not password.strip():
+            raise AuthError("Введите логин и пароль")
+
+        user = self.db.authenticate(login.strip(), password)
+        if not user:
+            raise AuthError("Неверный логин или пароль")
+
+        self.current_user = user
+        return user
+
+    def login_as_guest(self) -> dict[str, Any]:
+        self.current_user = make_guest()
+        return self.current_user
+
+    def logout(self) -> None:
+        self.current_user = None
+
+    def is_admin(self) -> bool:
+        return self.role == ADMIN
+
+    def is_manager(self) -> bool:
+        return self.role == MANAGER
+
+    def is_client(self) -> bool:
+        return self.role == CLIENT
+
+    def is_guest(self) -> bool:
+        return self.role == GUEST

deskkit-1.1.0/deskkit/catalog.py

@@ -0,0 +1,103 @@
+"""Поиск, фильтрация и сортировка товаров."""
+
+from __future__ import annotations
+
+from typing import Any, Callable
+
+
+def _text(value: Any) -> str:
+    if value is None:
+        return ""
+    return str(value).lower()
+
+
+def search_products(
+    products: list[dict[str, Any]],
+    query: str,
+    fields: list[str] | None = None,
+) -> list[dict[str, Any]]:
+    """Поиск в реальном времени по текстовым полям."""
+    if not query.strip():
+        return list(products)
+
+    q = query.strip().lower()
+    if fields is None:
+        fields = [
+            "article_number",
+            "product_name",
+            "description",
+            "category_name",
+            "manufacturer_name",
+            "supplier_name",
+            "unit",
+            "availability_status",
+        ]
+
+    result = []
+    for product in products:
+        for field in fields:
+            if q in _text(product.get(field)):
+                result.append(product)
+                break
+    return result
+
+
+def filter_by_supplier(
+    products: list[dict[str, Any]],
+    supplier_id: int | None,
+) -> list[dict[str, Any]]:
+    if supplier_id is None or supplier_id <= 0:
+        return list(products)
+    return [p for p in products if int(p.get("id_supplier") or 0) == supplier_id]
+
+
+def filter_by_category(
+    products: list[dict[str, Any]],
+    category_id: int | None,
+) -> list[dict[str, Any]]:
+    if category_id is None or category_id <= 0:
+        return list(products)
+    return [p for p in products if int(p.get("id_category") or 0) == category_id]
+
+
+def sort_products(
+    products: list[dict[str, Any]],
+    field: str = "stock_quantity",
+    ascending: bool = True,
+) -> list[dict[str, Any]]:
+    def key_fn(item: dict[str, Any]) -> Any:
+        value = item.get(field, 0)
+        if value is None:
+            return 0
+        return value
+
+    return sorted(products, key=key_fn, reverse=not ascending)
+
+
+def apply_catalog_filters(
+    products: list[dict[str, Any]],
+    *,
+    search: str = "",
+    supplier_id: int | None = None,
+    category_id: int | None = None,
+    sort_field: str = "product_name",
+    sort_asc: bool = True,
+) -> list[dict[str, Any]]:
+    """Комбинирует поиск, фильтры и сортировку."""
+    result = search_products(products, search)
+    result = filter_by_supplier(result, supplier_id)
+    result = filter_by_category(result, category_id)
+    return sort_products(result, sort_field, sort_asc)
+
+
+def row_style(product: dict[str, Any], rules: list[dict[str, Any]]) -> dict[str, str]:
+    """Возвращает стили строки по правилам условного форматирования."""
+    styles: dict[str, str] = {}
+    for rule in rules:
+        condition: Callable[[dict[str, Any]], bool] = rule["when"]
+        if condition(product):
+            if "background" in rule:
+                styles["background"] = rule["background"]
+            if "foreground" in rule:
+                styles["foreground"] = rule["foreground"]
+    return styles