| 1 |
#!/usr/bin/env python |
| 2 |
# License: GPL v3 Copyright: 2021, Kovid Goyal <kovid at kovidgoyal.net> |
| 3 |
|
| 4 |
import importlib |
| 5 |
import os |
| 6 |
from pprint import pprint |
| 7 |
|
| 8 |
QT_WRAPPER = 'PyQt6' |
| 9 |
|
| 10 |
base = os.path.dirname(os.path.abspath(__file__)) |
| 11 |
module_lists = { |
| 12 |
'core': ( |
| 13 |
'QtCore', |
| 14 |
'QtGui', |
| 15 |
'QtWidgets', |
| 16 |
'QtNetwork', |
| 17 |
'QtSvg', |
| 18 |
'QtPrintSupport', |
| 19 |
'QtOpenGL', |
| 20 |
'QtOpenGLWidgets', |
| 21 |
'QtQuick', |
| 22 |
'QtMultimedia', |
| 23 |
'QtMultimediaWidgets', |
| 24 |
'QtTextToSpeech', |
| 25 |
), |
| 26 |
'webengine': ( |
| 27 |
'QtWebEngineCore', |
| 28 |
'QtWebEngineWidgets', |
| 29 |
'QtWebChannel', |
| 30 |
), |
| 31 |
'dbus': ('QtDBus',), |
| 32 |
} |
| 33 |
|
| 34 |
|
| 35 |
special_case = { |
| 36 |
'pyqtProperty': ''' |
| 37 |
|
| 38 |
_T = TypeVar('_T') |
| 39 |
_R = TypeVar('_R') |
| 40 |
|
| 41 |
class pyqtProperty: |
| 42 |
# --- Overload 1: Used as a decorator factory (e.g., @pyqtProperty(int)) --- |
| 43 |
@overload |
| 44 |
def __init__( |
| 45 |
self, |
| 46 |
type: type[_R] | str, |
| 47 |
fget: None = None, |
| 48 |
fset: None = None, |
| 49 |
freset: None = None, |
| 50 |
fdel: None = None, |
| 51 |
doc: str | None = None, |
| 52 |
designable: bool = True, |
| 53 |
scriptable: bool = True, |
| 54 |
stored: bool = True, |
| 55 |
user: bool = False, |
| 56 |
constant: bool = False, |
| 57 |
final: bool = False, |
| 58 |
notify: pyqtSignal | None = None, |
| 59 |
revision: int = 0, |
| 60 |
) -> None: ... |
| 61 |
|
| 62 |
# --- Overload 2: Used as a functional constructor (e.g., x = pyqtProperty(int, get_x, set_x)) --- |
| 63 |
@overload |
| 64 |
def __init__( |
| 65 |
self, |
| 66 |
type: type[_R] | str, |
| 67 |
fget: Callable[[Any], _R], |
| 68 |
fset: Callable[[Any, _R], None] | None = None, |
| 69 |
freset: Callable[[Any], None] | None = None, |
| 70 |
fdel: Callable[[Any], None] | None = None, |
| 71 |
doc: str | None = None, |
| 72 |
designable: bool = True, |
| 73 |
scriptable: bool = True, |
| 74 |
stored: bool = True, |
| 75 |
user: bool = False, |
| 76 |
constant: bool = False, |
| 77 |
final: bool = False, |
| 78 |
notify: pyqtSignal | None = None, |
| 79 |
revision: int = 0, |
| 80 |
) -> None: ... |
| 81 |
|
| 82 |
# --- Behaviors required to act like a standard Python property descriptor --- |
| 83 |
def __call__(self, fget: Callable[[_T], _R]) -> pyqtProperty: ... |
| 84 |
def __get__(self, instance: _T, owner: type[_T] | None = None) -> _R: ... |
| 85 |
def __set__(self, instance: _T, value: _R) -> None: ... |
| 86 |
def __delete__(self, instance: _T) -> None: ... |
| 87 |
|
| 88 |
def setter(self, fset: Callable[[_T, _R], None]) -> pyqtProperty: ... |
| 89 |
def deleter(self, fdel: Callable[[_T], None]) -> pyqtProperty: ... |
| 90 |
''', |
| 91 |
# The following ty thinks dont exist probably cause they are missing from stub |
| 92 |
# files |
| 93 |
'QtAudio': '', |
| 94 |
'QStyleOptionMenuItemV2': '', |
| 95 |
'QPyAbstractRange': '', |
| 96 |
'QPySequenceRange': '', |
| 97 |
'QPyTableRange': '', |
| 98 |
'QRangeModel': '', |
| 99 |
} |
| 100 |
|
| 101 |
|
| 102 |
def scan(name): |
| 103 |
module_names = module_lists[name] |
| 104 |
name_map = {} |
| 105 |
types = [] |
| 106 |
blocks = [] |
| 107 |
for mod_name in module_names: |
| 108 |
mod = importlib.import_module(f'{QT_WRAPPER}.{mod_name}') |
| 109 |
full_name = name_map[mod_name] = mod.__name__ |
| 110 |
types.append(f'import {full_name}') |
| 111 |
for obj_name in sorted(dir(mod)): |
| 112 |
if not obj_name.startswith('_') and obj_name not in name_map: |
| 113 |
name_map[obj_name] = full_name |
| 114 |
if (block := special_case.get(obj_name)) is not None: |
| 115 |
blocks.append(block) |
| 116 |
else: |
| 117 |
types.append(f'{obj_name} = {full_name}.{obj_name}') |
| 118 |
with open(f'{base}/{name}.py', 'w') as f: |
| 119 |
print('# autogenerated by __main__.py do not edit', file=f) |
| 120 |
print(f'from .{name}_name_map import module_names, name_map', file=f) |
| 121 |
print( |
| 122 |
'''from .loader import dynamic_load |
| 123 |
|
| 124 |
already_imported = {} |
| 125 |
qt_modules = {} |
| 126 |
|
| 127 |
def __getattr__(name): |
| 128 |
return dynamic_load(name, name_map, already_imported, qt_modules, module_names) |
| 129 |
''', |
| 130 |
end='', |
| 131 |
file=f, |
| 132 |
) |
| 133 |
if name == 'core': |
| 134 |
module_names += ('sip',) |
| 135 |
mod = importlib.import_module(f'{QT_WRAPPER}.sip') |
| 136 |
name_map['sip'] = mod.__name__ |
| 137 |
types.append(f'import {mod.__name__}') |
| 138 |
types.append(f'sip = {mod.__name__}') |
| 139 |
|
| 140 |
with open(f'{base}/{name}.pyi', 'w') as f: |
| 141 |
print('# autogenerated by __main__.py do not edit', file=f) |
| 142 |
if name == 'core': |
| 143 |
print('from collections.abc import Callable', file=f) |
| 144 |
print('from typing import Any, TypeVar, overload', file=f) |
| 145 |
print('\n'.join(types), file=f) |
| 146 |
for block in blocks: |
| 147 |
if block: |
| 148 |
print(file=f) |
| 149 |
print(block.strip(), file=f) |
| 150 |
with open(f'{base}/{name}_name_map.py', 'w') as f: |
| 151 |
print('# autogenerated by __main__.py do not edit', file=f) |
| 152 |
print('name_map =', end=' ', file=f) |
| 153 |
pprint(name_map, stream=f) |
| 154 |
print('module_names = frozenset(', end='', file=f) |
| 155 |
pprint(module_names, stream=f) |
| 156 |
print(')', file=f) |
| 157 |
|
| 158 |
|
| 159 |
top_level_module_names = () |
| 160 |
for name, module_name in module_lists.items(): |
| 161 |
top_level_module_names += module_name |
| 162 |
scan(name) |
| 163 |
with open(f'{base}/__init__.py', 'w') as f: |
| 164 |
print('# autogenerated by __main__.py do not edit', file=f) |
| 165 |
print('top_level_module_names = ', end='', file=f) |
| 166 |
pprint(top_level_module_names, stream=f) |
| 167 |
print( |
| 168 |
f''' |
| 169 |
|
| 170 |
def __getattr__(name): |
| 171 |
if name in top_level_module_names: |
| 172 |
import importlib |
| 173 |
return importlib.import_module('{QT_WRAPPER}.' + name) |
| 174 |
raise AttributeError(name) |
| 175 |
''', |
| 176 |
end='', |
| 177 |
file=f, |
| 178 |
) |