从源代码生成 HTML 份报告
Generate HTML reports from source code
是否有一些工具(最好在 Python 中)允许您从任意源代码(Python、R、[=30]、Markdown 或 reStructuredText 中生成报告=], 等等)?
到目前为止我发现的最接近的是pyreport,它只支持python。这个想法是为了能够从文档齐全的源代码中获得快速报告。这与文字编程不同;在这里,我想要类似于以下内容的内容:
file.py
# ```*This is part of a comment*
# maybe some equations $c^2=a^2+b^2$ or [links](http://mylink.com) here ```
def calculate_something():
print(42)
calculate_something()
报告应该是这样的:
This is part of a comment
maybe some equations $c^2=a^2+b^2$ or links here
42
这与文档生成器工具非常相似,但我需要它们跨语言工作,而且大多数(如果不是全部)都是特定于语言的。
您能否使用 Python Wiki 上列出的工具之一来获取源代码文档,它通常会从您的代码中提取结构,并在文档中包含您的文档块。
是否有一些工具(最好在 Python 中)允许您从任意源代码(Python、R、[=30]、Markdown 或 reStructuredText 中生成报告=], 等等)?
到目前为止我发现的最接近的是pyreport,它只支持python。这个想法是为了能够从文档齐全的源代码中获得快速报告。这与文字编程不同;在这里,我想要类似于以下内容的内容:
file.py
# ```*This is part of a comment*
# maybe some equations $c^2=a^2+b^2$ or [links](http://mylink.com) here ```
def calculate_something():
print(42)
calculate_something()
报告应该是这样的:
This is part of a comment
maybe some equations $c^2=a^2+b^2$ or links here
42
这与文档生成器工具非常相似,但我需要它们跨语言工作,而且大多数(如果不是全部)都是特定于语言的。
您能否使用 Python Wiki 上列出的工具之一来获取源代码文档,它通常会从您的代码中提取结构,并在文档中包含您的文档块。