如何记录现有的 Selenium Webdriver 测试？答案

【问题标题】：How to document existing Selenium Webdriver tests?如何记录现有的 Selenium Webdriver 测试？
【发布时间】：2018-02-02 18:26:49
【问题描述】：

我负责使用 Selenium Webdriver 和 Python 测试 Web 应用程序。在过去的一年中，我创建了一个大型脚本（20K+ 行），其中每个测试都是一个单独的函数。现在我的老板要我记录我的测试，用计划英语解释每个测试的作用。你会推荐什么工具来记录你的测试步骤？

【问题讨论】：

我不知道你的文档应该是什么样子，但你可以试试Sphinx - 文档生成的酷工具
要求我们推荐或查找书籍、工具、软件库、教程或其他场外资源的问题对于 Stack Overflow 来说是无关紧要的，因为它们往往会吸引固执己见的答案和垃圾邮件。取而代之的是describe the problem 以及迄今为止为解决它所做的工作。
有关通用计算硬件和软件的问题对于 Stack Overflow 来说是题外话，除非它们直接涉及主要用于编程的工具。您可以通过 Super User 获得帮助。

【解决方案1】：

我认为这是一个很好的问题。许多人和公司都懒得妥善管理他们现有的测试，这会导致代码冗余和重复，却不清楚自动化测试所涵盖的内容。

这个问题没有单一的答案，但通常您可以考虑以下选项：

报告中内置的测试框架。例如，在 Java 中，您拥有像 jUnit 和 TestNG 这样的单元测试库。当它们运行时，它们会生成某些输出，以后可以根据需要对其进行格式化和审查。我确信在 Python 中也有这样的单元测试框架的实现。
您也可以考虑使用像 Cucumber 这样的 BDD 工具。这有点不同，并且在测试是低级别系统检查的某些情况下可能不适合。然而，它可以帮助您组织您的测试场景并保持它们的可读形式。也非常适合向非技术人员报告。

【讨论】：