笔者在工作中时常遇到以下的问题：

• 作为文档汇总人，需要合并其他同事发来的内容。虽然有同样的文档模板，但由于不同人协作编写，所以在格式和内容编写风格上都千差万别，汇总工作耗时耗力。
• 时常编写内容差别不大的数据分析报告(基于简单统计、对比分析)，每次都根据数据变化情况进行内容修改，重复繁杂。
• 嫌文档格式、模板调整工作无聊、枯燥无味，但又不得不做。

相信很多朋友也一样经历过类似的麻烦事情，但从现在开始，上诉问题都将慢慢的不复存在。因为，今天我要分享的内容就是：使用Python自动生成报告。让机器为人干活，是人类今后发展的方向。

首先，介绍下要用的工具：python的docx库。

安装方法很简单：

(1)pip安装

pip install python-docx

(2)easy_install安装

easy_install python-docx

(3)下载安装包，进行手动安装

tar xvzf python-docx-{version}.tar.gzcd python-docx-{version}python setup.py install

以下是官方示例：

from docx import Documentfrom docx.shared import Inchesdocument = Document()document.add_heading('Document Title', 0)p = document.add_paragraph('A plain paragraph having some ')p.add_run('bold').bold = Truep.add_run(' and some ')p.add_run('italic.').italic = Truedocument.add_heading('Heading, level 1', level=1)document.add_paragraph('Intense quote', style='Intense Quote')document.add_paragraph(    'first item in unordered list', style='List Bullet')document.add_paragraph(    'first item in ordered list', style='List Number')document.add_picture('monty-truth.png', width=Inches(1.25))records = (    (3, '101', 'Spam'),    (7, '422', 'Eggs'),    (4, '631', 'Spam, spam, eggs, and spam'))table = document.add_table(rows=1, cols=3)hdr_cells = table.rows[0].cellshdr_cells[0].text = 'Qty'hdr_cells[1].text = 'Id'hdr_cells[2].text = 'Desc'for qty, id, desc in records:    row_cells = table.add_row().cells    row_cells[0].text = str(qty)    row_cells[1].text = id    row_cells[2].text = descdocument.add_page_break()document.save('demo.docx')

运行完就可以看到效果了。(大家可以自行尝试)

看完了docx库基本功能介绍，接下来开始讲解文档自动生成的全过程。我们以系统运维人员每日编写的简报自动生成场景为例。

第一步：运维数据统计表设计

运维基础数据统计表设计

从图中可以看到，我们的基础数据统计表由几个核心字段组成：系统名称、主机IP、主机用途、CPU使用情况、内存使用情况、磁盘使用情况、告警次数、故障次数、已处理故障次数、告警详细描述、故障详细描述、 处置结果描述和拟采取措施等。这些字段基本上可以记录系统当日运行情况，后面的报告也是基于这些基本信息进行生成。

先读入数据。

#读入运维数据统计表data_path = 'report_tmp-模板.csv' #基础模板数据df_tmp = pd.read_csv(data_path,encoding='gbk')#中文cols = list(df_tmp.columns)df_tmp = df_tmp.fillna('无')

第二步：进行数据分析逻辑描述

先想象一下报告由自己人工来编写，需要从哪些方面去分析数据呢？先按一套系统维度来看，首先是有没有发生故障？故障是不是已经处置？如何处置的？其次，是看有没有告警？是否有风险？最后，是资源使用情况，是否正常？

理清思路之后，就可以按顺序将描述过程用Python代码进行翻译，拼接成报告的模板(报告的负责程度全由您自己掌控)。

(1)统计各项数据

system_cnt = len(df_tmp['系统名称'].unique())alarm_cnt = int(df_tmp['告警次数'].sum())fault_cnt = int(df_tmp['故障次数'].sum())fault_handled_cunt = int(df_tmp['已处理故障次数'].sum())sys_names = df_tmp[cols[1]].unique()host_cnt = len(df_tmp['主机IP'].unique())

(2)按分析逻辑拼接报告模板

总体概述：

#初始化报告document = Document()#标题title = '核心系统运维监控简报'header = add_head_title(document,title)#总体概述sub_title1 = '一、总体概述'add_head_level_1(document,sub_title1)total_desc = '{0}，运维团队持续对{1}套核心系统进行运维监测，共涉及核心服务器{2}台，今日发生故障{3}次，系统告警共计{4}次'    .format(date_str,system_cnt,host_cnt,fault_cnt,alarm_cnt)if fault_cnt > 0:    if fault_cnt == fault_handled_cunt:        total_desc += '，所有故障均已完成处置。'    else:        total_desc += '，已完成{}项故障处置，剩{}项暂未处理，具体原因见后详情。'.format(fault_handled_cunt,(fault_cnt-fault_handled_cunt))else:    total_desc += '，所有系统均正常运行。'total_desc += '具体情况如下。'

故障方面分析：

# 故障方面    sys_fault_ct = sysdata[cols[8]].sum()    sys_fault_hd_ct = sysdata[cols[9]].sum()    sys_fault_descs = sysdata[['主机IP','故障详细描述','处置结果描述','拟采取措施','主机用途']]    sys_fault_list = sys_fault_descs[sys_fault_descs['故障详细描述']!='无'].values    if sys_fault_ct == 0:        add_paragraph(document,'故障方面，{}系统未发生故障，全天正常运行。'.format(v))    else:        para = add_paragraph(document, '故障方面，{0}系统今日共发生{1}次故障，已经完成处理{2}项。'.format(v,sys_fault_ct,sys_fault_hd_ct))        run = para.add_run('具体故障主要为:')        run.font.name = '仿宋'        run._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')        for j,faults in enumerate(sys_fault_list):            para1 = add_paragraph(document,'({0})主机[{2}]({1})'.format(j+1,faults[0],faults[4]))            run1 = para1.add_run('{0}。'.format(faults[1]))            run1.font.color.rgb = RGBColor(255, 0, 0)            run1.font.name = '仿宋'            run1._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')            if faults[2] != '无':                run1 = para1.add_run('目前{}。'.format(faults[2]))                run1.font.name = '仿宋'                run1._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')            if faults[3] != '无':                run1 = para1.add_run('{0}。'.format(faults[3]))                run1.font.name = '仿宋'                run1._element.rPr.rFonts.set(qn('w:eastAsia'), '仿宋')

其他内容可按需定制。

第三步：生成报告并保存

模板拼接好后，可将内容进行持久化保存(文件名用日期区分)。

#保存文件document.save('{0}-{1}.docx'.format(title,date_str))print('报告自动生成完成！')

经过上述三个步骤，我们的运维日简报就已经自动生成完成了。以下是效果图。

自动生成的运维简报

有了这样的工具，后续的工作就简单了，只需要修改数据统计表中的内容，然后运行一次程序，每天的报告就自动完成了。：)

结束语

今天的分享就到这里，感谢大家的阅读。由于篇幅原因，未能将所有代码贴出，需要完整源代码的朋友，可以通过评论给我留言，或私信联系我。同时，请大家在评论区给我一些反馈和指导，以帮助我提升文章内容质量，谢谢大家。