snapshot before regression test
This commit is contained in:
t
761
lib/core/stub_generator.py
Normal file
761
lib/core/stub_generator.py
Normal file
@@ -0,0 +1,761 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
C/H 文件到 Python 存根文件生成器
|
||||
|
||||
将 C 头文件 (.h) 或 C 源文件 (.c) 转换为 Python 存根文件 (.pyi)
|
||||
生成的 Python 代码使用 TransPyC 语法，包含类型注解
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
import os
|
||||
import re
|
||||
import sys
|
||||
from typing import Any
|
||||
from lib.core.VLogger import get_logger as _vlog
|
||||
|
||||
|
||||
class CTypeMapper:
|
||||
|
||||
# 硬编码 C 类型名 → Python 类型映射表
|
||||
# 这是 stub 生成器（C 头文件 → Python stub）专用的固定映射，
|
||||
# 不再依赖运行时 CTypeRegistry._cname_to_class（该映射已删除）。
|
||||
_CNAME_TO_PY: dict[str, str] = {
|
||||
# 基本类型
|
||||
'char': 't.CChar', 'int': 't.CInt', 'short': 't.CShort',
|
||||
'long': 't.CLong', 'long long': 't.CLongLong',
|
||||
'float': 't.CFloat', 'double': 't.CDouble', 'void': 't.CVoid',
|
||||
# unsigned / signed 变体
|
||||
'unsigned': 't.CUnsigned', 'unsigned char': 't.CUnsignedChar',
|
||||
'unsigned int': 't.CUnsignedInt', 'unsigned short': 't.CUnsignedShort',
|
||||
'unsigned long': 't.CUnsignedLong',
|
||||
'unsigned long long': 't.CUnsignedLongLong',
|
||||
'signed char': 't.CSignedChar',
|
||||
# bool / size_t
|
||||
'bool': 't.CBool', '_Bool': 't.CBool', 'size_t': 't.CSizeT',
|
||||
'ssize_t': 't.CLong',
|
||||
# stdint 固定宽度类型
|
||||
'int8_t': 't.CInt8T', 'int16_t': 't.CInt16T',
|
||||
'int32_t': 't.CInt32T', 'int64_t': 't.CInt64T',
|
||||
'uint8_t': 't.CUInt8T', 'uint16_t': 't.CUInt16T',
|
||||
'uint32_t': 't.CUInt32T', 'uint64_t': 't.CUInt64T',
|
||||
'intptr_t': 't.CIntPtrT', 'uintptr_t': 't.CUIntPtrT',
|
||||
'ptrdiff_t': 't.CPtrDiffT',
|
||||
# 宽字符 / 字符类型
|
||||
'wchar_t': 't.CWCharT', 'char8_t': 't.CChar8T',
|
||||
'char16_t': 't.CChar16T', 'char32_t': 't.CChar32T',
|
||||
# 浮点特化类型
|
||||
'float8_t': 't.CFloat8T', 'float16_t': 't.CFloat16T',
|
||||
'float32_t': 't.CFloat32T', 'float64_t': 't.CFloat64T',
|
||||
'float128_t': 't.CFloat128T',
|
||||
# signed 速记
|
||||
'signed': 't.CInt', 'signed int': 't.CInt',
|
||||
'signed short': 't.CShort', 'signed long': 't.CLong',
|
||||
}
|
||||
|
||||
@classmethod
|
||||
def _ResolveCNameToPyType(cls, c_type: str) -> str:
|
||||
"""将 C 类型名解析为 Python 类型字符串（如 'int' → 't.CInt'）
|
||||
|
||||
使用硬编码映射表，不再依赖 CTypeRegistry._cname_to_class。
|
||||
未识别的类型原样返回（用于 struct/union/enum/typedef 用户自定义名）。
|
||||
"""
|
||||
py: str | None = cls._CNAME_TO_PY.get(c_type)
|
||||
if py is not None:
|
||||
return py
|
||||
return c_type
|
||||
|
||||
@classmethod
|
||||
def MapType(cls, c_type: str, IsPtr: bool = False, IsArray: bool = False) -> str:
|
||||
c_type = c_type.strip()
|
||||
|
||||
IsConst: bool = 'const ' in c_type
|
||||
c_type = c_type.replace('const ', '').replace('const', '').strip()
|
||||
IsVolatile: bool = 'volatile ' in c_type
|
||||
c_type = c_type.replace('volatile ', '').replace('volatile', '').strip()
|
||||
IsStatic: bool = 'static ' in c_type
|
||||
c_type = c_type.replace('static ', '').replace('static', '').strip()
|
||||
IsExtern: bool = 'extern ' in c_type
|
||||
c_type = c_type.replace('extern ', '').replace('extern', '').strip()
|
||||
IsRegister: bool = 'register ' in c_type
|
||||
c_type = c_type.replace('register ', '').replace('register', '').strip()
|
||||
IsInline: bool = 'inline ' in c_type
|
||||
c_type = c_type.replace('inline ', '').replace('inline', '').strip()
|
||||
|
||||
PtrSuffix: str = ''
|
||||
if IsPtr or c_type.endswith('*'):
|
||||
PtrSuffix = ' | t.CPtr'
|
||||
c_type = c_type.rstrip('*').strip()
|
||||
|
||||
if c_type.startswith('struct '):
|
||||
c_type = c_type[7:].strip()
|
||||
elif c_type.startswith('union '):
|
||||
c_type = c_type[6:].strip()
|
||||
elif c_type.startswith('enum '):
|
||||
c_type = c_type[5:].strip()
|
||||
|
||||
PyType: str = cls._ResolveCNameToPyType(c_type)
|
||||
|
||||
result: str = PyType + PtrSuffix
|
||||
|
||||
if IsArray:
|
||||
result += ' | t.CArrayPtr'
|
||||
|
||||
return result
|
||||
|
||||
|
||||
def _find_matching_brace(text: str, start: int) -> int:
|
||||
depth: int = 0
|
||||
i: int = start
|
||||
while i < len(text):
|
||||
if text[i] == '{':
|
||||
depth += 1
|
||||
elif text[i] == '}':
|
||||
depth -= 1
|
||||
if depth == 0:
|
||||
return i
|
||||
elif text[i] == '"' or text[i] == "'":
|
||||
quote: str = text[i]
|
||||
i += 1
|
||||
while i < len(text) and text[i] != quote:
|
||||
if text[i] == '\\':
|
||||
i += 1
|
||||
i += 1
|
||||
elif text[i] == '/' and i + 1 < len(text) and text[i + 1] == '/':
|
||||
while i < len(text) and text[i] != '\n':
|
||||
i += 1
|
||||
continue
|
||||
elif text[i] == '/' and i + 1 < len(text) and text[i + 1] == '*':
|
||||
i += 2
|
||||
while i + 1 < len(text) and not (text[i] == '*' and text[i + 1] == '/'):
|
||||
i += 1
|
||||
i += 1
|
||||
i += 1
|
||||
return -1
|
||||
|
||||
|
||||
def _strip_comments(content: str) -> str:
|
||||
result: list[str] = []
|
||||
i: int = 0
|
||||
while i < len(content):
|
||||
if content[i] == '/' and i + 1 < len(content) and content[i + 1] == '/':
|
||||
while i < len(content) and content[i] != '\n':
|
||||
i += 1
|
||||
elif content[i] == '/' and i + 1 < len(content) and content[i + 1] == '*':
|
||||
i += 2
|
||||
while i + 1 < len(content) and not (content[i] == '*' and content[i + 1] == '/'):
|
||||
i += 1
|
||||
i += 2
|
||||
elif content[i] == '"' or content[i] == "'":
|
||||
quote: str = content[i]
|
||||
result.append(content[i])
|
||||
i += 1
|
||||
while i < len(content) and content[i] != quote:
|
||||
if content[i] == '\\' and i + 1 < len(content):
|
||||
result.append(content[i])
|
||||
i += 1
|
||||
result.append(content[i])
|
||||
i += 1
|
||||
if i < len(content):
|
||||
result.append(content[i])
|
||||
i += 1
|
||||
else:
|
||||
result.append(content[i])
|
||||
i += 1
|
||||
return ''.join(result)
|
||||
|
||||
|
||||
def _strip_preprocessor_guards(content: str) -> str:
|
||||
lines: list[str] = content.split('\n')
|
||||
filtered: list[str] = []
|
||||
for line in lines:
|
||||
stripped: str = line.strip()
|
||||
if stripped.startswith('#ifndef') and '_H' in stripped.upper():
|
||||
continue
|
||||
if stripped.startswith('#define') and '_H' in stripped.upper():
|
||||
continue
|
||||
if stripped == '#endif':
|
||||
continue
|
||||
filtered.append(line)
|
||||
return '\n'.join(filtered)
|
||||
|
||||
|
||||
class CHeaderParser:
|
||||
"""C 头文件解析器"""
|
||||
|
||||
def __init__(self) -> None:
|
||||
self.defines: list[dict[str, str | None]] = []
|
||||
self.structs: dict[str, dict[str, Any]] = {}
|
||||
self.enums: dict[str, dict[str, Any]] = {}
|
||||
self.typedefs: list[dict[str, str]] = []
|
||||
self.functions: dict[str, dict[str, Any]] = {}
|
||||
self.variables: dict[str, dict[str, Any]] = {}
|
||||
self.unions: dict[str, dict[str, Any]] = {}
|
||||
self.func_ptr_typedefs: dict[str, dict[str, Any]] = {}
|
||||
self._typedef_struct_map: dict[str, str] = {}
|
||||
self._typedef_enum_map: dict[str, str] = {}
|
||||
self._typedef_union_map: dict[str, str] = {}
|
||||
|
||||
def ParseFile(self, FilePath: str) -> None:
|
||||
with open(FilePath, 'r', encoding='utf-8') as f:
|
||||
content: str = f.read()
|
||||
self.ParseContent(content)
|
||||
|
||||
def ParseContent(self, content: str) -> None:
|
||||
content = _strip_comments(content)
|
||||
content = _strip_preprocessor_guards(content)
|
||||
self._ParseDefines(content)
|
||||
self._ParseTypedefStructs(content)
|
||||
self._ParseTypedefEnums(content)
|
||||
self._ParseTypedefUnions(content)
|
||||
self._ParseFuncPtrTypedefs(content)
|
||||
self._ParseSimpleTypedefs(content)
|
||||
self._ParseStandaloneStructs(content)
|
||||
self._ParseStandaloneEnums(content)
|
||||
self._ParseStandaloneUnions(content)
|
||||
stripped: str = self._StripBodies(content)
|
||||
self._ParseFunctions(stripped)
|
||||
self._ParseVariables(stripped)
|
||||
|
||||
def _StripBodies(self, content: str) -> str:
|
||||
result: str = content
|
||||
while True:
|
||||
pos: int = result.find('{')
|
||||
if pos < 0:
|
||||
break
|
||||
end: int = _find_matching_brace(result, pos)
|
||||
if end < 0:
|
||||
break
|
||||
result = result[:pos] + result[end + 1:]
|
||||
return result
|
||||
|
||||
def _ParseDefines(self, content: str) -> None:
|
||||
for match in re.finditer(r'#define\s+(\w+)(?:\s+(.+?))?\s*$', content, re.MULTILINE):
|
||||
Name: str = match.group(1)
|
||||
Value: str | None = match.group(2)
|
||||
if Name.startswith('_') and Name.endswith('_'):
|
||||
continue
|
||||
if Name.startswith('__'):
|
||||
continue
|
||||
self.defines.append({
|
||||
'name': Name,
|
||||
'value': Value.strip() if Value else None,
|
||||
})
|
||||
|
||||
def _ParseTypedefStructs(self, content: str) -> None:
|
||||
pattern: str = r'typedef\s+struct\s*(\w*)\s*\{'
|
||||
for match in re.finditer(pattern, content):
|
||||
brace_start: int = content.index('{', match.start())
|
||||
brace_end: int = _find_matching_brace(content, brace_start)
|
||||
if brace_end < 0:
|
||||
continue
|
||||
body: str = content[brace_start + 1:brace_end]
|
||||
rest: str = content[brace_end + 1:].lstrip()
|
||||
AliasMatch: re.Match[str] | None = re.match(r'(\w+)\s*;', rest)
|
||||
if not AliasMatch:
|
||||
continue
|
||||
AliasName: str = AliasMatch.group(1)
|
||||
TagName: str | None = match.group(1) if match.group(1) else None
|
||||
members: list[dict[str, Any]] = self._ParseStructMembers(body)
|
||||
self.structs[AliasName] = {
|
||||
'name': AliasName,
|
||||
'tag': TagName,
|
||||
'members': members,
|
||||
}
|
||||
if TagName:
|
||||
self._typedef_struct_map[TagName] = AliasName
|
||||
|
||||
def _ParseTypedefEnums(self, content: str) -> None:
|
||||
pattern: str = r'typedef\s+enum\s*(\w*)\s*\{'
|
||||
for match in re.finditer(pattern, content):
|
||||
brace_start: int = content.index('{', match.start())
|
||||
brace_end: int = _find_matching_brace(content, brace_start)
|
||||
if brace_end < 0:
|
||||
continue
|
||||
body: str = content[brace_start + 1:brace_end]
|
||||
rest: str = content[brace_end + 1:].lstrip()
|
||||
AliasMatch: re.Match[str] | None = re.match(r'(\w+)\s*;', rest)
|
||||
if not AliasMatch:
|
||||
continue
|
||||
AliasName: str = AliasMatch.group(1)
|
||||
TagName: str | None = match.group(1) if match.group(1) else None
|
||||
values: list[dict[str, str | None]] = self._ParseEnumValues(body)
|
||||
self.enums[AliasName] = {
|
||||
'name': AliasName,
|
||||
'tag': TagName,
|
||||
'values': values,
|
||||
}
|
||||
if TagName:
|
||||
self._typedef_enum_map[TagName] = AliasName
|
||||
|
||||
def _ParseTypedefUnions(self, content: str) -> None:
|
||||
pattern: str = r'typedef\s+union\s*(\w*)\s*\{'
|
||||
for match in re.finditer(pattern, content):
|
||||
brace_start: int = content.index('{', match.start())
|
||||
brace_end: int = _find_matching_brace(content, brace_start)
|
||||
if brace_end < 0:
|
||||
continue
|
||||
body: str = content[brace_start + 1:brace_end]
|
||||
rest: str = content[brace_end + 1:].lstrip()
|
||||
AliasMatch: re.Match[str] | None = re.match(r'(\w+)\s*;', rest)
|
||||
if not AliasMatch:
|
||||
continue
|
||||
AliasName: str = AliasMatch.group(1)
|
||||
TagName: str | None = match.group(1) if match.group(1) else None
|
||||
members: list[dict[str, Any]] = self._ParseStructMembers(body)
|
||||
self.unions[AliasName] = {
|
||||
'name': AliasName,
|
||||
'tag': TagName,
|
||||
'members': members,
|
||||
}
|
||||
if TagName:
|
||||
self._typedef_union_map[TagName] = AliasName
|
||||
|
||||
def _ParseFuncPtrTypedefs(self, content: str) -> None:
|
||||
pattern: str = r'typedef\s+([\w\s\*]+?)\s*\(\s*\*\s*(\w+)\s*\)\s*\(([^)]*)\)\s*;'
|
||||
for match in re.finditer(pattern, content):
|
||||
ReturnType: str = match.group(1).strip()
|
||||
Name: str = match.group(2)
|
||||
ParamsStr: str = match.group(3).strip()
|
||||
params: list[dict[str, Any]] = self._ParseFuncParams(ParamsStr)
|
||||
self.func_ptr_typedefs[Name] = {
|
||||
'name': Name,
|
||||
'return_type': ReturnType,
|
||||
'params': params,
|
||||
}
|
||||
|
||||
def _ParseSimpleTypedefs(self, content: str) -> None:
|
||||
stripped: str = self._StripBodies(content)
|
||||
pattern: str = r'typedef\s+([\w\s\*]+?)\s+(\w+)\s*;'
|
||||
for match in re.finditer(pattern, stripped):
|
||||
BaseType: str = match.group(1).strip()
|
||||
AliasName: str = match.group(2)
|
||||
if AliasName in self.structs:
|
||||
continue
|
||||
if AliasName in self.enums:
|
||||
continue
|
||||
if AliasName in self.unions:
|
||||
continue
|
||||
if AliasName in self.func_ptr_typedefs:
|
||||
continue
|
||||
if BaseType.startswith('typedef'):
|
||||
continue
|
||||
self.typedefs.append({'name': AliasName, 'base': BaseType})
|
||||
|
||||
def _ParseStandaloneStructs(self, content: str) -> None:
|
||||
pattern: str = r'(?<!typedef\s)struct\s+(\w+)\s*\{'
|
||||
for match in re.finditer(pattern, content):
|
||||
TagName: str = match.group(1)
|
||||
if TagName in self._typedef_struct_map:
|
||||
continue
|
||||
if TagName in self.structs:
|
||||
continue
|
||||
brace_start: int = content.index('{', match.start())
|
||||
brace_end: int = _find_matching_brace(content, brace_start)
|
||||
if brace_end < 0:
|
||||
continue
|
||||
body: str = content[brace_start + 1:brace_end]
|
||||
members: list[dict[str, Any]] = self._ParseStructMembers(body)
|
||||
self.structs[TagName] = {
|
||||
'name': TagName,
|
||||
'tag': None,
|
||||
'members': members,
|
||||
}
|
||||
|
||||
def _ParseStandaloneEnums(self, content: str) -> None:
|
||||
pattern: str = r'(?<!typedef\s)enum\s+(\w+)\s*\{'
|
||||
for match in re.finditer(pattern, content):
|
||||
TagName: str = match.group(1)
|
||||
if TagName in self._typedef_enum_map:
|
||||
continue
|
||||
if TagName in self.enums:
|
||||
continue
|
||||
brace_start: int = content.index('{', match.start())
|
||||
brace_end: int = _find_matching_brace(content, brace_start)
|
||||
if brace_end < 0:
|
||||
continue
|
||||
body: str = content[brace_start + 1:brace_end]
|
||||
values: list[dict[str, str | None]] = self._ParseEnumValues(body)
|
||||
self.enums[TagName] = {
|
||||
'name': TagName,
|
||||
'tag': None,
|
||||
'values': values,
|
||||
}
|
||||
|
||||
def _ParseStandaloneUnions(self, content: str) -> None:
|
||||
pattern: str = r'(?<!typedef\s)union\s+(\w+)\s*\{'
|
||||
for match in re.finditer(pattern, content):
|
||||
TagName: str = match.group(1)
|
||||
if TagName in self._typedef_union_map:
|
||||
continue
|
||||
if TagName in self.unions:
|
||||
continue
|
||||
brace_start: int = content.index('{', match.start())
|
||||
brace_end: int = _find_matching_brace(content, brace_start)
|
||||
if brace_end < 0:
|
||||
continue
|
||||
body: str = content[brace_start + 1:brace_end]
|
||||
members: list[dict[str, Any]] = self._ParseStructMembers(body)
|
||||
self.unions[TagName] = {
|
||||
'name': TagName,
|
||||
'tag': None,
|
||||
'members': members,
|
||||
}
|
||||
|
||||
def _ParseFunctions(self, content: str) -> None:
|
||||
pattern: str = r'(?:(?:static|extern|inline)\s+)*([\w][\w\s\*]*?)\b(\w+)\s*\(([^)]*)\)\s*;'
|
||||
for match in re.finditer(pattern, content):
|
||||
ReturnType: str = match.group(1).strip()
|
||||
FuncName: str = match.group(2)
|
||||
ParamsStr: str = match.group(3).strip()
|
||||
if FuncName in self.structs or FuncName in self.enums or FuncName in self.unions:
|
||||
continue
|
||||
if FuncName in self.func_ptr_typedefs:
|
||||
continue
|
||||
if FuncName in self.defines:
|
||||
continue
|
||||
if ReturnType in ('struct', 'union', 'enum', 'typedef'):
|
||||
continue
|
||||
if re.match(r'^\d', ReturnType):
|
||||
continue
|
||||
if not re.match(r'^[A-Za-z_]', FuncName):
|
||||
continue
|
||||
params: list[dict[str, Any]] = self._ParseFuncParams(ParamsStr)
|
||||
self.functions[FuncName] = {
|
||||
'name': FuncName,
|
||||
'return_type': ReturnType,
|
||||
'params': params,
|
||||
}
|
||||
|
||||
def _ParseVariables(self, content: str) -> None:
|
||||
pattern: str = r'(?:(?:static|extern|volatile|const)\s+)*([\w][\w\s\*]*?)\s+(\w+)\s*(?:\[(\d*)\])?\s*;'
|
||||
for match in re.finditer(pattern, content):
|
||||
TypeStr: str = match.group(1).strip()
|
||||
VarName: str = match.group(2)
|
||||
ArraySize: str | None = match.group(3)
|
||||
if VarName in self.functions or VarName in self.structs or VarName in self.enums:
|
||||
continue
|
||||
if VarName in self.unions or VarName in self.func_ptr_typedefs:
|
||||
continue
|
||||
if VarName in self.defines:
|
||||
continue
|
||||
if TypeStr.startswith('typedef'):
|
||||
continue
|
||||
if TypeStr in ('struct', 'union', 'enum', 'typedef'):
|
||||
continue
|
||||
if re.match(r'^(if|else|while|for|return|switch|case|break|continue|do|goto)$', VarName):
|
||||
continue
|
||||
if not re.match(r'^[A-Za-z_]', VarName):
|
||||
continue
|
||||
IsPtr: bool = '*' in TypeStr
|
||||
IsArray: bool = ArraySize is not None
|
||||
self.variables[VarName] = {
|
||||
'name': VarName,
|
||||
'type': TypeStr,
|
||||
'IsPtr': IsPtr,
|
||||
'is_array': IsArray,
|
||||
'array_size': int(ArraySize) if ArraySize and ArraySize.isdigit() else None,
|
||||
}
|
||||
|
||||
def _ParseStructMembers(self, body: str) -> list[dict[str, Any]]:
|
||||
members: list[dict[str, Any]] = []
|
||||
for line in body.split(';'):
|
||||
line = line.strip()
|
||||
if not line:
|
||||
continue
|
||||
arr_match: re.Match[str] | None = re.match(r'([\w\s\*]+?)\s+(\w+)\s*\[(\d*)\]', line)
|
||||
if arr_match:
|
||||
MemberType: str = arr_match.group(1).strip()
|
||||
MemberName: str = arr_match.group(2)
|
||||
ArraySize: str = arr_match.group(3)
|
||||
members.append({
|
||||
'name': MemberName,
|
||||
'type': MemberType,
|
||||
'is_array': True,
|
||||
'array_size': int(ArraySize) if ArraySize and ArraySize.isdigit() else None,
|
||||
})
|
||||
continue
|
||||
ptr_match: re.Match[str] | None = re.match(r'([\w\s\*]+?)\s*\*\s*(\w+)', line)
|
||||
if ptr_match:
|
||||
MemberType: str = ptr_match.group(1).strip() + ' *'
|
||||
MemberName: str = ptr_match.group(2)
|
||||
members.append({
|
||||
'name': MemberName,
|
||||
'type': MemberType,
|
||||
'IsPtr': True,
|
||||
})
|
||||
continue
|
||||
simple_match: re.Match[str] | None = re.match(r'([\w\s]+?)\s+(\w+)', line)
|
||||
if simple_match:
|
||||
MemberType: str = simple_match.group(1).strip()
|
||||
MemberName: str = simple_match.group(2)
|
||||
members.append({
|
||||
'name': MemberName,
|
||||
'type': MemberType,
|
||||
})
|
||||
return members
|
||||
|
||||
def _ParseEnumValues(self, body: str) -> list[dict[str, str | None]]:
|
||||
values: list[dict[str, str | None]] = []
|
||||
for item in body.split(','):
|
||||
item = item.strip()
|
||||
if not item:
|
||||
continue
|
||||
eq_pos: int = item.find('=')
|
||||
if eq_pos >= 0:
|
||||
Name: str = item[:eq_pos].strip()
|
||||
Value: str | None = item[eq_pos + 1:].strip()
|
||||
else:
|
||||
Name = item.strip()
|
||||
Value = None
|
||||
if Name and re.match(r'^[A-Za-z_]\w*$', Name):
|
||||
values.append({'name': Name, 'value': Value})
|
||||
return values
|
||||
|
||||
def _ParseFuncParams(self, params_str: str) -> list[dict[str, Any]]:
|
||||
params: list[dict[str, Any]] = []
|
||||
if not params_str or params_str.strip() == 'void' or params_str.strip() == '':
|
||||
return params
|
||||
for param in params_str.split(','):
|
||||
param = param.strip()
|
||||
if not param:
|
||||
continue
|
||||
func_ptr_match: re.Match[str] | None = re.match(r'([\w\s\*]+?)\s*\(\s*\*\s*(\w*)\s*\)\s*\([^)]*\)', param)
|
||||
if func_ptr_match:
|
||||
RetType: str = func_ptr_match.group(1).strip()
|
||||
ParamName: str = func_ptr_match.group(2) or 'callback'
|
||||
params.append({
|
||||
'name': ParamName,
|
||||
'type': RetType + ' (*)',
|
||||
'is_func_ptr': True,
|
||||
})
|
||||
continue
|
||||
arr_match: re.Match[str] | None = re.match(r'([\w\s\*]+?)\s+(\w+)\s*\[\d*\]', param)
|
||||
if arr_match:
|
||||
ParamType: str = arr_match.group(1).strip()
|
||||
ParamName: str = arr_match.group(2)
|
||||
params.append({
|
||||
'name': ParamName,
|
||||
'type': ParamType,
|
||||
'is_array': True,
|
||||
})
|
||||
continue
|
||||
tokens: list[str] = param.split()
|
||||
if len(tokens) >= 2:
|
||||
LastToken: str = tokens[-1]
|
||||
PtrCount: int = 0
|
||||
while LastToken.startswith('*'):
|
||||
PtrCount += 1
|
||||
LastToken = LastToken[1:]
|
||||
TypeTokens: list[str] = tokens[:-1]
|
||||
for _ in range(PtrCount):
|
||||
TypeTokens.append('*')
|
||||
ParamName: str = LastToken
|
||||
ParamType: str = ' '.join(TypeTokens)
|
||||
if not ParamName:
|
||||
ParamName = 'arg'
|
||||
ParamType = param
|
||||
params.append({
|
||||
'name': ParamName,
|
||||
'type': ParamType,
|
||||
})
|
||||
elif len(tokens) == 1:
|
||||
params.append({
|
||||
'name': 'arg',
|
||||
'type': tokens[0],
|
||||
})
|
||||
return params
|
||||
|
||||
|
||||
class PythonStubGenerator:
|
||||
"""Python 存根文件生成器"""
|
||||
|
||||
def __init__(self, parser: CHeaderParser) -> None:
|
||||
self.parser: CHeaderParser = parser
|
||||
self.OutputLines: list[str] = []
|
||||
|
||||
def generate(self, ModuleName: str | None = None) -> str:
|
||||
self.OutputLines = []
|
||||
self._AddHeader(ModuleName)
|
||||
self._GenerateImports()
|
||||
self._GenerateDefines()
|
||||
self._GenerateFuncPtrTypedefs()
|
||||
self._GenerateSimpleTypedefs()
|
||||
self._GenerateStructs()
|
||||
self._GenerateUnions()
|
||||
self._GenerateEnums()
|
||||
self._GenerateVariables()
|
||||
self._GenerateFunctions()
|
||||
return '\n'.join(self.OutputLines)
|
||||
|
||||
def _AddHeader(self, ModuleName: str | None = None) -> None:
|
||||
self.OutputLines.append('"""')
|
||||
self.OutputLines.append('Auto-generated Python stub file from C header')
|
||||
if ModuleName:
|
||||
self.OutputLines.append(f'Module: {ModuleName}')
|
||||
self.OutputLines.append('"""')
|
||||
self.OutputLines.append('')
|
||||
|
||||
def _GenerateImports(self) -> None:
|
||||
self.OutputLines.append('import t')
|
||||
self.OutputLines.append('import c')
|
||||
self.OutputLines.append('')
|
||||
|
||||
def _GenerateDefines(self) -> None:
|
||||
if not self.parser.defines:
|
||||
return
|
||||
for define in self.parser.defines:
|
||||
Name: str = define['name']
|
||||
Value: str | None = define['value']
|
||||
if Value is not None:
|
||||
self.OutputLines.append(f'{Name}: t.CDefine = {Value}')
|
||||
else:
|
||||
self.OutputLines.append(f'{Name}: t.CDefine')
|
||||
self.OutputLines.append('')
|
||||
|
||||
def _GenerateFuncPtrTypedefs(self) -> None:
|
||||
if not self.parser.func_ptr_typedefs:
|
||||
return
|
||||
for Name, Info in self.parser.func_ptr_typedefs.items():
|
||||
RetType: str = CTypeMapper.MapType(Info['return_type'])
|
||||
ParamTypes: list[str] = []
|
||||
for p in Info['params']:
|
||||
ParamTypes.append(CTypeMapper.MapType(p['type']))
|
||||
ParamStr: str = ', '.join(ParamTypes) if ParamTypes else ''
|
||||
self.OutputLines.append(f'{Name}: t.CTypedef = t.Callable[[{ParamStr}], {RetType}]')
|
||||
self.OutputLines.append('')
|
||||
|
||||
def _GenerateSimpleTypedefs(self) -> None:
|
||||
if not self.parser.typedefs:
|
||||
return
|
||||
for td in self.parser.typedefs:
|
||||
AliasName: str = td['name']
|
||||
BaseType: str = td['base']
|
||||
PyType: str = CTypeMapper.MapType(BaseType)
|
||||
self.OutputLines.append(f'{AliasName}: t.CTypedef | {PyType}')
|
||||
self.OutputLines.append('')
|
||||
|
||||
def _GenerateStructs(self) -> None:
|
||||
if not self.parser.structs:
|
||||
return
|
||||
for StructName, StructInfo in self.parser.structs.items():
|
||||
self.OutputLines.append(f'@c.Attribute(t.attr.packed)')
|
||||
self.OutputLines.append(f'class {StructName}(t.CStruct):')
|
||||
if StructInfo['members']:
|
||||
for member in StructInfo['members']:
|
||||
MemberName: str = member['name']
|
||||
IsPtr: bool = member.get('IsPtr', False)
|
||||
IsArray: bool = member.get('is_array', False)
|
||||
ArraySize: int | None = member.get('array_size')
|
||||
PyType: str = CTypeMapper.MapType(member['type'], IsPtr=IsPtr)
|
||||
if IsArray and ArraySize is not None:
|
||||
self.OutputLines.append(f' {MemberName}: list[{PyType}, {ArraySize}]')
|
||||
elif IsArray:
|
||||
self.OutputLines.append(f' {MemberName}: {PyType} | t.CArrayPtr')
|
||||
else:
|
||||
self.OutputLines.append(f' {MemberName}: {PyType}')
|
||||
else:
|
||||
self.OutputLines.append(' pass')
|
||||
self.OutputLines.append('')
|
||||
|
||||
def _GenerateUnions(self) -> None:
|
||||
if not self.parser.unions:
|
||||
return
|
||||
for UnionName, UnionInfo in self.parser.unions.items():
|
||||
self.OutputLines.append(f'@c.Attribute(t.attr.packed)')
|
||||
self.OutputLines.append(f'class {UnionName}(t.CUnion):')
|
||||
if UnionInfo['members']:
|
||||
for member in UnionInfo['members']:
|
||||
PyType: str = CTypeMapper.MapType(member['type'], IsPtr=member.get('IsPtr', False))
|
||||
self.OutputLines.append(f' {member["name"]}: {PyType}')
|
||||
else:
|
||||
self.OutputLines.append(' pass')
|
||||
self.OutputLines.append('')
|
||||
|
||||
def _GenerateEnums(self) -> None:
|
||||
if not self.parser.enums:
|
||||
return
|
||||
for EnumName, EnumInfo in self.parser.enums.items():
|
||||
self.OutputLines.append(f'class __{EnumName.lower()}(t.CEnum):')
|
||||
if EnumInfo['values']:
|
||||
for value in EnumInfo['values']:
|
||||
if value['value'] is not None:
|
||||
self.OutputLines.append(f' {value["name"]}: t.CDefine = {value["value"]}')
|
||||
else:
|
||||
self.OutputLines.append(f' {value["name"]}: t.CDefine')
|
||||
else:
|
||||
self.OutputLines.append(' pass')
|
||||
self.OutputLines.append(f'{EnumName}: t.CTypedef = __{EnumName.lower()}')
|
||||
self.OutputLines.append('')
|
||||
|
||||
def _GenerateVariables(self) -> None:
|
||||
if not self.parser.variables:
|
||||
return
|
||||
for VarName, VarInfo in self.parser.variables.items():
|
||||
PyType: str = CTypeMapper.MapType(VarInfo['type'], IsPtr=VarInfo['IsPtr'], IsArray=VarInfo['is_array'])
|
||||
self.OutputLines.append(f'{VarName}: {PyType}')
|
||||
self.OutputLines.append('')
|
||||
|
||||
def _GenerateFunctions(self) -> None:
|
||||
if not self.parser.functions:
|
||||
return
|
||||
for FuncName, FuncInfo in self.parser.functions.items():
|
||||
params: list[str] = []
|
||||
for param in FuncInfo['params']:
|
||||
if param.get('is_func_ptr'):
|
||||
PyType: str = CTypeMapper.MapType(param['type'])
|
||||
elif param.get('is_array'):
|
||||
PyType: str = CTypeMapper.MapType(param['type'], IsPtr=True)
|
||||
else:
|
||||
PyType: str = CTypeMapper.MapType(param['type'])
|
||||
params.append(f'{param["name"]}: {PyType}')
|
||||
ParamStr: str = ', '.join(params) if params else ''
|
||||
ReturnType: str = CTypeMapper.MapType(FuncInfo['return_type'])
|
||||
self.OutputLines.append(f'def {FuncName}({ParamStr}) -> {ReturnType}: pass')
|
||||
self.OutputLines.append('')
|
||||
|
||||
|
||||
def GenerateStubFromC(InputFile: str, OutputFile: str | None = None) -> str:
|
||||
parser: CHeaderParser = CHeaderParser()
|
||||
parser.ParseFile(InputFile)
|
||||
generator: PythonStubGenerator = PythonStubGenerator(parser)
|
||||
ModuleName: str = os.path.splitext(os.path.basename(InputFile))[0]
|
||||
content: str = generator.generate(ModuleName)
|
||||
if OutputFile:
|
||||
with open(OutputFile, 'w', encoding='utf-8') as f:
|
||||
f.write(content)
|
||||
_vlog().success(f"生成: {OutputFile}")
|
||||
return content
|
||||
|
||||
|
||||
if __name__ == '__main__':
|
||||
if len(sys.argv) >= 3:
|
||||
GenerateStubFromC(sys.argv[1], sys.argv[2])
|
||||
elif len(sys.argv) == 2:
|
||||
_vlog().info(GenerateStubFromC(sys.argv[1]))
|
||||
else:
|
||||
test_code: str = '''
|
||||
struct memory_block {
|
||||
uint64_t size;
|
||||
uint8_t state;
|
||||
uint8_t order;
|
||||
struct memory_block *next;
|
||||
struct memory_block *prev;
|
||||
};
|
||||
|
||||
typedef struct memory_block memory_block_t;
|
||||
|
||||
enum color_format {
|
||||
COLOR_FORMAT_BGRA,
|
||||
COLOR_FORMAT_RGBA,
|
||||
COLOR_FORMAT_BGR,
|
||||
COLOR_FORMAT_RGB
|
||||
};
|
||||
|
||||
void *malloc(size_t size);
|
||||
void free(void *ptr);
|
||||
void *memcpy(void *dest, const void *src, size_t n);
|
||||
'''
|
||||
parser: CHeaderParser = CHeaderParser()
|
||||
parser.ParseContent(test_code)
|
||||
generator: PythonStubGenerator = PythonStubGenerator(parser)
|
||||
_vlog().info(generator.generate("test_header"))
|
||||
Reference in New Issue
Block a user