1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
|
# Copyright (C) 2022 The Qt Company Ltd.
# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
"""
generate_pyi.py
This script generates the .pyi files for all PySide modules.
"""
import argparse
import inspect
import logging
import os
import sys
import typing
from pathlib import Path
from types import SimpleNamespace
# Can we use forward references?
USE_PEP563 = sys.version_info[:2] >= (3, 7)
def generate_all_pyi(outpath, options):
ps = os.pathsep
if options.sys_path:
# make sure to propagate the paths from sys_path to subprocesses
normpath = lambda x: os.fspath(Path(x).resolve())
sys_path = [normpath(_) for _ in options.sys_path]
sys.path[0:0] = sys_path
pypath = ps.join(sys_path)
os.environ["PYTHONPATH"] = pypath
# now we can import
global PySide6, inspect, typing, HintingEnumerator, build_brace_pattern
import PySide6
from PySide6.support.signature.lib.enum_sig import HintingEnumerator
from PySide6.support.signature.lib.tool import build_brace_pattern
from PySide6.support.signature.lib.pyi_generator import generate_pyi
# propagate USE_PEP563 to the mapping module.
# Perhaps this can be automated?
PySide6.support.signature.mapping.USE_PEP563 = USE_PEP563
outpath = Path(outpath) if outpath and os.fspath(outpath) else Path(PySide6.__file__).parent
name_list = PySide6.__all__ if options.modules == ["all"] else options.modules
errors = ", ".join(set(name_list) - set(PySide6.__all__))
if errors:
raise ImportError(f"The module(s) '{errors}' do not exist")
for mod_name in name_list:
import_name = "PySide6." + mod_name
if hasattr(sys, "pypy_version_info"):
# PYSIDE-535: We cannot use __feature__ yet in PyPy
generate_pyi(import_name, outpath, options)
else:
from PySide6.support import feature
feature_id = feature.get_select_id(options.feature)
with feature.force_selection(feature_id, import_name):
generate_pyi(import_name, outpath, options)
if __name__ == "__main__":
parser = argparse.ArgumentParser(
description="This script generates the .pyi file for all PySide modules.")
parser.add_argument("modules", nargs="+",
help="'all' or the names of modules to build (QtCore QtGui etc.)")
parser.add_argument("--quiet", action="store_true", help="Run quietly")
parser.add_argument("--check", action="store_true", help="Test the output if on Python 3")
parser.add_argument("--outpath",
help="the output directory (default = binary location)")
parser.add_argument("--sys-path", nargs="+",
help="a list of strings prepended to sys.path")
parser.add_argument("--feature", nargs="+", choices=["snake_case", "true_property"], default=[],
help="""a list of feature names. Example: `--feature snake_case true_property`""")
options = parser.parse_args()
qtest_env = os.environ.get("QTEST_ENVIRONMENT", "")
log_level = logging.DEBUG if qtest_env else logging.INFO
if options.quiet:
log_level = logging.WARNING
logging.basicConfig(level=log_level)
logger = logging.getLogger("generate_pyi")
outpath = options.outpath
if outpath and not Path(outpath).exists():
os.makedirs(outpath)
logger.info(f"+++ Created path {outpath}")
options._pyside_call = True
options.logger = logger
options.is_ci = qtest_env == "ci"
generate_all_pyi(outpath, options=options)
# eof
|
