Is there some tool (preferably in Python) that allows you to generate reports in HTML, Markdown or reStructuredText from arbitrary source code (Python, R, Javascript, etc)?
The closest thing I have found so far is pyreport that only supports python. The idea is to be able to get a quick report from well-documented source code. This is different from literate programming; here I want something similar to the following:
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()
and the report should be something like this:
This is part of a comment
maybe some equations $c^2=a^2+b^2$ or links here
42
This is very similar to documentation generator tools but I need them to work across language, and most (if not all) are language-specific.
Can you maybe use one of the tools listed on the Python Wiki for Source Code documentation, which normally extracts the structure from your code, and includes your docblocks in the documentation.