从文档中提取源代码以进行测试

时间:2011-11-11 05:32:20

标签: ruby documentation markdown

我为我编写的一些Ruby宝石编写了教程。它是在markdown(Kramdown)文本文档中。为了确保教程中源代码的完整性,随着gems的开发继续,我想从教程文档中提取源代码并运行测试以确保代码正确且有效。在重新发明轮子之前,我搜索了但没有发现这类问题。有没有可以帮助我解决问题的软件? Ruby软件很酷,但我并不特别关注这种语言。我确信我不能成为第一个遇到这个问题的人。

另一种选择是只在教程文档中有占位符,并在外部包含所有文件,然后在发布之前填充文档。这将意味着更多的松散文件,但实现起来会更加容易。

2 个答案:

答案 0 :(得分:0)

您是否正在使用Ruby DocTest之类的东西?

答案 1 :(得分:0)

emacs中的

Org mode可以做到这一点,但这意味着你无法写入Markdown。