mirror of https://github.com/ARMmbed/mbed-os.git
37 lines
1.3 KiB
Python
37 lines
1.3 KiB
Python
"""An api for generating documentation from the codebase
|
|
"""
|
|
|
|
from os.path import dirname, join
|
|
|
|
import subprocess
|
|
|
|
def generate_documentation(dirs, output_dir):
|
|
"""Use doxygen to generate the documentation
|
|
|
|
Positional arguments:
|
|
dirs - the directories that doxygen should scan for documentation
|
|
output_dir - location of the documentation after the return of this function
|
|
"""
|
|
with open(join(dirname(__file__), "Doxyfile")) as doxyfile:
|
|
proc = subprocess.Popen(["doxygen", "-"], stdin=subprocess.PIPE)
|
|
proc.stdin.write(doxyfile.read())
|
|
proc.stdin.write("OUTPUT_DIRECTORY={}\n".format(output_dir))
|
|
proc.stdin.write("INPUT={}".format(" ".join(dirs)))
|
|
proc.stdin.close()
|
|
proc.wait()
|
|
|
|
if __name__ == "__main__":
|
|
import sys
|
|
from os.path import abspath, dirname, join
|
|
# Be sure that the tools directory is in the search path
|
|
ROOT = abspath(join(dirname(__file__), ".."))
|
|
sys.path.insert(0, ROOT)
|
|
|
|
from tools.toolchains.gcc import GCC_ARM
|
|
from tools.targets import TARGET_MAP
|
|
toolchain = GCC_ARM(TARGET_MAP["Super_Target"])
|
|
resources = toolchain.scan_resources(".")
|
|
generate_documentation(sum(map(lambda x:x.headers, resources.features.values()), resources.headers),
|
|
join(dirname(dirname(__file__)), "mbed-docs"))
|
|
print resources
|