NDoc for NUnit (初步构想)

刚刚译了 NDoc,又一次深入学习了 Reflection 反射发出、XSLT 转换,还学习了很多关于 HTML Help 1、Microsoft Help 2 等帮助文件的制作细节。

手中的项目客户点名要求使用 NDoc (日语版)NUnit。前者当然是为了最终有一个漂亮的类库文档。后者则是 TDD 开发的标志物。

我想,日本人对文档的重视程度是国内开发人员所难以想象的。以往的项目,并不采用 TDD 开发,所谓单元测试(Unit Test),最主要也最耗时的工作就是在那里拼凑“测试文档”,用大量的文字、表格、屏幕截图等等,证明 coding 没问题、输出是正确的;而并非真正的按照单元测试的要求、分 class/function 执行测试。

而按照典型的 TDD 开发,如果再如此这般的折腾“测试文档”,那可就完蛋了,因为 TDD 是测试先行,反复的执行“回归测试”……但测试总得有文档,否则怎么证明你测试了?如果每次回归都要文档,那就有些惨了。另外客户也要求单元测试的文档包含在最终交付物中。

也是因为刚译完 NDoc 的缘故,所以第一个念头就是:是否有一款能够配合 NUnit 自动生成“测试文档”的小工具?

NDoc 现有的体系是:从程序集(*.dll/exe)及其相应的 XML 文档文件(*.xml) 开始,最终输出代码文档。
而 NUnit 也可以将测试结果以 XML 文件保存下来。

如果混合一下,从程序集(*.dll/exe)及其相应的 XML 文档文件(*.xml),再加上 NUnit 的测试结果 XML 文件,最终输出“测试文档”?

哎,一个新的工具就是这么“诞生”(?)了。可以使用和参考大量 NDoc 的现有代码。不过 NDoc 现在是 GPL 协议授权,也就是这个衍生物也必须是 GPL 的了。这点有些不爽,说实话,我喜欢 BSD,不太喜欢 GPL。抽时间再想吧,要睡觉了~

posted on 2005-10-09 23:46  破宝  阅读(177)  评论(0编辑  收藏  举报

导航