使用 Python 和 FastAPI 自动创建 Word 文档（使用 python-docx-template）

需要创建具有动态内容的 Word 文档并自动化该过程？ Python 和 python-docx-template 库提供了一个有效的解决方案。 本教程演示如何动态生成Word文档，无需手动更新。

让我们用发票示例来说明。 处理来自 API 的数据时，手动更新发票数据既乏味又不切实际。动态生成解决了这个问题。

考虑一个 Word 文档模板：

公司详细信息和项目列表经常发生变化。 动态生成处理这种可变性。

要实现此目的，请修改 Jinja2 兼容性模板。 Jinja2 的模板功能（条件渲染、循环）可根据提供的数据进行动态填充。

• 了解更多关于Jinja2的信息：https://www.php.cn/link/7ef6c2494e3925e414c7730d6455b50f

Jinja2 兼容模板如下所示：

Jinja2 语法（例如 {% if %} 和 {% for %}）最初可能看起来很复杂，但它提供了强大的控制。 {{ }} 中的表达式表示运行时填充的变量。 例如，{% if items %} 在渲染表行之前检查 items 变量是否存在。 {% for item in items %} 迭代 items 列表，为每个项目生成一行。

• 了解更多关于 Jinja2 标签：https://www.php.cn/link/a3a8185b610d2c5e39015f64972c8705 和https://www.php.cn/link/7ef6c2494e3925e414c7730d6455b50f

现在，让我们创建一个 FastAPI 服务器来使用 Python 渲染模板。

1. 创建虚拟环境：

   <code class="language-bash">pip3 install virtualenv
   virtualenv -p python3 venv
   source venv/bin/activate</code>

2. 安装库：

   <code class="language-bash">pip install "fastapi[standard]" docx docxtpl pydantic requests</code>

3. 创建main.py:从基本的FastAPI端点开始：

   <code class="language-python">from fastapi import FastAPI
   app = FastAPI()
   @app.get("/")
   def read_root():
       return {"Hello": "World"}</code>

   访问 localhost:8000 应返回 {"Hello": "World"}。

4. 导入 Jinja2 模板：将修改后的 invoice_tpl.docx 放在项目根目录中。

5. 增强main.py：以下代码处理模板渲染、图像获取和总量计算：

   <code class="language-bash">pip3 install virtualenv
   virtualenv -p python3 venv
   source venv/bin/activate</code>

6. 测试端点：将 JSON 负载（类似于原文中的示例）发送到 / 端点。

7. 输出示例：（此处将包含原文中的图像）

结论：本教程演示了使用 python-docx-template 和 FastAPI 生成动态 Word 文档。 Jinja2 和 FastAPI 的结合创建了一个用于自动化文档创建的灵活系统。 未来的博客文章（第 2 部分）将介绍 PDF 生成。

存储库：https://www.php.cn/link/1df146af0948a68b1342ce39907668fe

关注 Husein Kantarci：

• 个人作品集：huseink.dev
• 领英：https://www.php.cn/link/50de294b9d4987a3c89b4a5cc4bdea62
• GitHub：https://www.php.cn/link/f2f9990bcda13be8771d656bf489dad5
• GitLab：https://www.php.cn/link/33bd1b801b3cf1b8eaf31d816bca2c95

请记住将占位符图像 URL 替换为实际图像 URL。 该代码还假设您已定义必要的数据模型（Company、BankInformation、Item、VatInformation、InvoiceContext），如原始示例中所示。

以上是使用 Python 和 FastAPI 自动创建 Word 文档（使用 python-docx-template）的详细内容。更多信息请关注PHP中文网其他相关文章！