sqlite-sh 0.1.0__tar.gz

sqlite_sh-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 adwedelf
+
+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.

sqlite_sh-0.1.0/PKG-INFO

@@ -0,0 +1,95 @@
+Metadata-Version: 2.4
+Name: sqlite-sh
+Version: 0.1.0
+Summary: SQLite-backed Tkinter shoe shop demo application
+Author-email: adwedelf <adwedelf@users.noreply.github.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/tgoaty/demo-ex
+Project-URL: Repository, https://github.com/tgoaty/demo-ex
+Keywords: sqlite,tkinter,demo,shop
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Education
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# sqlite-sh
+
+`sqlite-sh` is a small educational Tkinter desktop application backed by SQLite.
+It includes a shoe shop catalog, role-based login, products, orders, database schema, and exam diagrams.
+
+## Install
+
+```bash
+pip install sqlite-sh
+```
+
+## Run
+
+```bash
+shop
+```
+
+On first import/run, the packaged seed database is copied to:
+
+```text
+~/.sqlite_sh/shop.db
+```
+
+You can override the writable database folder:
+
+```bash
+SQLITE_SH_HOME=/path/to/folder shop
+```
+
+## Admin credentials
+
+```text
+Login: 94d5ous@gmail.com
+Password: uzWC67
+```
+
+## Included files
+
+The installed package contains:
+
+- `assets/` with icons and images;
+- `data/shop.db` seed SQLite database;
+- `database.sql` schema;
+- `algorithm_flowchart_gost.pdf`;
+- `db_uml_diagram.pdf`.
+
+To find the installed package folder:
+
+```bash
+python -c "import sqlite_sh, pathlib; print(pathlib.Path(sqlite_sh.__file__).parent)"
+```
+
+## Build locally
+
+```bash
+python -m pip install --upgrade build twine
+python -m build
+python -m twine check dist/*
+```
+
+## Upload flow
+
+TestPyPI first:
+
+```bash
+python -m twine upload --repository testpypi dist/*
+```
+
+PyPI:
+
+```bash
+python -m twine upload dist/*
+```

sqlite_sh-0.1.0/README.md

@@ -0,0 +1,73 @@
+# sqlite-sh
+
+`sqlite-sh` is a small educational Tkinter desktop application backed by SQLite.
+It includes a shoe shop catalog, role-based login, products, orders, database schema, and exam diagrams.
+
+## Install
+
+```bash
+pip install sqlite-sh
+```
+
+## Run
+
+```bash
+shop
+```
+
+On first import/run, the packaged seed database is copied to:
+
+```text
+~/.sqlite_sh/shop.db
+```
+
+You can override the writable database folder:
+
+```bash
+SQLITE_SH_HOME=/path/to/folder shop
+```
+
+## Admin credentials
+
+```text
+Login: 94d5ous@gmail.com
+Password: uzWC67
+```
+
+## Included files
+
+The installed package contains:
+
+- `assets/` with icons and images;
+- `data/shop.db` seed SQLite database;
+- `database.sql` schema;
+- `algorithm_flowchart_gost.pdf`;
+- `db_uml_diagram.pdf`.
+
+To find the installed package folder:
+
+```bash
+python -c "import sqlite_sh, pathlib; print(pathlib.Path(sqlite_sh.__file__).parent)"
+```
+
+## Build locally
+
+```bash
+python -m pip install --upgrade build twine
+python -m build
+python -m twine check dist/*
+```
+
+## Upload flow
+
+TestPyPI first:
+
+```bash
+python -m twine upload --repository testpypi dist/*
+```
+
+PyPI:
+
+```bash
+python -m twine upload dist/*
+```

sqlite_sh-0.1.0/pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = ["setuptools>=77", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "sqlite-sh"
+version = "0.1.0"
+description = "SQLite-backed Tkinter shoe shop demo application"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [
+  { name = "adwedelf", email = "adwedelf@users.noreply.github.com" }
+]
+keywords = ["sqlite", "tkinter", "demo", "shop"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Education",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Operating System :: OS Independent",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/tgoaty/demo-ex"
+Repository = "https://github.com/tgoaty/demo-ex"
+
+[project.scripts]
+shop = "sqlite_sh.gui:main"
+sqlite-sh-diagram = "sqlite_sh.diagram:main"
+sqlite-sh-bootstrap = "sqlite_sh.bootstrap:main"
+
+[tool.setuptools]
+packages = ["sqlite_sh", "sqlite_sh.assets", "sqlite_sh.data"]
+include-package-data = true
+
+[tool.setuptools.package-data]
+sqlite_sh = [
+  "database.sql",
+  "algorithm_flowchart_gost.pdf",
+  "db_uml_diagram.pdf",
+  "assets/*",
+  "data/*.db",
+]

sqlite_sh-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

sqlite_sh-0.1.0/sqlite_sh/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

sqlite_sh-0.1.0/sqlite_sh/__main__.py

@@ -0,0 +1,4 @@
+from .gui import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

sqlite_sh-0.1.0/sqlite_sh/bootstrap.py

@@ -0,0 +1,249 @@
+import re
+import shutil
+import sqlite3
+import zipfile
+from datetime import datetime, timedelta
+from pathlib import Path
+from xml.etree import ElementTree as ET
+
+from sqlite_sh.config import ASSETS_DIR, DATA_DIR, DB_FILE, PACKAGE_DIR, SCHEMA_FILE
+
+
+IMPORT_RELATIVE_DIR = (
+    Path("Прил_ОЗ_КОД 09.02.07-2-2026")
+    / "БУ"
+    / "Модуль 1"
+    / "Прил_2_ОЗ_КОД 09.02.07-2-2026-М1"
+    / "import"
+)
+
+
+def find_source_dir():
+    candidates = [
+        PACKAGE_DIR.parent.parent / IMPORT_RELATIVE_DIR,
+        Path("/home/adwed/demo-ex") / IMPORT_RELATIVE_DIR,
+        Path.cwd().parent / IMPORT_RELATIVE_DIR,
+    ]
+    for candidate in candidates:
+        if candidate.exists():
+            return candidate
+    return candidates[0]
+
+
+SOURCE_DIR = find_source_dir()
+
+NS = {"a": "http://schemas.openxmlformats.org/spreadsheetml/2006/main"}
+
+
+def column_index(cell_ref):
+    match = re.match(r"([A-Z]+)", cell_ref or "")
+    if not match:
+        return 0
+    value = 0
+    for char in match.group(1):
+        value = value * 26 + ord(char) - 64
+    return value - 1
+
+
+def read_shared_strings(archive):
+    if "xl/sharedStrings.xml" not in archive.namelist():
+        return []
+    root = ET.fromstring(archive.read("xl/sharedStrings.xml"))
+    values = []
+    for item in root.findall("a:si", NS):
+        values.append("".join(node.text or "" for node in item.findall(".//a:t", NS)))
+    return values
+
+
+def read_cell(cell, shared_strings):
+    cell_type = cell.get("t")
+    if cell_type == "inlineStr":
+        return "".join(node.text or "" for node in cell.findall(".//a:t", NS))
+    value = cell.find("a:v", NS)
+    if value is None:
+        return None
+    raw = value.text
+    if cell_type == "s":
+        return shared_strings[int(raw)]
+    return raw
+
+
+def read_xlsx_rows(path):
+    with zipfile.ZipFile(path) as archive:
+        shared_strings = read_shared_strings(archive)
+        sheet_name = "xl/worksheets/sheet1.xml"
+        root = ET.fromstring(archive.read(sheet_name))
+        rows = []
+        for row in root.findall(".//a:sheetData/a:row", NS):
+            values = []
+            last_index = -1
+            for cell in row.findall("a:c", NS):
+                idx = column_index(cell.get("r", ""))
+                while last_index + 1 < idx:
+                    values.append(None)
+                    last_index += 1
+                values.append(read_cell(cell, shared_strings))
+                last_index = idx
+            rows.append(values)
+        return rows
+
+
+def clean(value):
+    if value is None:
+        return ""
+    return str(value).replace("\xa0", " ").strip()
+
+
+def excel_date(value):
+    text = clean(value)
+    if not text:
+        return None
+    if re.fullmatch(r"\d+(\.0)?", text):
+        serial = int(float(text))
+        return (datetime(1899, 12, 30) + timedelta(days=serial)).date().isoformat()
+    try:
+        return datetime.strptime(text, "%d.%m.%Y").date().isoformat()
+    except ValueError:
+        print(f"Warning: invalid date value '{text}', saved as NULL")
+        return None
+
+
+def scalar(conn, sql, params=()):
+    row = conn.execute(sql, params).fetchone()
+    return row[0] if row else None
+
+
+def get_or_create(conn, table, name):
+    name = clean(name)
+    conn.execute(f"INSERT OR IGNORE INTO {table}(name) VALUES (?)", (name,))
+    return scalar(conn, f"SELECT id FROM {table} WHERE name = ?", (name,))
+
+
+def copy_assets():
+    ASSETS_DIR.mkdir(exist_ok=True)
+    for source in SOURCE_DIR.iterdir():
+        if source.suffix.lower() in {".png", ".ico", ".jpg", ".jpeg"}:
+            shutil.copy2(source, ASSETS_DIR / source.name)
+
+
+def import_users(conn):
+    rows = read_xlsx_rows(SOURCE_DIR / "user_import.xlsx")
+    for row in rows[1:]:
+        if len(row) < 4 or not clean(row[0]):
+            continue
+        role_id = get_or_create(conn, "roles", row[0])
+        conn.execute(
+            "INSERT OR IGNORE INTO users(role_id, full_name, login, password) VALUES (?, ?, ?, ?)",
+            (role_id, clean(row[1]), clean(row[2]), clean(row[3])),
+        )
+
+
+def import_products(conn):
+    rows = read_xlsx_rows(SOURCE_DIR / "Tovar.xlsx")
+    for row in rows[1:]:
+        if len(row) < 10 or not clean(row[0]):
+            continue
+        unit_id = get_or_create(conn, "units", row[2])
+        supplier_id = get_or_create(conn, "suppliers", row[4])
+        manufacturer_id = get_or_create(conn, "manufacturers", row[5])
+        category_id = get_or_create(conn, "categories", row[6])
+        conn.execute(
+            """
+            INSERT OR REPLACE INTO products(
+                article, name, unit_id, price, supplier_id, manufacturer_id,
+                category_id, discount, stock, description, image_path
+            ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+            """,
+            (
+                clean(row[0]),
+                clean(row[1]),
+                unit_id,
+                float(clean(row[3]) or 0),
+                supplier_id,
+                manufacturer_id,
+                category_id,
+                int(float(clean(row[7]) or 0)),
+                int(float(clean(row[8]) or 0)),
+                clean(row[9]),
+                clean(row[10]) if len(row) > 10 and clean(row[10]) else None,
+            ),
+        )
+
+
+def import_pickup_points(conn):
+    rows = read_xlsx_rows(SOURCE_DIR / "Пункты выдачи_import.xlsx")
+    for row in rows:
+        if row and clean(row[0]):
+            conn.execute("INSERT OR IGNORE INTO pickup_points(address) VALUES (?)", (clean(row[0]),))
+
+
+def parse_order_items(raw):
+    parts = [clean(part) for part in clean(raw).split(",") if clean(part)]
+    result = []
+    for index in range(0, len(parts), 2):
+        if index + 1 >= len(parts):
+            break
+        result.append((parts[index], int(float(parts[index + 1]))))
+    return result
+
+
+def import_orders(conn):
+    rows = read_xlsx_rows(SOURCE_DIR / "Заказ_import.xlsx")
+    for row in rows[1:]:
+        if len(row) < 8 or not clean(row[0]):
+            continue
+        order_id = int(float(clean(row[0])))
+        pickup_point_id = int(float(clean(row[4]))) if clean(row[4]) else None
+        conn.execute(
+            """
+            INSERT OR REPLACE INTO orders(
+                id, order_date, delivery_date, pickup_point_id, client_name, receive_code, status
+            ) VALUES (?, ?, ?, ?, ?, ?, ?)
+            """,
+            (
+                order_id,
+                excel_date(row[2]),
+                excel_date(row[3]),
+                pickup_point_id,
+                clean(row[5]),
+                clean(row[6]),
+                clean(row[7]),
+            ),
+        )
+        conn.execute("DELETE FROM order_items WHERE order_id = ?", (order_id,))
+        for article, quantity in parse_order_items(row[1]):
+            product_id = scalar(conn, "SELECT id FROM products WHERE article = ?", (article,))
+            if product_id is None:
+                print(f"Warning: product article '{article}' not found for order {order_id}")
+                continue
+            conn.execute(
+                "INSERT INTO order_items(order_id, product_id, quantity) VALUES (?, ?, ?)",
+                (order_id, product_id, quantity),
+            )
+
+
+def reset_database():
+    DATA_DIR.mkdir(exist_ok=True)
+    if DB_FILE.exists():
+        DB_FILE.unlink()
+    with sqlite3.connect(DB_FILE) as conn:
+        conn.execute("PRAGMA foreign_keys = ON")
+        conn.executescript(SCHEMA_FILE.read_text(encoding="utf-8"))
+        import_users(conn)
+        import_products(conn)
+        import_pickup_points(conn)
+        import_orders(conn)
+        conn.commit()
+
+
+def main():
+    if not SOURCE_DIR.exists():
+        raise SystemExit(f"Source directory not found: {SOURCE_DIR}")
+    copy_assets()
+    reset_database()
+    print(f"Database created: {DB_FILE}")
+    print(f"Assets copied: {ASSETS_DIR}")
+
+
+if __name__ == "__main__":
+    main()

sqlite_sh-0.1.0/sqlite_sh/config.py

@@ -0,0 +1,23 @@
+import os
+import shutil
+from pathlib import Path
+
+
+PACKAGE_DIR = Path(__file__).resolve().parent
+ASSETS_DIR = PACKAGE_DIR / "assets"
+DATA_DIR = PACKAGE_DIR / "data"
+SCHEMA_FILE = PACKAGE_DIR / "database.sql"
+SEED_DB_FILE = DATA_DIR / "shop.db"
+
+USER_DIR = Path(os.environ.get("SQLITE_SH_HOME", Path.home() / ".sqlite_sh"))
+DB_FILE = USER_DIR / "shop.db"
+
+
+def ensure_user_database():
+    USER_DIR.mkdir(parents=True, exist_ok=True)
+    if not DB_FILE.exists() and SEED_DB_FILE.exists():
+        shutil.copy2(SEED_DB_FILE, DB_FILE)
+    return DB_FILE
+
+
+ensure_user_database()

sqlite_sh-0.1.0/sqlite_sh/database.sql

@@ -0,0 +1,87 @@
+PRAGMA foreign_keys = ON;
+
+DROP TABLE IF EXISTS order_items;
+DROP TABLE IF EXISTS orders;
+DROP TABLE IF EXISTS products;
+DROP TABLE IF EXISTS pickup_points;
+DROP TABLE IF EXISTS users;
+DROP TABLE IF EXISTS roles;
+DROP TABLE IF EXISTS categories;
+DROP TABLE IF EXISTS manufacturers;
+DROP TABLE IF EXISTS suppliers;
+DROP TABLE IF EXISTS units;
+
+CREATE TABLE roles (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    name TEXT NOT NULL UNIQUE
+);
+
+CREATE TABLE users (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    role_id INTEGER NOT NULL REFERENCES roles(id),
+    full_name TEXT NOT NULL,
+    login TEXT NOT NULL UNIQUE,
+    password TEXT NOT NULL
+);
+
+CREATE TABLE categories (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    name TEXT NOT NULL UNIQUE
+);
+
+CREATE TABLE manufacturers (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    name TEXT NOT NULL UNIQUE
+);
+
+CREATE TABLE suppliers (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    name TEXT NOT NULL UNIQUE
+);
+
+CREATE TABLE units (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    name TEXT NOT NULL UNIQUE
+);
+
+CREATE TABLE products (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    article TEXT NOT NULL UNIQUE,
+    name TEXT NOT NULL,
+    unit_id INTEGER NOT NULL REFERENCES units(id),
+    price REAL NOT NULL CHECK (price >= 0),
+    supplier_id INTEGER NOT NULL REFERENCES suppliers(id),
+    manufacturer_id INTEGER NOT NULL REFERENCES manufacturers(id),
+    category_id INTEGER NOT NULL REFERENCES categories(id),
+    discount INTEGER NOT NULL DEFAULT 0 CHECK (discount >= 0),
+    stock INTEGER NOT NULL DEFAULT 0 CHECK (stock >= 0),
+    description TEXT NOT NULL DEFAULT '',
+    image_path TEXT
+);
+
+CREATE TABLE pickup_points (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    address TEXT NOT NULL UNIQUE
+);
+
+CREATE TABLE orders (
+    id INTEGER PRIMARY KEY,
+    order_date TEXT,
+    delivery_date TEXT,
+    pickup_point_id INTEGER REFERENCES pickup_points(id),
+    client_name TEXT,
+    receive_code TEXT,
+    status TEXT NOT NULL
+);
+
+CREATE TABLE order_items (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    order_id INTEGER NOT NULL REFERENCES orders(id) ON DELETE CASCADE,
+    product_id INTEGER NOT NULL REFERENCES products(id),
+    quantity INTEGER NOT NULL CHECK (quantity > 0),
+    UNIQUE(order_id, product_id)
+);
+
+CREATE INDEX idx_products_article ON products(article);
+CREATE INDEX idx_products_supplier ON products(supplier_id);
+CREATE INDEX idx_order_items_product ON order_items(product_id);