
django-rust-templates:用 Rust 重写 Django 模板引擎,渲染速度提升约15倍
来源标题:Django-rust-templates – A drop-in Rust replacement for Django's template engine
django-rust-templates 发布了 0.1 版,用 Rust 原生重实现了 Django 模板引擎,可直接替换 DjangoTemplates 后端。该项目称其输出与原生 Django 逐字节一致,并通过 Django 5.2 和 6.1 的全部模板测试套件,基准测试中渲染约快 15 倍、编译约快 12 倍。目前仍处于早期阶段,尚未经过广泛生产环境验证。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
Django 模板引擎的直接替代方案,用 Rust 编写。它原生重新实现了 Django 模板语言:词法分析器、解析器、节点树、渲染器,以及内置标签和过滤器。它的输出与原生 Django 逐字节相同,并在 Django 5.2 和 6.1 上通过了 Django 自身模板测试套件的 100%。在下面的基准测试中,它的渲染速度约为原生 Django 的 15 倍,模板编译速度约为 12 倍。
TEMPLATES = [
"BACKEND": "django_rust_templates.RustTemplates", # was django.template.backends.django.DjangoTemplates
"DIRS": [BASE_DIR / "templates"],
"APP_DIRS": True,
"OPTIONS": {"context_processors": [...]}, # same options as DjangoTemplates
状态:早期阶段(0.1)。正确性以 Django 自身的测试套件为门槛,但该项目尚未经过大规模生产使用。
安装 用法 兼容性 性能 测试 工作原理 开发 许可证
安装
pip install django-rust-templates
为 CPython 3.12、3.13 和 3.14 在 Linux x86_64 和 aarch64 上发布了预编译 wheel(manylinux glibc ≥ 2.28 和 musllinux)。它要求 Django ≥ 5.2。
在其他平台上,pip 会回退到源码分发,或者你可以从 git 构建。无论哪种方式,你都需要 Rust 工具链(rustup;rust-toolchain.toml 中固定的版本会自动安装)以及 Python ≥ 3.12。
pip install git+https://github.com/MasonLyons/rust-django-template-engine.git
或者从检出目录安装:
git clone https://github.com/MasonLyons/rust-django-template-engine.git
cd rust-django-template-engine
pip install .
用法
作为 Django 后端
在 TEMPLATES 中替换 BACKEND(见上文)。RustTemplates 接受与 DjangoTemplates 相同的 DIRS、APP_DIRS 和 OPTIONS:context_processors、debug、loaders、string_if_invalid、file_charset、libraries、builtins 和 autoescape。render()、render_to_string()、模板加载器、{% load %} 以及你的自定义标签库都可以照常工作。
Django 通过 FORM_RENDERER 渲染表单和控件({{ form }}、{{ field }}、form.as_div),其默认实现构建自己的原生模板引擎,因此表单 HTML 根本不会经过 TEMPLATES。要让它也原生渲染:
FORM_RENDERER = "django_rust_templates.forms.RustFormRenderer"
它加载与 Django 默认 DjangoTemplates 渲染器相同的内置表单模板(以及每个应用的 templates 目录),因此输出完全相同。渲染一个 8 字段的表单大约快 2.6 倍;其余时间花在 Django 自身的表单和控件代码上。
Engine 镜像 django.template.Engine(与原生引擎一样,必须配置 Django settings):
from django.template import Context
from django_rust_templates import Engine
engine = Engine(dirs=["templates"], libraries={"mytags": "myapp.templatetags.mytags"})
template = engine.from_string("Hello {{ user.name|title }}!")
template.render(Context({"user": {"name": "ada lovelace"}})) # 'Hello Ada Lovelace!'
兼容性
| 项目 | 支持情况 |
|---|---|
| Django | 5.2 LTS、6.1 |
| Python | 3.12、3.13、3.14 |
| 平台 | Linux x86_64 和 aarch64(例如 AWS Graviton),已在 CI 中测试;任何 Rust 和 PyO3 支持的目标都应该可以构建 |
输出一致性。渲染输出、错误类型和错误消息(包括行号以及 Django 6.1 的 Template: name, prefix)与原生 Django 完全一致。任何差异都是 bug,请提交 issue。
内置标签和过滤器原生运行,包括 extends/block、include、for、if、with、cycle、url、csrf_token、Django 6.1 的 partialdef/partial、{% translate "literal" %}、{% blocktranslate %}、{% static %},以及 date、floatformat、urlize、join、striptags、truncatechars_html/truncatewords_html 和 filesizeformat 等过滤器,外加 humanize 的 naturaltime,以及针对整数的 intcomma、intword 和 ordinal。
自定义和第三方标签库继续可用。simple_tag 和 inclusion_tag 在原生辅助节点上运行。其他标签(自定义编译函数、simple_block_tag)会桥接到其 Python 实现,因此它们自己的代码以 Python 速度运行,而模板的其余部分保持原生。当桥接的块标签(例如 {% localtime %}、{% cache %}、simple_block_tag)调用 parser.parse() 时,其主体在 Rust 解析器上编译并原生渲染。
Python 节点 API(template.nodelist、get_nodes_by_type、render_annotated)通过兼容原生实现的适配器节点暴露,因此检查已编译模板的工具可以继续工作。
性能
每次操作的微秒数;越低越好。× 是相对于原生 Django 的加速比。
Linux x86_64(AMD EPYC 7601),Python 3.13.15,Django 6.1.2,release 构建。
方法论。benchmarks/bench.py 首先在两个引擎上渲染每个场景,除非输出逐字节相同否则中止,因为错误输出上的加速毫无价值。然后它在各自的子进程中为每个引擎计时(这样两者都不会继承对方的分配器或 GC 状态),固定到一个 CPU 核心,并报告 7 次 timeit 重复的最小值。"Compile" 是一次模板解析。在 cached_extends 和 realistic_page(缓存加载器)中,它是缓存命中的 get_template(),即生产环境中的每请求成本。
HTML 转义和词法分析器的标签扫描器使用可移植 SIMD:fearless_simd 在 x86_64 上选择 SSE2,在 aarch64 上选择 NEON,memchr 在运行时选择最佳指令集。
Django 还附带一个 Jinja2 后端,当 DTL 太慢时,Jinja2 是常见选择。benchmarks/jinja2_bench.py 通过全部三个引擎运行相同的场景。每个场景都有一个手写的 Jinja2 模板,以惯用的 Jinja2(loop.cycle、super()、p.full())完成相同的工作,除非所有三个输出逐字节匹配,否则脚本会中止。唯一的例外是实体的拼写方式:markupsafe 写 ' 而 Django 写 '。
与上述相同的机器;Jinja2 3.1.6。在相同行上,Jinja2 的渲染速度是原生 Django 的 3.35 倍,而此引擎的渲染速度是 16.54 倍。
maturin develop --release
python benchmarks/bench.py # full table
python benchmarks/bench.py --only realistic # filter scenarios
python benchmarks/realworld.py # end-to-end page via the backend
python benchmarks/jinja2_bench.py # stock vs Jinja2 vs Rust (pip install jinja2)
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。