sqlite-sh 0.1.0__tar.gz → 0.1.1__tar.gz

{sqlite_sh-0.1.0/sqlite_sh.egg-info → sqlite_sh-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sqlite-sh
-Version: 0.1.0
+Version: 0.1.1
 Summary: SQLite-backed Tkinter shoe shop demo application
 Author-email: adwedelf <adwedelf@users.noreply.github.com>
 License-Expression: MIT
@@ -37,6 +37,8 @@ pip install sqlite-sh
 shop
 ```
 
+Detailed usage is also installed inside the package as `sqlite_sh/USAGE.md`.
+
 On first import/run, the packaged seed database is copied to:
 
 ```text
@@ -93,3 +95,17 @@ PyPI:
 ```bash
 python -m twine upload dist/*
 ```
+
+## Easy DB diagram
+
+Create a browser-ready HTML/SVG database diagram without extra tools:
+
+```bash
+sqlite-sh-diagram
+```
+
+This writes `db_diagram.html`, which can be opened directly in Edge or any modern browser. Mermaid output is still available:
+
+```bash
+sqlite-sh-diagram --format mermaid -o db_diagram.mmd
+```

{sqlite_sh-0.1.0 → sqlite_sh-0.1.1}/README.md

@@ -15,6 +15,8 @@ pip install sqlite-sh
 shop
 ```
 
+Detailed usage is also installed inside the package as `sqlite_sh/USAGE.md`.
+
 On first import/run, the packaged seed database is copied to:
 
 ```text
@@ -71,3 +73,17 @@ PyPI:
 ```bash
 python -m twine upload dist/*
 ```
+
+## Easy DB diagram
+
+Create a browser-ready HTML/SVG database diagram without extra tools:
+
+```bash
+sqlite-sh-diagram
+```
+
+This writes `db_diagram.html`, which can be opened directly in Edge or any modern browser. Mermaid output is still available:
+
+```bash
+sqlite-sh-diagram --format mermaid -o db_diagram.mmd
+```

{sqlite_sh-0.1.0 → sqlite_sh-0.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sqlite-sh"
-version = "0.1.0"
+version = "0.1.1"
 description = "SQLite-backed Tkinter shoe shop demo application"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -41,6 +41,7 @@ include-package-data = true
 [tool.setuptools.package-data]
 sqlite_sh = [
   "database.sql",
+  "USAGE.md",
   "algorithm_flowchart_gost.pdf",
   "db_uml_diagram.pdf",
   "assets/*",

sqlite_sh-0.1.1/sqlite_sh/USAGE.md

@@ -0,0 +1,95 @@
+# sqlite-sh usage
+
+This file is installed inside the Python package, so it remains available after:
+
+```bash
+pip install sqlite-sh
+```
+
+Find the installed package folder:
+
+```bash
+python -c "import sqlite_sh, pathlib; print(pathlib.Path(sqlite_sh.__file__).parent)"
+```
+
+## Run the application
+
+```bash
+shop
+```
+
+On first run the seed database is copied from the installed package to:
+
+```text
+~/.sqlite_sh/shop.db
+```
+
+Use another writable database folder:
+
+```bash
+SQLITE_SH_HOME=/path/to/folder shop
+```
+
+## Admin credentials
+
+```text
+Login: 94d5ous@gmail.com
+Password: uzWC67
+```
+
+## Build a Windows exe after pip install
+
+```bat
+python -m venv .venv
+.venv\Scripts\activate
+pip install sqlite-sh pyinstaller
+pyinstaller --noconfirm --windowed --name shop --collect-all sqlite_sh --icon .venv\Lib\site-packages\sqlite_sh\assets\Icon.ico -m sqlite_sh
+```
+
+Result:
+
+```text
+dist\shop\shop.exe
+```
+
+One-file variant:
+
+```bat
+pyinstaller --noconfirm --onefile --windowed --name shop --collect-all sqlite_sh --icon .venv\Lib\site-packages\sqlite_sh\assets\Icon.ico -m sqlite_sh
+```
+
+## Rebuild database from Excel files
+
+```bash
+sqlite-sh-bootstrap
+```
+
+The importer expects the original exam Excel files in the known import folder. If your files are elsewhere, edit `sqlite_sh/bootstrap.py` or place the import folder near the project before running the command.
+
+## Generate database diagram easily
+
+Browser-ready HTML/SVG file, no Mermaid extension required:
+
+```bash
+sqlite-sh-diagram
+```
+
+This creates:
+
+```text
+db_diagram.html
+```
+
+Open it in Edge, Chrome, Firefox, or any modern browser.
+
+Mermaid source is still available:
+
+```bash
+sqlite-sh-diagram --format mermaid -o db_diagram.mmd
+```
+
+Print Mermaid to the console:
+
+```bash
+sqlite-sh-diagram --format mermaid -o -
+```

sqlite_sh-0.1.1/sqlite_sh/__init__.py

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

sqlite_sh-0.1.1/sqlite_sh/diagram.py

@@ -0,0 +1,197 @@
+import argparse
+import html
+import sqlite3
+from pathlib import Path
+
+from sqlite_sh.config import DB_FILE
+
+
+DEFAULT_HTML = "db_diagram.html"
+DEFAULT_MERMAID = "db_diagram.mmd"
+
+
+def load_schema():
+    if not DB_FILE.exists():
+        raise SystemExit("База данных не найдена. Сначала выполните: sqlite-sh-bootstrap")
+    with sqlite3.connect(DB_FILE) as conn:
+        conn.row_factory = sqlite3.Row
+        tables = [
+            row["name"]
+            for row in conn.execute(
+                "SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%' ORDER BY name"
+            )
+        ]
+        columns = {table: list(conn.execute(f"PRAGMA table_info({table})")) for table in tables}
+        foreign_keys = {table: list(conn.execute(f"PRAGMA foreign_key_list({table})")) for table in tables}
+    return tables, columns, foreign_keys
+
+
+def render_mermaid(tables, columns, foreign_keys):
+    lines = ["erDiagram"]
+    for table in tables:
+        lines.append(f"    {table} {{")
+        for col in columns[table]:
+            name = col["name"]
+            type_name = col["type"] or "TEXT"
+            pk = " PK" if col["pk"] else ""
+            lines.append(f"        {type_name} {name}{pk}")
+        lines.append("    }")
+    for table in tables:
+        for fk in foreign_keys[table]:
+            ref_table = fk["table"]
+            from_col = fk["from"]
+            to_col = fk["to"]
+            lines.append(f"    {ref_table} ||--o{{ {table} : \"{to_col} to {from_col}\"")
+    return "\n".join(lines) + "\n"
+
+
+def table_height(columns_count):
+    return 46 + max(columns_count, 1) * 24 + 12
+
+
+def svg_text(x, y, text, size=14, weight="normal"):
+    return (
+        f'<text x="{x}" y="{y}" font-family="Arial, sans-serif" '
+        f'font-size="{size}" font-weight="{weight}">{html.escape(str(text))}</text>'
+    )
+
+
+def render_html(tables, columns, foreign_keys):
+    layout = {
+        "roles": (60, 100),
+        "users": (60, 360),
+        "categories": (60, 650),
+        "manufacturers": (60, 870),
+        "suppliers": (60, 1090),
+        "units": (520, 1090),
+        "products": (520, 360),
+        "order_items": (1010, 360),
+        "orders": (1430, 360),
+        "pickup_points": (1430, 720),
+    }
+    default_positions = {}
+    for idx, table in enumerate(tables):
+        default_positions[table] = (60 + (idx % 4) * 430, 100 + (idx // 4) * 310)
+    positions = {table: layout.get(table, default_positions[table]) for table in tables}
+    widths = {
+        "products": 390,
+        "orders": 330,
+        "order_items": 310,
+        "users": 330,
+        "pickup_points": 330,
+    }
+
+    def box(table):
+        x, y = positions[table]
+        w = widths.get(table, 300)
+        h = table_height(len(columns[table]))
+        return x, y, w, h
+
+    svg = []
+    svg.append('<svg xmlns="http://www.w3.org/2000/svg" width="1850" height="1320" viewBox="0 0 1850 1320">')
+    svg.append('<defs><marker id="arrow" markerWidth="10" markerHeight="10" refX="9" refY="3" orient="auto" markerUnits="strokeWidth"><path d="M0,0 L0,6 L9,3 z" fill="black" /></marker></defs>')
+    svg.append('<rect x="0" y="0" width="1850" height="1320" fill="white"/>')
+    svg.append(svg_text(50, 45, "ER/UML диаграмма SQLite", 28, "bold"))
+    svg.append(svg_text(50, 76, "Таблицы, поля, первичные и внешние ключи", 15))
+    svg.append('<line x1="50" y1="90" x2="1800" y2="90" stroke="black" stroke-width="2"/>')
+
+    def anchor(table, side):
+        x, y, w, h = box(table)
+        if side == "left":
+            return x, y + h / 2
+        if side == "right":
+            return x + w, y + h / 2
+        if side == "top":
+            return x + w / 2, y
+        return x + w / 2, y + h
+
+    lanes = {
+        ("roles", "users"): ["bottom", "top"],
+        ("products", "order_items"): ["right", "left"],
+        ("orders", "order_items"): ["left", "right"],
+        ("pickup_points", "orders"): ["top", "bottom"],
+    }
+
+    for table in tables:
+        for fk in foreign_keys[table]:
+            ref = fk["table"]
+            start_side, end_side = lanes.get((ref, table), ["right", "left"])
+            sx, sy = anchor(ref, start_side)
+            ex, ey = anchor(table, end_side)
+            mx = (sx + ex) / 2
+            path = f"M {sx:.0f} {sy:.0f} L {mx:.0f} {sy:.0f} L {mx:.0f} {ey:.0f} L {ex:.0f} {ey:.0f}"
+            svg.append(f'<path d="{path}" fill="none" stroke="black" stroke-width="2" marker-end="url(#arrow)"/>')
+            svg.append(svg_text(mx + 6, (sy + ey) / 2 - 4, "1:N", 13, "bold"))
+
+    for table in tables:
+        x, y, w, h = box(table)
+        svg.append(f'<rect x="{x}" y="{y}" width="{w}" height="{h}" fill="white" stroke="black" stroke-width="2"/>')
+        svg.append(f'<rect x="{x}" y="{y}" width="{w}" height="36" fill="white" stroke="black" stroke-width="2"/>')
+        svg.append(svg_text(x + 12, y + 24, table, 16, "bold"))
+        cy = y + 60
+        fk_columns = {fk["from"] for fk in foreign_keys[table]}
+        for col in columns[table]:
+            marks = []
+            if col["pk"]:
+                marks.append("PK")
+            if col["name"] in fk_columns:
+                marks.append("FK")
+            suffix = f" [{' '.join(marks)}]" if marks else ""
+            svg.append(svg_text(x + 12, cy, f"{col['name']}: {col['type'] or 'TEXT'}{suffix}", 13))
+            cy += 24
+    svg.append("</svg>")
+
+    return """<!doctype html>
+<html lang="ru">
+<head>
+  <meta charset="utf-8">
+  <title>SQLite DB Diagram</title>
+  <style>
+    body { margin: 0; padding: 24px; background: white; color: black; font-family: Arial, sans-serif; }
+    .hint { margin: 0 0 16px; font-size: 14px; }
+    svg { max-width: 100%%; height: auto; border: 1px solid #ddd; }
+  </style>
+</head>
+<body>
+  <p class="hint">Откройте этот файл в браузере. Дополнительные расширения и интернет не нужны.</p>
+  %s
+</body>
+</html>
+""" % "\n  ".join(svg)
+
+
+def write_output(content, output):
+    if output == "-":
+        print(content, end="")
+        return None
+    path = Path(output)
+    path.write_text(content, encoding="utf-8")
+    return path
+
+
+def main(argv=None):
+    parser = argparse.ArgumentParser(description="Generate a database diagram for sqlite-sh.")
+    parser.add_argument(
+        "--format",
+        choices=("html", "mermaid"),
+        default="html",
+        help="Output format. html opens directly in a browser; mermaid writes .mmd text.",
+    )
+    parser.add_argument("-o", "--output", help="Output file. Use '-' for stdout.")
+    args = parser.parse_args(argv)
+
+    tables, columns, foreign_keys = load_schema()
+    if args.format == "mermaid":
+        content = render_mermaid(tables, columns, foreign_keys)
+        output = args.output or DEFAULT_MERMAID
+    else:
+        content = render_html(tables, columns, foreign_keys)
+        output = args.output or DEFAULT_HTML
+
+    path = write_output(content, output)
+    if path:
+        print(f"Диаграмма сохранена: {path.resolve()}")
+
+
+if __name__ == "__main__":
+    main()

{sqlite_sh-0.1.0 → sqlite_sh-0.1.1/sqlite_sh.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sqlite-sh
-Version: 0.1.0
+Version: 0.1.1
 Summary: SQLite-backed Tkinter shoe shop demo application
 Author-email: adwedelf <adwedelf@users.noreply.github.com>
 License-Expression: MIT
@@ -37,6 +37,8 @@ pip install sqlite-sh
 shop
 ```
 
+Detailed usage is also installed inside the package as `sqlite_sh/USAGE.md`.
+
 On first import/run, the packaged seed database is copied to:
 
 ```text
@@ -93,3 +95,17 @@ PyPI:
 ```bash
 python -m twine upload dist/*
 ```
+
+## Easy DB diagram
+
+Create a browser-ready HTML/SVG database diagram without extra tools:
+
+```bash
+sqlite-sh-diagram
+```
+
+This writes `db_diagram.html`, which can be opened directly in Edge or any modern browser. Mermaid output is still available:
+
+```bash
+sqlite-sh-diagram --format mermaid -o db_diagram.mmd
+```

{sqlite_sh-0.1.0 → sqlite_sh-0.1.1}/sqlite_sh.egg-info/SOURCES.txt

@@ -1,6 +1,7 @@
 LICENSE
 README.md
 pyproject.toml
+sqlite_sh/USAGE.md
 sqlite_sh/__init__.py
 sqlite_sh/__main__.py
 sqlite_sh/algorithm_flowchart_gost.pdf

sqlite_sh-0.1.0/sqlite_sh/__init__.py

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

sqlite_sh-0.1.0/sqlite_sh/diagram.py

@@ -1,37 +0,0 @@
-import sqlite3
-
-from sqlite_sh.config import DB_FILE
-
-
-def main():
-    if not DB_FILE.exists():
-        raise SystemExit("База данных не найдена. Сначала выполните: python bootstrap_db.py")
-
-    with sqlite3.connect(DB_FILE) as conn:
-        tables = [
-            row[0]
-            for row in conn.execute(
-                "SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%' ORDER BY name"
-            )
-        ]
-
-        print("erDiagram")
-        for table in tables:
-            print(f"    {table} {{")
-            for col in conn.execute(f"PRAGMA table_info({table})"):
-                col_name = col[1]
-                col_type = col[2] or "TEXT"
-                pk = " PK" if col[5] else ""
-                print(f"        {col_type} {col_name}{pk}")
-            print("    }")
-
-        for table in tables:
-            for fk in conn.execute(f"PRAGMA foreign_key_list({table})"):
-                ref_table = fk[2]
-                from_col = fk[3]
-                to_col = fk[4]
-                print(f"    {ref_table} ||--o{{ {table} : \"{to_col} to {from_col}\"")
-
-
-if __name__ == "__main__":
-    main()