Debian Codegraph @

Tools/cases_generator/py_metadata_generator.py

raw
1 """Generate opcode metadata for Python.
2 Reads the instruction definitions from bytecodes.c.
3 Writes the metadata to _opcode_metadata.py by default.
4 """
5
6 import argparse
7
8 from analyzer import (
9 Analysis,
10 analyze_files,
11 )
12 from generators_common import (
13 DEFAULT_INPUT,
14 ROOT,
15 write_header,
16 )
17 from cwriter import CWriter
18 from typing import TextIO
19
20
21 DEFAULT_OUTPUT = ROOT / "Lib/_opcode_metadata.py"
22
23
24 def get_specialized(analysis: Analysis) -> set[str]:
25 specialized: set[str] = set()
26 for family in analysis.families.values():
27 for member in family.members:
28 specialized.add(member.name)
29 return specialized
30
31
32 def generate_specializations(analysis: Analysis, out: CWriter) -> None:
33 out.emit("_specializations = {\n")
34 for family in analysis.families.values():
35 out.emit(f'"{family.name}": [\n')
36 for member in family.members:
37 out.emit(f' "{member.name}",\n')
38 out.emit("],\n")
39 out.emit("}\n\n")
40
41
42 def generate_specialized_opmap(analysis: Analysis, out: CWriter) -> None:
43 out.emit("_specialized_opmap = {\n")
44 names = []
45 for family in analysis.families.values():
46 for member in family.members:
47 if member.name == family.name:
48 continue
49 names.append(member.name)
50 for name in sorted(names):
51 out.emit(f"'{name}': {analysis.opmap[name]},\n")
52 out.emit("}\n\n")
53
54
55 def generate_opmap(analysis: Analysis, out: CWriter) -> None:
56 specialized = get_specialized(analysis)
57 out.emit("opmap = {\n")
58 for inst, op in analysis.opmap.items():
59 if inst not in specialized:
60 out.emit(f"'{inst}': {analysis.opmap[inst]},\n")
61 out.emit("}\n\n")
62
63
64 def generate_py_metadata(
65 filenames: list[str], analysis: Analysis, outfile: TextIO
66 ) -> None:
67 write_header(__file__, filenames, outfile, "#")
68 out = CWriter(outfile, 0, False)
69 generate_specializations(analysis, out)
70 generate_specialized_opmap(analysis, out)
71 generate_opmap(analysis, out)
72 out.emit(f"HAVE_ARGUMENT = {analysis.have_arg}\n")
73 out.emit(f"MIN_INSTRUMENTED_OPCODE = {analysis.min_instrumented}\n")
74
75
76 arg_parser = argparse.ArgumentParser(
77 description="Generate the Python file with opcode metadata.",
78 formatter_class=argparse.ArgumentDefaultsHelpFormatter,
79 )
80
81 arg_parser.add_argument(
82 "-o", "--output", type=str, help="Generated code", default=DEFAULT_OUTPUT
83 )
84
85 arg_parser.add_argument(
86 "input", nargs=argparse.REMAINDER, help="Instruction definition file(s)"
87 )
88
89 if __name__ == "__main__":
90 args = arg_parser.parse_args()
91 if len(args.input) == 0:
92 args.input.append(DEFAULT_INPUT)
93 data = analyze_files(args.input)
94 with open(args.output, "w") as outfile:
95 generate_py_metadata(args.input, data, outfile)