工作中有需要创建一个 HTML 报告，比如测试用例运行报告等。如何优雅地，简洁地创建 HTML 文档，经过一番调研，发现 Python 中的 Dominate 最佳。本文通过介绍 Donimate 的用法，最后再结合一个具体的 html 测试报告实例。

内容提要：

Dominate 是一个 Python 库，利用优雅的 DOM API 来创建和操作 HTML 文档。使用 Dominate 可以用简洁的纯 Pyhon 语句编写 HTML 页面。这消除了学习模板语言的需要，还可以充分利用 Python 的强大功能。

首先需要安装 Dominate 库，然后再导入对应的模块： pip install dominate from dominate.tags import * import dominate

doc = dominate.document()

默认render() 将 html 内容按人类可读的形式输出，每个 html 元素一行，按2个空格的缩进。 生成的文档是这样的

如果 f.write(doc.render(pretty=False))，则输出：

最简单的 html 文档 doc = html() 就只生成 html tag

Dominate 最基本的特征就是 HTML 每个元素都是一个类，它的构造函数就是接受它的子元素，text 或 一些属性。注意这种形式通常是最后一层元素接受一些属性定义，其父类只能接收子元素。

输出

Dominate 可以用关键字参数来添加 tag 的属性。大多数属性是直接从 HTML spec 拷贝过来，当然也有少数不一样。

输出：

当然也可以通过下面的方式去更改属性

输出：

输出：

表格单元格的合并，可以通过属性 colspan 来实现

来实现一下面的 table 效果： 代码：

生成的 HTML 标签：

通过使用 += 操作和 .add() 方法，可以很容易地创建更复杂的结构。

输出：

输出：

输出：

可以用 Python 的 with 语句来添加子元素。

输出：

输出：

输出：

需要导入 dominate.util.text 函数:

输出：

可以用这种模式创建反复利用的小工具：

例如：

输出：

用 tag 作为装饰器，也可以取到相同的效果

再来看一下例子：

输出：

为了生成更漂亮的 html，我们会定义 html tag 的样式即 CSS，Dominate 怎样应用样式呢，很简单，跟生成 html 其它 tag 一样，只是样式就要应用到 style 添加到 head 部分。

如下，我们定义 html tag p 和 div 的样式（字体，颜色等等）。

生成 html 效果：

结合上面的知识点，我们来创建一个测试报告，数据是 mock 的，有关直方图的生成，请参考 Python 绘制直方图 效果如下： 完整代码：