3d4b1710eb
`python` as a command isn't universally available anymore after the python2/python3 drama. Change-Id: I9d68873d86dc3f044238d921c10fc434a83a76f5 Signed-off-by: Patrick Georgi <patrick@coreboot.org> Reviewed-on: https://review.coreboot.org/c/coreboot/+/69190 Tested-by: build bot (Jenkins) <no-reply@coreboot.org> Reviewed-by: Angel Pons <th3fanbus@gmail.com>
108 lines
3.3 KiB
Python
Executable File
108 lines
3.3 KiB
Python
Executable File
#!/usr/bin/env python3
|
|
#
|
|
# kconfig2wiki - Kconfig to MediaWiki converter for
|
|
# https://www.coreboot.org/coreboot_Options
|
|
# based on http://landley.net/kdocs/make/menuconfig2html.py
|
|
#
|
|
# SPDX-License-Identifier: GPL-2.0-only
|
|
|
|
import glob
|
|
|
|
helplen = 0
|
|
extra_chapters = 0
|
|
|
|
##
|
|
## Remove quotes from Kconfig string options
|
|
##
|
|
def zapquotes(str):
|
|
if str[0]=='"': str = str[1:str.rfind('"')]
|
|
return str
|
|
|
|
##
|
|
## Escape HTML special characters
|
|
##
|
|
def htmlescape(str):
|
|
return str.strip().replace("&","&").replace("<","<").replace(">",">")
|
|
|
|
##
|
|
## Process Kconfig file
|
|
##
|
|
def readfile(filename):
|
|
import sys
|
|
global helplen
|
|
|
|
source=filename.replace("src/","").replace("/Kconfig","").replace("Kconfig","toplevel")
|
|
|
|
try:
|
|
lines = open(filename).read().split("\n")
|
|
except IOError:
|
|
sys.stderr.write("File %s missing\n" % filename)
|
|
return
|
|
config = None
|
|
description = None
|
|
configtype = None
|
|
for i in lines:
|
|
if helplen:
|
|
i = i.expandtabs()
|
|
if not len(i) or i[:helplen].isspace():
|
|
sys.stdout.write("%s<br />\n" % htmlescape(i))
|
|
continue
|
|
else:
|
|
helplen = 0
|
|
sys.stdout.write("</td></tr>\n")
|
|
|
|
words = i.strip().split(None,1)
|
|
if not len(words): continue
|
|
|
|
if words[0] in ("config", "menuconfig"):
|
|
config = words[1]
|
|
description = ""
|
|
elif words[0] in ("bool", "boolean", "tristate", "string", "hex", "int"):
|
|
configtype = htmlescape(zapquotes(words[0]))
|
|
if len(words)>1: description = htmlescape(zapquotes(words[1]))
|
|
elif words[0]=="prompt":
|
|
description = htmlescape(zapquotes(words[1]))
|
|
elif words[0] in ("help", "---help---"):
|
|
sys.stdout.write("<tr bgcolor=\"#eeeeee\">\n")
|
|
sys.stdout.write("<td>%s</td><td>%s</td><td>%s</td><td>%s</td><td>\n" % (config,source,configtype,description) )
|
|
helplen = len(i[:i.find(words[0])].expandtabs())
|
|
elif words[0] == "comment":
|
|
sys.stdout.write("<tr bgcolor=\"#eeeeee\">\n")
|
|
sys.stdout.write("<td></td><td>%s</td><td>(comment)</td><td></td><td>%s</td></tr>\n" % (source, htmlescape(zapquotes(words[1]))))
|
|
elif words[0]=="menu":
|
|
if len(words)>1:
|
|
temp = htmlescape(zapquotes(words[1]))
|
|
sys.stdout.write("<tr bgcolor=\"#6699dd\">\n")
|
|
sys.stdout.write("<td colspan=5>Menu: %s</td></tr>\n" % temp)
|
|
elif words[0] == "endmenu":
|
|
sys.stdout.write("\n")
|
|
elif words[0] == "source":
|
|
fn=zapquotes(words[1])
|
|
for name in glob.glob(fn):
|
|
readfile(name)
|
|
elif words[0] in ("default","depends", "select", "if", "endif", "#"): pass
|
|
#else: sys.stderr.write("unknown: %s\n" % i)
|
|
if helplen: sys.stdout.write("</td></tr>\n")
|
|
|
|
def main():
|
|
import sys, time
|
|
|
|
if len(sys.argv)!=3:
|
|
sys.stderr.write("Usage: kconfig2wiki kconfigfile version\n")
|
|
sys.exit(1)
|
|
|
|
sys.stdout.write("This is an automatically generated list of '''coreboot compile-time options'''.\n")
|
|
sys.stdout.write("\nLast update: %s\n" % sys.argv[2])
|
|
sys.stdout.write("<table border=\"0\" style=\"font-size: smaller\">\n");
|
|
sys.stdout.write("<tr bgcolor=\"#6699dd\">\n")
|
|
sys.stdout.write("<td align=\"left\">Option</td>\n")
|
|
sys.stdout.write("<td align=\"left\">Source</td>\n")
|
|
sys.stdout.write("<td align=\"left\">Format</td>\n")
|
|
sys.stdout.write("<td align=\"left\">Short Description</td>\n")
|
|
sys.stdout.write("<td align=\"left\">Description</td></tr>\n")
|
|
readfile(sys.argv[1])
|
|
sys.stdout.write("</table>\n")
|
|
|
|
if __name__ == "__main__":
|
|
main()
|