2016-07-12 14:11:18 +02:00
|
|
|
#!/usr/bin/env python
|
2018-10-06 18:23:54 +02:00
|
|
|
|
2016-07-19 21:25:46 +02:00
|
|
|
# Build the gh-pages
|
2016-07-12 14:11:18 +02:00
|
|
|
|
|
|
|
import re
|
2016-07-19 21:25:46 +02:00
|
|
|
import sys
|
2016-08-06 10:40:35 +02:00
|
|
|
import json
|
2016-07-19 21:25:46 +02:00
|
|
|
|
2016-08-06 10:40:35 +02:00
|
|
|
from lintlib import parse_all, log
|
2016-07-12 14:11:18 +02:00
|
|
|
|
2016-07-15 13:08:04 +02:00
|
|
|
lint_subheadline = re.compile(r'''^\*\*([\w\s]+?)[:?.!]?\*\*(.*)''')
|
|
|
|
|
2016-08-06 10:40:35 +02:00
|
|
|
CONF_TEMPLATE = """\
|
2016-07-15 13:08:04 +02:00
|
|
|
This lint has the following configuration variables:
|
|
|
|
|
2016-08-06 10:40:35 +02:00
|
|
|
* `%s: %s`: %s (defaults to `%s`)."""
|
2016-07-15 13:08:04 +02:00
|
|
|
|
|
|
|
|
2016-08-06 10:40:35 +02:00
|
|
|
def parse_lint_def(lint):
|
|
|
|
lint_dict = {}
|
|
|
|
lint_dict['id'] = lint.name
|
2018-04-10 12:23:41 +02:00
|
|
|
lint_dict['group'] = lint.group
|
2016-08-06 10:40:35 +02:00
|
|
|
lint_dict['level'] = lint.level
|
|
|
|
lint_dict['docs'] = {}
|
2016-07-12 14:11:18 +02:00
|
|
|
|
|
|
|
last_section = None
|
|
|
|
|
2016-08-06 10:40:35 +02:00
|
|
|
for line in lint.doc:
|
2018-02-01 23:04:59 +01:00
|
|
|
if len(line.strip()) == 0 and not last_section.startswith("Example"):
|
2016-07-12 14:11:18 +02:00
|
|
|
continue
|
|
|
|
|
|
|
|
match = re.match(lint_subheadline, line)
|
|
|
|
if match:
|
|
|
|
last_section = match.groups()[0]
|
2016-07-14 21:00:20 +02:00
|
|
|
if match:
|
|
|
|
text = match.groups()[1]
|
|
|
|
else:
|
|
|
|
text = line
|
|
|
|
|
2016-07-12 14:11:18 +02:00
|
|
|
if not last_section:
|
2016-08-06 10:40:35 +02:00
|
|
|
log.warn("Skipping comment line as it was not preceded by a heading")
|
|
|
|
log.debug("in lint `%s`, line `%s`", lint.name, line)
|
|
|
|
|
2018-02-01 23:04:59 +01:00
|
|
|
fragment = lint_dict['docs'].get(last_section, "")
|
|
|
|
if text == "\n":
|
|
|
|
line = fragment + text
|
|
|
|
else:
|
|
|
|
line = (fragment + "\n" + text).strip()
|
|
|
|
|
|
|
|
lint_dict['docs'][last_section] = line
|
2016-08-06 10:40:35 +02:00
|
|
|
|
|
|
|
return lint_dict
|
2016-07-12 14:11:18 +02:00
|
|
|
|
2016-07-19 21:25:46 +02:00
|
|
|
|
2016-07-12 14:11:18 +02:00
|
|
|
def main():
|
2016-08-06 10:40:35 +02:00
|
|
|
lintlist, configs = parse_all()
|
|
|
|
lints = {}
|
|
|
|
for lint in lintlist:
|
|
|
|
lints[lint.name] = parse_lint_def(lint)
|
|
|
|
if lint.name in configs:
|
|
|
|
lints[lint.name]['docs']['Configuration'] = \
|
|
|
|
CONF_TEMPLATE % configs[lint.name]
|
|
|
|
|
|
|
|
outfile = sys.argv[1] if len(sys.argv) > 1 else "util/gh-pages/lints.json"
|
|
|
|
with open(outfile, "w") as fp:
|
|
|
|
json.dump(list(lints.values()), fp, indent=2)
|
|
|
|
log.info("wrote JSON for great justice")
|
2016-07-19 21:25:46 +02:00
|
|
|
|
2016-07-12 14:11:18 +02:00
|
|
|
|
|
|
|
if __name__ == "__main__":
|
2016-07-14 21:00:20 +02:00
|
|
|
main()
|