Automating Word Report Comments with Python‑docx

Many repetitive tasks in daily life can be solved with code; this example shows how to automate the insertion of evaluation comments into Word lab reports for over a hundred students using Python.

First, install the python-docx library:

pip install python-docx

Import the Document class to open Word files:

from docx import Document

Read the scores from a CSV file (the readScore function) and store them as a list of records.

def readScore(name): import csv vec = [] data = [] with open(name, 'rb') as f: reader = csv.reader(f) flag = 1 for row in reader: if flag: flag = 0 continue for i in row: vec.append(i.decode("utf8")) data.append(vec) vec = [] return data

Collect the file names of all Word reports (the getFileName function) by walking through the target folder:

def getFileName(folderName): for root, dirs, files in os.walk(folderName): files = files names = [] for file in files: if "docx" in file: names.append(folderName + '/' + file) print "读取文件名字成功" print names return names

Generate a comment based on the numeric score (the getComment function) with four predefined remarks:

def getComment(score): score = int(score) comment = ['功能实验完整，报告相对清晰。', '实现功能，报告略简洁。', '缺乏部分功能、不完全符合要求。', '实验不完整，报告敷衍。'] if score >= 85: index = 0 elif score >= 75: index = 1 elif score >= 65: index = 2 else: index = 3 strC = "成绩：" + str(score) + '\n' + "评语：" + comment[index] + "\n" + "评定人：代号22\n" + "时间：2019/12/9\n" return strC

Finally, insert the generated comment into the first paragraph of each corresponding Word report (the setComment function) and save the modified document:

def setComment(score, filename): for name in filename: for i in range(len(score)): if score[i][0] in name: file = Document(name) str = getComment(score[i][2]).decode("utf8") file.paragraphs[0].insert_paragraph_before(str) file.save(name) break

Readers are encouraged to explore python-docx as a powerful tool for programmatically handling Word documents.