jinja3kit 1.2.2__tar.gz → 1.2.4__tar.gz

{jinja3kit-1.2.2 → jinja3kit-1.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jinja3kit
-Version: 1.2.2
+Version: 1.2.4
 Summary: A simple Python toolkit for generating Flask-based web projects with PostgreSQL support.
 Author: JINJA
 Requires-Python: >=3.10

{jinja3kit-1.2.2 → jinja3kit-1.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "jinja3kit"
-version = "1.2.2"
+version = "1.2.4"
 description = "A simple Python toolkit for generating Flask-based web projects with PostgreSQL support."
 readme = "README.md"
 requires-python = ">=3.10"

jinja3kit-1.2.4/src/jinja3kit/__init__.py

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

jinja3kit-1.2.4/src/jinja3kit/cli.py

@@ -0,0 +1,49 @@
+from __future__ import annotations
+
+# cli.py нужен, если проект используется как шаблон-пакет.
+# Команда jinja3-create копирует готовую папку template в новый проект.
+
+import argparse
+import shutil
+from importlib.resources import files
+from pathlib import Path
+
+
+def create_project(target: str, force: bool = False) -> Path:
+    """Создаёт новый проект из папки template."""
+    target_path = Path(target).resolve()
+    template_path = files("jinja3kit").joinpath("template")
+
+    # Если папка уже существует, без --force проект не перезаписывается.
+    if target_path.exists():
+        if not force:
+            raise SystemExit(
+                f"Папка уже существует: {target_path}\n"
+                f"Используй --force, если хочешь перезаписать её."
+            )
+        shutil.rmtree(target_path)
+
+    # Копируем весь шаблон: app.py, db.py, templates, static, sql-файлы.
+    shutil.copytree(template_path, target_path)
+    return target_path
+
+
+def main() -> None:
+    """Точка входа для консольной команды jinja3-create."""
+    parser = argparse.ArgumentParser(
+        prog="jinja3-create",
+        description="Create a neutral Flask + PostgreSQL starter project."
+    )
+    parser.add_argument("name", help="Название папки нового проекта")
+    parser.add_argument("--force", action="store_true", help="Перезаписать папку, если она уже есть")
+    args = parser.parse_args()
+
+    project_path = create_project(args.name, args.force)
+
+    print(f"Проект создан: {project_path}")
+    print("")
+    print("Дальше:")
+    print(f"  cd {project_path.name}")
+    print("  copy .env.sample .env")
+    print("  pip install -r requirements.txt")
+    print("  python app.py")

jinja3kit-1.2.4/src/jinja3kit/template/README_/320/227/320/220/320/237/320/243/320/241/320/232.md

@@ -0,0 +1,57 @@
+# ООО «МирИгрушек» — Flask + PostgreSQL + Pillow
+
+Готовый вариант по примеру: магазин игрушек, PostgreSQL/pgAdmin, Flask, загрузка и обработка изображений через Pillow.
+
+## Что реализовано
+
+- вход по логину и паролю из базы данных;
+- режим гостя;
+- роли: гость, авторизированный клиент, менеджер, администратор;
+- просмотр каталога игрушек;
+- для менеджера и администратора: поиск, фильтрация, сортировка;
+- для администратора: добавление, редактирование, удаление игрушек;
+- просмотр заказов;
+- для администратора: добавление, редактирование, удаление заказов;
+- загрузка фото с обработкой Pillow до 300×200;
+- стиль по заданию: Arial, #FFFFFF, #F5DEB3, #DEB887, скидка больше 17% — #FFDEAD.
+
+## Создание базы
+
+В pgAdmin создай базу:
+
+```sql
+CREATE DATABASE toy_store;
+```
+
+Потом открой Query Tool в базе `toy_store` и выполни файл:
+
+```text
+db/full_init.sql
+```
+
+## Настройка подключения
+
+В файле `db.py` поменяй пароль PostgreSQL:
+
+```python
+"password": "123456789"
+```
+
+## Запуск
+
+```bash
+python -m venv .venv
+.venv\Scripts\activate
+pip install -r requirements.txt
+python app.py
+```
+
+Сайт: http://127.0.0.1:5000
+
+## Тестовые логины
+
+Администратор: 94d5ous@gmail.com / uzWC67
+Менеджер: 1diph5e@tutanota.com / 8ntwUp
+Клиент: 5d4zbu@tutanota.com / rwVDh9
+
+Remove-Item (Get-PSReadLineOption).HistorySavePath

{jinja3kit-1.2.2 → jinja3kit-1.2.4}/src/jinja3kit/template/app.py

@@ -1,6 +1,3 @@
-# Основной файл Flask-приложения.
-# Здесь находятся настройки сайта, авторизация, маршруты, работа с товарами, заказами и изображениями.
-
 import os, uuid
 from functools import wraps
 from pathlib import Path
@@ -13,39 +10,21 @@ from werkzeug.utils import secure_filename
 
 from db import execute, fetch_all, fetch_one, get_conn
 
-# BASE — путь к папке проекта. Нужен, чтобы правильно сохранять и удалять файлы.
 BASE = Path(__file__).resolve().parent
-# UPLOADS — папка для фотографий товаров, которые загружает администратор.
 UPLOADS = BASE / "static" / "uploads"
-# Названия ролей. По ним проверяются права доступа к разделам сайта.
 ADMIN, MANAGER = "Администратор", "Менеджер"
-# Разрешённые расширения изображений для загрузки через Pillow.
 IMG_EXT = {"jpg", "jpeg", "png", "webp"}
-# Поля таблицы products, которые используются при добавлении и редактировании товара.
-# Если в новой БД изменятся поля товара, в первую очередь меняется этот список.
 PRODUCT_FIELDS = "article_number product_name unit price stock_quantity discount_percent description photo_url id_category id_supplier id_manufacturer".split()
-# Поля таблицы orders, которые используются при добавлении и редактировании заказа.
 ORDER_FIELDS = "order_number order_date delivery_date pickup_code id_user id_pickup_point id_status".split()
 
-# Создаём объект Flask-приложения.
 app = Flask(__name__)
-# SECRET_KEY нужен для сессий и flash-сообщений.
-# MAX_CONTENT_LENGTH ограничивает размер загружаемого файла до 8 МБ.
-app.config.update(SECRET_KEY=os.getenv("SECRET_KEY", "secret-key"), MAX_CONTENT_LENGTH=8 * 1024 * 1024)
-
+app.config.update(SECRET_KEY=os.getenv("SECRET_KEY", "demo-exam-secret-key"), MAX_CONTENT_LENGTH=8 * 1024 * 1024)
 
 
-# Возвращает текущего пользователя из session. Если никто не вошёл — вернёт None.
 def me(): return session.get("user")
-# Возвращает роль текущего пользователя: Гость, Клиент, Менеджер или Администратор.
 def role(): return (me() or {}).get("role_name")
-# Проверяет, входит ли текущая роль в список разрешённых ролей.
 def has(*roles): return role() in roles
 
-
-# Декоратор защиты страниц.
-# Если пользователь не вошёл — отправляет на страницу входа.
-# Если роль не подходит — запрещает действие и возвращает к товарам.
 def need(*roles):
     def deco(f):
         @wraps(f)
@@ -61,9 +40,6 @@ def need(*roles):
     return deco
 
 
-
-# context_processor добавляет переменные и функции сразу во все HTML-шаблоны.
-# Благодаря этому в templates можно использовать current_user, is_admin, product_image_url и т.д.
 @app.context_processor
 def ctx():
     def img(p):
@@ -72,15 +48,10 @@ def ctx():
                 can_search_products=has(ADMIN, MANAGER), can_view_orders=has(ADMIN, MANAGER), product_image_url=img)
 
 
-
-# Берёт значение из формы или GET-параметров и убирает лишние пробелы.
 def val(name, default=""):
     return request.values.get(name, default).strip()
 
 
-
-# Проверяет числовые поля формы: цена, скидка, количество, id справочников.
-# Если введено не число или число выходит за границы — выбрасывает понятную ошибку.
 def num(name, title, kind=float, pos=False, maxv=None):
     try:
         x = kind(str(request.form.get(name, "0")).replace(",", ".")) if kind is float else kind(request.form.get(name, "0"))
@@ -93,10 +64,6 @@ def num(name, title, kind=float, pos=False, maxv=None):
     return x
 
 
-
-# Загружает справочники для форм.
-# Для товара нужны категории, поставщики, производители.
-# Для заказа нужны пользователи, пункты выдачи, статусы и товары.
 def refs(kind):
     if kind == "product":
         return dict(categories=fetch_all("SELECT * FROM categories ORDER BY category_name"),
@@ -108,10 +75,6 @@ def refs(kind):
                 products=fetch_all("SELECT id_product, article_number, product_name, price FROM products ORDER BY article_number"))
 
 
-
-# Сохраняет изображение товара через Pillow.
-# Проверяет формат, уменьшает фото до 300x200 и сохраняет в static/uploads.
-# При редактировании товара старое загруженное фото удаляется.
 def save_img(file, old=None):
     if not file or not file.filename:
         return old
@@ -130,12 +93,9 @@ def save_img(file, old=None):
     return f"uploads/{name}"
 
 
-
-# Собирает данные товара из HTML-формы.
-# Здесь проверяются обязательные поля, цена, скидка, количество и справочники.
 def product_from_form(old_photo=None):
     if not val("article_number") or not val("product_name"):
-        raise ValueError("Артикул и наименование товара обязательны")
+        raise ValueError("Артикул и наименование игрушки обязательны")
     return dict(article_number=val("article_number"), product_name=val("product_name"), unit=val("unit", "шт.") or "шт.",
                 price=num("price", "Цена"), stock_quantity=num("stock_quantity", "Кол-во на складе", int),
                 discount_percent=num("discount_percent", "Скидка", maxv=100), description=val("description"),
@@ -143,9 +103,6 @@ def product_from_form(old_photo=None):
                 id_supplier=num("id_supplier", "Поставщик", int, True), id_manufacturer=num("id_manufacturer", "Производитель", int, True))
 
 
-
-# Универсальная функция для товара.
-# Если pid есть — обновляет товар, если pid нет — добавляет новый товар.
 def upsert_product(data, pid=None):
     cols = ", ".join(PRODUCT_FIELDS)
     if pid:
@@ -155,10 +112,6 @@ def upsert_product(data, pid=None):
         execute(f"INSERT INTO products ({cols}) VALUES ({', '.join(f'%({c})s' for c in PRODUCT_FIELDS)})", data)
 
 
-
-# Разбирает состав заказа из текстового поля.
-# Формат: артикул, количество. Например: 12345, 2
-# По артикулу ищет товар в БД и берёт его цену.
 def parse_items(raw):
     parts = [x.strip() for x in raw.replace(";", ",").replace("\n", ",").split(",") if x.strip()]
     if not parts or len(parts) % 2:
@@ -167,7 +120,7 @@ def parse_items(raw):
     for art, qty in zip(parts[::2], parts[1::2]):
         p = fetch_one("SELECT id_product, price FROM products WHERE article_number=%s", (art,))
         if not p:
-            raise ValueError(f"Товар с артикулом {art} не найден")
+            raise ValueError(f"Игрушка с артикулом {art} не найден")
         q = int(qty)
         if q <= 0:
             raise ValueError(f"Количество для {art} должно быть больше нуля")
@@ -175,8 +128,6 @@ def parse_items(raw):
     return items
 
 
-
-# Собирает данные заказа из HTML-формы и проверяет обязательные поля.
 def order_from_form():
     if not val("pickup_code") or not val("order_date"):
         raise ValueError("Номер заказа, дата заказа и код получения обязательны")
@@ -187,9 +138,6 @@ def order_from_form():
                 items=parse_items(raw), items_text=raw)
 
 
-
-# Сохраняет заказ и его состав.
-# При редактировании старые позиции заказа удаляются и записываются заново.
 def save_order(data, oid=None):
     with get_conn() as conn, conn.cursor(cursor_factory=RealDictCursor) as cur:
         if oid:
@@ -203,15 +151,10 @@ def save_order(data, oid=None):
                         [(oid, pid, qty, price) for pid, qty, price in data["items"]])
 
 
-
-# Главная страница: если пользователь вошёл — открывает товары, иначе страницу входа.
 @app.route("/")
 def index(): return redirect(url_for("products" if me() else "login"))
 
 
-
-# Страница входа.
-# GET показывает форму, POST проверяет логин и пароль в таблице users.
 @app.route("/login", methods=["GET", "POST"])
 def login():
     if request.method == "POST":
@@ -225,18 +168,13 @@ def login():
     return render_template("login.html")
 
 
-
-# Вход без логина и пароля.
-# Гость может только просматривать товары, без поиска, заказов и админских действий.
 @app.route("/guest")
 def guest_login():
     session["user"] = dict(id_user=0, last_name="", first_name="Гость", middle_name="", login="guest", role_name="Гость")
-    flash("Вы вошли в режиме гостя. Доступен только просмотр товаров", "info")
+    flash("Вы вошли в режиме гостя. Доступен только просмотр игрушек", "info")
     return redirect(url_for("products"))
 
 
-
-# Выход из аккаунта: очищает session и возвращает на страницу входа.
 @app.route("/logout")
 def logout():
     session.clear()
@@ -244,10 +182,6 @@ def logout():
     return redirect(url_for("login"))
 
 
-
-# Каталог товаров.
-# Администратор и менеджер могут искать, фильтровать и сортировать товары.
-# Гость и клиент видят только список товаров.
 @app.route("/products")
 @need()
 def products():
@@ -264,48 +198,39 @@ def products():
                            suppliers=fetch_all("SELECT * FROM suppliers ORDER BY supplier_name"), search=search, selected_supplier=supplier, sort=sort)
 
 
-
-# Одна функция сразу для добавления и редактирования товара.
-# /products/add — добавление, /products/<id>/edit — редактирование.
 @app.route("/products/add", methods=["GET", "POST"], defaults={"product_id": None}, endpoint="product_add")
 @app.route("/products/<int:product_id>/edit", methods=["GET", "POST"], endpoint="product_edit")
 @need(ADMIN)
 def product_form(product_id):
     product = fetch_one("SELECT * FROM products WHERE id_product=%s", (product_id,)) if product_id else None
     if product_id and not product:
-        flash("Товар не найден", "danger"); return redirect(url_for("products"))
+        flash("Игрушка не найдена", "danger"); return redirect(url_for("products"))
     if request.method == "POST":
         try:
             upsert_product(product_from_form(product["photo_url"] if product else None), product_id)
-            flash("Товар обновлен" if product_id else "Товар добавлен", "success")
+            flash("Игрушка обновлена" if product_id else "Игрушка добавлена", "success")
             return redirect(url_for("products"))
         except errors.UniqueViolation:
-            flash("Товар с таким артикулом уже существует", "danger")
+            flash("Игрушка с таким артикулом уже существует", "danger")
         except Exception as e:
             flash(str(e), "danger")
-    return render_template("product_form.html", product=product, refs=refs("product"), title="Редактирование товара" if product_id else "Добавление товара")
-
+    return render_template("product_form.html", product=product, refs=refs("product"), title="Редактирование игрушки" if product_id else "Добавление игрушки")
 
 
-# Удаление товара.
-# Если товар уже есть в заказах, удалить его нельзя, чтобы не сломать историю заказов.
 @app.post("/products/<int:product_id>/delete")
 @need(ADMIN)
 def product_delete(product_id):
     p = fetch_one("SELECT photo_url FROM products WHERE id_product=%s", (product_id,))
     used = fetch_one("SELECT COUNT(*) cnt FROM order_items WHERE id_product=%s", (product_id,))
-    if not p: flash("Товар не найден", "danger")
-    elif used and used["cnt"]: flash("Нельзя удалить товар: он уже есть в заказах", "danger")
+    if not p: flash("Игрушка не найдена", "danger")
+    elif used and used["cnt"]: flash("Нельзя удалить игрушку: она уже есть в заказах", "danger")
     else:
         execute("DELETE FROM products WHERE id_product=%s", (product_id,))
         if p["photo_url"] and p["photo_url"].startswith("uploads/"): (BASE / "static" / p["photo_url"]).unlink(missing_ok=True)
-        flash("Товар удален", "success")
+        flash("Игрушка удалена", "success")
     return redirect(url_for("products"))
 
 
-
-# Список заказов.
-# Доступен только менеджеру и администратору.
 @app.route("/orders")
 @need(ADMIN, MANAGER)
 def orders():
@@ -316,9 +241,6 @@ def orders():
     return render_template("orders.html", orders=fetch_all(f"SELECT * FROM v_orders_details {where} ORDER BY order_date DESC, order_number DESC", params), search=search)
 
 
-
-# Одна функция сразу для добавления и редактирования заказа.
-# /orders/add — добавление, /orders/<id>/edit — редактирование.
 @app.route("/orders/add", methods=["GET", "POST"], defaults={"order_id": None}, endpoint="order_add")
 @app.route("/orders/<int:order_id>/edit", methods=["GET", "POST"], endpoint="order_edit")
 @need(ADMIN)
@@ -339,8 +261,6 @@ def order_form(order_id):
     return render_template("order_form.html", order=order, refs=refs("order"), title="Редактирование заказа" if order_id else "Добавление заказа", items_text="\n".join(f"{r['article_number']}, {r['quantity']}" for r in rows))
 
 
-
-# Удаление заказа. Позиции заказа удаляются автоматически по связи в БД или вручную через каскад.
 @app.post("/orders/<int:order_id>/delete")
 @need(ADMIN)
 def order_delete(order_id):
@@ -349,20 +269,13 @@ def order_delete(order_id):
     return redirect(url_for("orders"))
 
 
-
-# Обработчик ошибки 404 — страница не найдена.
 @app.errorhandler(404)
 def not_found(_): return render_template("error.html", title="404", message="Страница не найдена"), 404
 
 
-
-# Обработчик ошибки 500 — внутренняя ошибка сервера.
 @app.errorhandler(500)
 def server_error(e): return render_template("error.html", title="500", message=f"Ошибка сервера: {e}"), 500
 
 
-
-# Запуск приложения командой: python app.py
-# debug=True показывает ошибки в браузере, что удобно при разработке и на экзамене.
 if __name__ == "__main__":
     app.run(debug=True)