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。抽时间再想吧,要睡觉了~