Debian Codegraph @

libdrgn/build-aux/codegen_utils.py

raw
1 # Copyright (c) Meta Platforms, Inc. and affiliates.
2 # SPDX-License-Identifier: LGPL-2.1-or-later
3
4 import ast
5 from typing import Optional
6
7
8 class CodeGenError(Exception):
9 def __init__(
10 self,
11 message: str,
12 filename: str,
13 lineno: Optional[int] = None,
14 columnno: Optional[int] = None,
15 ) -> None:
16 self.message = message
17 self.filename = filename
18 self.lineno = lineno
19 self.columnno = columnno
20
21 def __str__(self) -> str:
22 parts = [self.filename]
23 if self.lineno is not None:
24 parts.append(str(self.lineno))
25 if self.columnno is not None:
26 parts.append(str(self.columnno))
27 return f"{':'.join(parts)}: error: {self.message}"
28
29
30 _C_ESCAPE_CHAR = []
31 for c in range(256):
32 if c == 0:
33 e = r"\0"
34 elif c == 7:
35 e = r"\a"
36 elif c == 8:
37 e = r"\b"
38 elif c == 9:
39 e = r"\t"
40 elif c == 10:
41 e = r"\n"
42 elif c == 11:
43 e = r"\v"
44 elif c == 12:
45 e = r"\f"
46 elif c == 13:
47 e = r"\r"
48 elif c == 34:
49 e = r"\""
50 elif c == 39:
51 e = r"\'"
52 elif c == 92:
53 e = r"\\"
54 elif 32 <= c <= 126:
55 e = chr(c)
56 else:
57 e = f"\\x{c:02x}"
58 _C_ESCAPE_CHAR.append(e)
59
60
61 def c_char_ord_literal(o: int) -> str:
62 """Return a C character literal for a Unicode code point."""
63 if o == 34: # ord('"')
64 return "'\"'"
65 elif o <= 0xFF:
66 return "'" + _C_ESCAPE_CHAR[o] + "'"
67 elif o <= 0xFFFF:
68 return f"'\\u{o:04x}'"
69 else:
70 return f"'\\u{o:08x}'"
71
72
73 def c_bytes_literal(s: bytes) -> str:
74 """Return a C string literal for a byte string."""
75 result = ['"']
76 for c in s:
77 if c == 39: # ord("'")
78 result.append("'")
79 else:
80 result.append(_C_ESCAPE_CHAR[c])
81 result.append('"')
82 return "".join(result)
83
84
85 def c_string_literal(s: str) -> str:
86 """Return a C string literal for a string."""
87 result = ['"']
88 for c in s:
89 o = ord(c)
90 if o == 39: # ord("'")
91 result.append("'")
92 elif o <= 0xFF:
93 result.append(_C_ESCAPE_CHAR[o])
94 elif o <= 0xFFFF:
95 result.append(f"\\u{o:04x}")
96 else:
97 result.append(f"\\u{o:08x}")
98 result.append('"')
99 return "".join(result)
100
101
102 def parse_c_string_literal(s: str) -> str:
103 # Python string literals are close enough to C string literals for now.
104 return ast.literal_eval(s) # type: ignore[no-any-return]