реализованы обертки для шаблонизации

Author: albertalexandrov

README.md

@@ -19,6 +19,7 @@
 - [Фильтрация, пагинация, сортировка.md](docs/%D0%A4%D0%B8%D0%BB%D1%8C%D1%82%D1%80%D0%B0%D1%86%D0%B8%D1%8F%2C%20%D0%BF%D0%B0%D0%B3%D0%B8%D0%BD%D0%B0%D1%86%D0%B8%D1%8F%2C%20%D1%81%D0%BE%D1%80%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%BA%D0%B0.md)
 - [Логгирование](docs/Логирование.md)
 - [Отправка электронных писем](docs/%D0%9E%D1%82%D0%BF%D1%80%D0%B0%D0%B2%D0%BA%D0%B0%20%D1%8D%D0%BB%D0%B5%D0%BA%D1%82%D1%80%D0%BE%D0%BD%D0%BD%D1%8B%D1%85%20%D0%BF%D0%B8%D1%81%D0%B5%D0%BC.md)
+- [Шаблонизация](docs/Шаблонизация.md)
 - [TODO](#todo)
 
 ## TODO
@@ -42,3 +43,4 @@
 -  [x] Пермишены
 -  [x] Аутентификация
 -  [x] Отправка электронных писем (мультибекенды)
+-  [x] Шаблонизация

docs/Шаблонизация.md

@@ -0,0 +1,39 @@
+# Шаблонизация
+
+Раньше, чтобы отрендерить шаблон приходилось выполнить 3 шага:
+
+```python
+from fastapi.templating import Jinja2Templates
+from datetime import datetime
+
+templates = Jinja2Templates(directory="app/mail_templates")
+mail_export_proposals = templates.get_template("export_proposals.html")
+body = mail_export_proposals.render(
+    file_link="http://localhost:8000/file-link", 
+    expire_datetime=datetime.now(),
+)
+```
+
+Теперь в отрендерить шаблон можно одной функцией `fastapi_django.template.render_to_string`:
+
+```python
+from fastapi_django.template import render_to_string
+from datetime import datetime
+
+render_to_string(
+    "export_proposals.html", 
+    context={
+        "file_link": "http://localhost:8000/file-link", 
+        "expire_datetime": datetime.now()
+    }
+)
+```
+
+`fastapi-django` под капотом создает объект `fastapi.templating.Jinja2Templates`, который также доступен для импорта 
+и прямого использования.
+
+Необходимые настройки:
+
+    - TEMPLATES_DIRECTORY - str, директория, из которой будут загружаться шаблоны. Значение по умолчанию templates (в корне проекта)
+    - TEMPLATES_CONTEXT_PROCESSORS - list, список функций, возвращающих словарь для добавления в контекст шаблона. 
+    - TEMPLATES_ENV_OPTIONS - dict, опции для объекта jinja2.Environment

fastapi_django/conf/global_settings.py

@@ -42,3 +42,8 @@
 EMAIL_USE_LOCALTIME = False
 
 DEFAULT_EMAIL_PROVIDER_ALIAS = "default"
+
+# рендеринг шаблонов
+
+TEMPLATES_DIRECTORY = "templates"
+TEMPLATES_ENV_OPTIONS: dict = {}

fastapi_django/template.py

@@ -0,0 +1,33 @@
+from jinja2 import Environment, Template, FileSystemLoader
+from starlette.templating import Jinja2Templates
+
+from fastapi_django.conf import settings
+
+
+def get_templates() -> Jinja2Templates:
+    kw = {}
+    if context_processors := getattr(settings, "TEMPLATES_CONTEXT_PROCESSORS", None):
+        kw["context_processors"] = context_processors
+    env_options = settings.TEMPLATES_ENV_OPTIONS
+    loader = FileSystemLoader(settings.TEMPLATES_DIRECTORY)
+    env_options.setdefault("loader", loader)
+    env_options.setdefault("autoescape", True)
+    env = Environment(**env_options)
+    kw["env"] = env
+    return Jinja2Templates(**kw)
+
+
+templates = get_templates()
+
+
+def render_to_string(template_name: str, context: dict | None = None) -> str:
+    template = templates.get_template(template_name)
+    context = context or {}
+    return template.render(**context)
+
+
+def get_template(template_name: str) -> Template:
+    return templates.get_template(template_name)
+
+
+TemplateResponse = templates.TemplateResponse

poetry.lock

@@ -10,7 +10,7 @@ check_untyped_defs = true
 
 [tool.poetry]
 name = "fastapi-django"
-version = "0.13.0"
+version = "0.14.6"
 description = ""
 authors = ["albertalexandrov <albert-ugatu@list.ru>"]
 packages = [{include = "fastapi_django"}]
@@ -42,6 +42,7 @@ cryptography = "^45.0.5"
 environs = "^14.2.0"
 typer = "^0.16.0"
 aiosmtplib = "^4.0.1"
+jinja2 = "^3.1.6"
 
 [tool.poetry.group.dev.dependencies]
 bandit = "^1.7.9"