python使用docxtpl生成word模板

python-docxtpl包简单使用和实战，Python处理word，docx文件。

最近需要处理一些爬虫得到的数据来进行一些自动化报告的操作，因为需要生成的是word的报告，所以估选用docxtpl库来直接生成模板
docxtpl 模板标签主要来自jinja2，可以了解 jinja2语法，也有些额外的不一样，可以自行百度或者参考官方文档

开始

使用Pip安装docxtpl

pip install docxtpl

简单demo

根据官网的简单举例：

from docxtpl import DocxTemplate

doc = DocxTemplate("my_word_template.docx") # 读取模板
context = { \'company_name\' : "World company" } # 需要传入的字典， 需要在word对应的位置输入 {{ company_name }}
doc.render(context) # 渲染到模板中
doc.save("generated_doc.docx") # 生成一个新的模板

至此,就可以直接拿来实战了， 实战中包含了图片的替换和表格文本的一些插入。都是很简单的，就是将组成的字典渲染到word中去就可以

实战

#!/usr/bin/env python
# -*- encoding: utf-8 -*-
\'\'\'
@File    :   generate_word.py
@Time    :   2021/05/28 15:52:57
@Author  :   OD 
@Version :   1.0
\'\'\'

# here put the import lib
from docx import Document
from docx.shared import Pt

import datetime
from docxtpl import DocxTemplate, RichText, InlineImage
from docx.shared import Mm
import json

# 根据模板生成一个周报内容
class Generate2Word:
    def __init__(self):
        self.now = str(datetime.date.today() - datetime.timedelta(days=0)).replace("-", "").replace(" ", "")
        self.last = str(datetime.date.today() - datetime.timedelta(days=7)).replace("-", "").replace(" ", "")
        self.now = self.now[4:6] + \'.\' + self.now[6:] # 现在时间
        self.last = self.last[4:6] + \'.\' + self.last[6:] # 7天前时间

    def generate_report(self, tpl_file, report_file):
        tpl= DocxTemplate(tpl_file)
        # 第一个图表
        context = {
            \'start_time\' : self.last,
            \'end_time\' : self.now,
            \'total_attention\': 123,
            \'add_attention\': 20,
            \'dau\': 100,
            \'dau_per\':20 / 100,
            \'theme_tiezi\':1234,
            \'all_tiezi\': 12345,
            \'add_theme_tiezi\': 25,
            \'add_tiezi\': 20,
            \'official_pub\':12,
            \'del_tiezi\': 5,
        }
       
        image1_path = r\'1.png\' # 要生成的图片地址
        image2_path = r\'2.png\' # 要生成的图片地址
        insert_image1 = InlineImage(tpl, image1_path, width=Mm(140))
        insert_image2 = InlineImage(tpl, image2_path, width=Mm(140))

        # 作为图片的替换
        img_context = {
            \'img1\': insert_image1,
            \'img2\': insert_image2
        }

        # 管理帖子，需要渲染
        bawu_lists = {
            "bawu_table": 
                [{
                    \'publish_time\': \'2021/5/7\',
                    \'title\': \'测试1\',
                    \'link\': \'https://www.baidu,com,
                    \'reply_num\': 27
                },
                {
                    \'publish_time\': \'2021/5/8\',
                    \'title\': \'测试2\',
                    \'link\': \'https://www.baidu,com\',
                    \'reply_num\': 4
                },
                {
                    \'publish_time\': \'2021/5/31\',
                    \'title\': \'湖人浓眉伤退\',
                    \'link\': \'https://www.baidu,com\',
                    \'reply_num\': 40
                },
                {
                    \'publish_time\': \'2021/6/2\',
                    \'title\': \'勒布朗詹姆斯率队拿下g5\',
                    \'link\': \'https://www.baidu,com\',
                    \'reply_num\': 444
                }
                ],
            "navy_table":
                [{
                    \'publish_time\': \'2021/4/23\',
                    \'title\': \'测试3\',
                    \'link\': \'https://www.baidu,com\',
                    \'reply_num\': 444
                },
                {
                    \'publish_time\': \'2021/4/30\',
                    \'title\': \'测试4\',
                    \'link\': \'https://www.baidu,com\',
                    \'reply_num\': 444
                },
                {
                    \'publish_time\': \'2021/5/30\',
                    \'title\': \'测试5\',
                    \'link\': \'https://www.baidu,com\',
                    \'reply_num\': 444
                }
                ]
        }
        bawu_summary = dict()
        bawu_sum_reply = 0 # 总有多少个回复
        for bawu_data in bawu_lists.get(\'bawu_table\'):
            bawu_summary[\'bawu_publish_num\'] = len(bawu_lists.get(\'bawu_table\', 0))
            bawu_sum_reply += int(bawu_data.get(\'reply_num\', 0))
        bawu_summary[\'bawu_sum_reply\'] = bawu_sum_reply

        navy_summary = dict()
        navy_sum_reply = 0
        for navy_data in bawu_lists.get(\'navy_table\'):
            navy_summary[\'navy_publish_num\'] = len(bawu_lists.get(\'navy_table\', 0))
            navy_sum_reply += int(navy_data.get(\'reply_num\', 0))
        navy_summary[\'navy_sum_reply\'] = navy_sum_reply
        
        tpl.render({**context, **img_context, ** bawu_lists, **bawu_summary, **navy_summary}) # 多个字典解构
        print(\'生成模板成功...\')
        tpl.save(report_file)

    def main(self):
        tpl_file = "文件模板.docx"  # 指定的模板
        report_file = f"新得{self.last}-{self.now}报告.docx" # 指定生成的报告位置
        self.generate_report(tpl_file, report_file)

if __name__ == \'__main__\':
    demo = Generate2Word()
    demo.main()

这样 就可以生成一个保留 word 格式的一个报告。工作也完成了

参考：
1、https://www.jianshu.com/p/758679db62ce
2、https://www.jianshu.com/p/465516750da6