getMessages.py

#!/usr/bin/env python3

import os
import re

command = "python ../etc/find_messages.py -d ../tools/AutoTuner/src"
output = os.popen(command).read()

with open("user/MessagesFinal.md", "w") as f:
    f.write("# OpenROAD Messages Glossary\n")
    f.write(
        "Listed below are the OpenROAD warning/errors you may encounter while using the application.\n"
    )
    f.write("\n")
    f.write("| Tool | Code | Filename:Line Number | Type | Information             |\n")
    f.write("| ---- | ---- | -------------------- | ---- | ----------------------- |\n")

    lines = output.split("\n")
    for line in lines:
        columns = line.split()
        if not columns:
            continue
        ant = columns[0]
        num = columns[1]
        fileLineNum = f"[{columns[2]}]({columns[-1]})"
        msgType = columns[-2]
        tool = columns[0].lower()
        try:
            # aim is to match all level1 header and their corresponding text.
            message = open(f"./messages/{tool}/{num}.md").read()
            pattern = re.compile(
                r"#\s*(?P<header1>[^\n]+)\n*(?P<body_text>.*?)(?=\n#|$)", re.DOTALL
            )
            matches = pattern.finditer(message)
            m = []
            for match in matches:
                header1 = match.group("header1")
                body_text = match.group("body_text").strip()
                m.append(f"{header1}-{body_text}")
            message = " ".join(x for x in m)
            print(message)

        except OSError as e:
            message = "-"
        if not message:
            message = "-"
        f.write(f"| {ant} | {num} | {fileLineNum} | {msgType} |{message} |\n")