敏捷文档框架（NTestDox？）答案

【问题标题】：Agile Documentation Frameworks (NTestDox?)敏捷文档框架（NTestDox？）
【发布时间】：2010-09-02 21:14:27
【问题描述】：

我正在阅读这篇博文：http://www.shakie.co.uk/ramblings/feature-driven-development-riding-the-waves-of-change/，偶然发现了有关 TestDox 的部分：

直接引用（因此是 PHP）：

以下面的测试用例为例子

class InvoiceTest extends PHPUnit_Framework_TestCase
{
    public function testValueIsInitiallyZero() {
        $invoice = new Invoice();
        $this->assertEquals(0.00, $invoice->getValue());
    }

    public function testWillCloseAutomaticallyIfWholeValueIsPaid() {
        $invoice = Invoice::getInvoiceById(1);
        $invoice->payAmount(100.00);
        $this->assertEquals(true, $invoice->isClosed());
    }
}

在 TestDox 格式中，这将翻译成：

发票

[x] 初始值为零

[x] 如果全额支付，将自动关闭

这对于我正在从事的一些更敏捷的项目非常有用。我一直在研究 TestDox 并试图追踪 NTestDox，因为我是一个 .NET 人。

三个问题在这里合二为一：

有人找到 NTestDox 的副本吗？（我看到 google 中唯一有用的结果中不存在页面）

从您的单元测试生成文档是一个好的计划吗？

有人知道.NET 的任何其他框架吗？

【问题讨论】：

标签： .net unit-testing agile

【解决方案1】：

很遗憾，对于 NTestDox，我无法为您提供帮助，但我还是想回答您的最后两个问题。

从您的单元测试生成文档是一个好的计划吗？

我不知道记录现有的单元测试是否会对您有任何好处。然而，如果您打算开发测试驱动，那么将人类可读的规范作为测试框架的一部分是有价值的。看看BDD 和ATDD。

这就引出了你的第二个问题：

有人知道.NET 的任何其他框架吗？

如果您寻找 BDD 的好处而不是从测试中生成文档，您可以查看 Cucumber。它应该可以与 .NET 一起使用（请参阅文档 here）。

【讨论】：

【解决方案2】：

我也找不到任何可用的 NTestDox 痕迹。

但我确实找到了 2010 年初的 nAgileDox 和 TestDox for .NET。

虽然 Chris Stevenson 在 sourceforge 的 AgileDox project 页面只提到了他从 2003 年开始为 JUnit 编写的 TestDox Java 程序，但该项目的 CVS repository 还包含带有控制台版本和 GUI 版本的 nAgileDox C# 程序。它的最后一次更新是从 2007 年开始。源代码和可执行文件可在来自this directory 的文件 nAgileSource.zip 和 nAgileComplete.zip 中获得。

nAgileDox 和 TestDox for .NET 都通过读取 .net 程序集来工作。

另见this related question。

【讨论】：