pancake-web-template 0.1.0__tar.gz

pancake_web_template-0.1.0/LICENSE

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

pancake_web_template-0.1.0/PKG-INFO

@@ -0,0 +1,25 @@
+Metadata-Version: 2.4
+Name: pancake-web-template
+Version: 0.1.0
+Summary: Pancake 模板渲染插件 — Jinja2 模板引擎，为 pancake-web 提供 HTML 页面渲染
+License: MIT
+License-File: LICENSE
+Author: drayee
+Author-email: 1473443474@qq.com
+Requires-Python: >=3.10,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: jinja2 (>=3.1.0,<4.0.0)
+Requires-Dist: pancake-web (>=0.1.0)
+Requires-Dist: pancake_framework (>=0.2.0)
+Description-Content-Type: text/markdown
+
+# Pancake-Web-Template
+
+Pancake 模板渲染插件 — Jinja2 模板引擎，为 pancake-web 提供 HTML 页面渲染。
+

pancake_web_template-0.1.0/README.md

@@ -0,0 +1,3 @@
+# Pancake-Web-Template
+
+Pancake 模板渲染插件 — Jinja2 模板引擎，为 pancake-web 提供 HTML 页面渲染。

pancake_web_template-0.1.0/pancake_web_template/__init__.py

@@ -0,0 +1,40 @@
+"""Pancake 模板渲染插件 — Jinja2 模板引擎"""
+
+import logging
+
+from pancake.ovenware import InitAction
+
+logger = logging.getLogger(__name__)
+
+
+class Main(InitAction):
+    """模板渲染插件入口
+
+    init_order=51, 在 web(50) 之后加载。
+    通过猴子补丁扩展 web 插件的响应解析，支持模板渲染。
+    """
+
+    init_order = 51
+    build_order = 0
+
+    def __init__(self):
+        from pancake.registry import export
+
+        from pancake_web_template.template import render, template, register_filter, _patch_resolve_response
+        export(render)
+        export(template)
+        export(register_filter)
+
+        # 猴子补丁: 扩展 web 插件的 resolve_response
+        _patch_resolve_response()
+
+        logger.info("模板渲染插件已加载")
+
+    def check(self) -> bool:
+        """环境检查"""
+        try:
+            import jinja2
+            return True
+        except ImportError:
+            logger.error("缺少 jinja2 依赖，请执行: pip install jinja2")
+            return False

pancake_web_template-0.1.0/pancake_web_template/template.py

@@ -0,0 +1,94 @@
+"""Jinja2 模板引擎封装"""
+
+import logging
+import os
+
+from jinja2 import Environment, FileSystemLoader
+
+logger = logging.getLogger(__name__)
+
+_env: Environment = None
+
+
+def _get_env() -> Environment:
+    """获取或创建 Jinja2 Environment（单例）"""
+    global _env
+    if _env is None:
+        from pancake import settings
+
+        template_dir = settings.get("pancake.web.templates") or os.path.join("src", "templates")
+        debug = settings.get("pancake.web.debug") or False
+
+        if not os.path.isdir(template_dir):
+            os.makedirs(template_dir, exist_ok=True)
+            logger.info(f"模板目录已创建: {template_dir}")
+
+        loader = FileSystemLoader(template_dir)
+        _env = Environment(loader=loader, auto_reload=debug)
+        logger.info(f"Jinja2 引擎已初始化: {template_dir}")
+    return _env
+
+
+def render(template_name: str, **context):
+    """渲染模板，返回 HtmlResponse
+
+    Usage:
+        return render("home.html", title="首页", items=[1, 2, 3])
+    """
+    from pancake_web.response import HtmlResponse
+
+    env = _get_env()
+    tmpl = env.get_template(template_name)
+    html = tmpl.render(**context)
+    return HtmlResponse(html)
+
+
+def template(template_name: str):
+    """@template — 标记 handler 使用的模板名
+
+    handler 返回 dict 时自动渲染为 HTML 页面。
+
+    Usage:
+        @get("/home")
+        @template("home.html")
+        async def home(self, request):
+            return {"title": "首页", "items": [1, 2, 3]}
+    """
+    def decorator(func):
+        func._template_name = template_name
+        return func
+    return decorator
+
+
+def register_filter(name: str, func):
+    """注册 Jinja2 自定义过滤器
+
+    Usage:
+        register_filter("reverse", lambda s: s[::-1])
+    """
+    env = _get_env()
+    env.filters[name] = func
+    logger.debug(f"注册模板过滤器: {name}")
+
+
+def _patch_resolve_response():
+    """猴子补丁: 扩展 web 插件的 resolve_response，支持 @template 自动渲染"""
+    import pancake_web.decorators as web_decorators
+
+    _original_resolve = web_decorators.resolve_response
+
+    async def _patched_resolve(result, _handler=None):
+        # 如果 handler 有 @template 标记且返回 dict，渲染模板
+        if _handler and isinstance(result, dict) and hasattr(_handler, "_template_name"):
+            logger.info(f"渲染模板: {_handler._template_name}")
+            return render(_handler._template_name, **result)
+        return await _original_resolve(result)
+
+    web_decorators.resolve_response = _patched_resolve
+    logger.debug("resolve_response 已补丁")
+
+
+def reset_env():
+    """重置 Jinja2 环境（用于测试）"""
+    global _env
+    _env = None

pancake_web_template-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[tool.poetry]
+name = "pancake-web-template"
+version = "0.1.0"
+description = "Pancake 模板渲染插件 — Jinja2 模板引擎，为 pancake-web 提供 HTML 页面渲染"
+authors = ["drayee <1473443474@qq.com>"]
+license = "MIT"
+readme = "README.md"
+packages = [{include = "pancake_web_template"}]
+
+[tool.poetry.dependencies]
+python = "^3.10"
+pancake_framework = ">=0.2.0"
+pancake-web = ">=0.1.0"
+jinja2 = "^3.1.0"
+
+[tool.poetry.plugins."pancake.plugins"]
+web_template = "pancake_web_template:Main"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"