qpi-cli 0.2.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
qpi_cli/__init__.py ADDED
@@ -0,0 +1,21 @@
1
+ # -*- coding: utf-8 -*-
2
+ """qpi-cli — QuecPi QCS6490 (PI H1) Yocto Linux SDK 命令行。
3
+
4
+ 对 Quectel-Pi/Pi-H1-Linux-SDK 仓库做一层薄封装, 不改变任何构建逻辑。
5
+ 真正的构建/打包/烧录仍由 quectel_build/compile/build.sh 里的函数完成:
6
+ buildconfig / buildall / buildpackage / flash / buildenv / buildkernel / builddtb
7
+
8
+ 只依赖 Python 3 标准库, 不引入任何第三方包。
9
+ """
10
+
11
+ __version__ = "0.2.0"
12
+ CLI_NAME = "qpi-cli"
13
+
14
+ __all__ = ["__version__", "CLI_NAME", "main"]
15
+
16
+
17
+ def main(argv=None):
18
+ """控制台入口 (qpi-cli / python -m qpi_cli)。"""
19
+ from .cli import main as _main
20
+
21
+ return _main(argv)
qpi_cli/__main__.py ADDED
@@ -0,0 +1,9 @@
1
+ # -*- coding: utf-8 -*-
2
+ """支持 `python -m qpi_cli`。"""
3
+
4
+ import sys
5
+
6
+ from .cli import main
7
+
8
+ if __name__ == "__main__":
9
+ sys.exit(main())
qpi_cli/cli.py ADDED
@@ -0,0 +1,184 @@
1
+ # -*- coding: utf-8 -*-
2
+ """qpi-cli 参数解析与控制台入口。"""
3
+
4
+ import argparse
5
+ import sys
6
+
7
+ from . import CLI_NAME, __version__
8
+ from .commands import (
9
+ cmd_build,
10
+ cmd_clean,
11
+ cmd_config,
12
+ cmd_doctor,
13
+ cmd_flash,
14
+ cmd_kernel,
15
+ cmd_ls_projects,
16
+ cmd_ls_versions,
17
+ cmd_new,
18
+ cmd_package,
19
+ cmd_setup,
20
+ cmd_version,
21
+ )
22
+ from .core import BUILD_SH, Ctx, error, find_sdk_root, warn
23
+
24
+
25
+ def build_parser():
26
+ parser = argparse.ArgumentParser(
27
+ prog=CLI_NAME,
28
+ description="QuecPi QCS6490 (PI H1) Yocto Linux SDK 命令行 (对外独立版, Linux 宿主)",
29
+ formatter_class=argparse.RawDescriptionHelpFormatter,
30
+ allow_abbrev=False,
31
+ epilog="示例:\n"
32
+ " qpi-cli doctor\n"
33
+ " qpi-cli setup\n"
34
+ " qpi-cli version\n"
35
+ " qpi-cli build --os LINUX --ver STD\n"
36
+ " qpi-cli package && qpi-cli flash ufs\n",
37
+ )
38
+ parser.add_argument(
39
+ "--sdk", help="SDK 根目录 (默认自动探测, 或设置 QPI_SDK_ROOT)"
40
+ )
41
+ parser.add_argument(
42
+ "--dry-run", action="store_true", help="只打印将要执行的命令, 不真正执行"
43
+ )
44
+ parser.add_argument(
45
+ "--verbose", action="store_true", help="显示 SDK 环境脚本输出"
46
+ )
47
+ parser.add_argument(
48
+ "--version", action="version", version="%s %s" % (CLI_NAME, __version__)
49
+ )
50
+
51
+ # 全局开关同时挂到每个子命令上, 使 `qpi-cli build --dry-run` 与
52
+ # `qpi-cli --dry-run build` 两种写法都可用 (SUPPRESS 避免覆盖主解析结果)。
53
+ common = argparse.ArgumentParser(add_help=False)
54
+ common.add_argument("--sdk", default=argparse.SUPPRESS, help=argparse.SUPPRESS)
55
+ common.add_argument(
56
+ "--dry-run",
57
+ action="store_true",
58
+ default=argparse.SUPPRESS,
59
+ help="只打印将要执行的命令, 不真正执行",
60
+ )
61
+ common.add_argument(
62
+ "--verbose",
63
+ action="store_true",
64
+ default=argparse.SUPPRESS,
65
+ help="显示 SDK 环境脚本输出",
66
+ )
67
+
68
+ sub = parser.add_subparsers(dest="command")
69
+
70
+ sub.add_parser("version", parents=[common], help="显示 CLI 与 SDK 信息")
71
+
72
+ sub.add_parser(
73
+ "doctor",
74
+ parents=[common],
75
+ help="只读预检宿主环境 (发行版/磁盘/swap/内存/依赖/userns)",
76
+ )
77
+
78
+ p_setup = sub.add_parser(
79
+ "setup",
80
+ parents=[common],
81
+ help="安装宿主构建环境 (调用 install_build_env.sh)",
82
+ )
83
+ p_setup.add_argument(
84
+ "extra",
85
+ nargs=argparse.REMAINDER,
86
+ help="透传给 install_build_env.sh 的参数 (示例: setup -- --help)",
87
+ )
88
+
89
+ p_cfg = sub.add_parser(
90
+ "config",
91
+ parents=[common],
92
+ help="显示/初始化配置 (~/.config/qpi-cli/config.json)",
93
+ )
94
+ p_cfg.add_argument("--init", action="store_true", help="写入默认配置")
95
+ p_cfg.add_argument(
96
+ "--force", action="store_true", help="配合 --init, 覆盖已存在的配置"
97
+ )
98
+ p_cfg.add_argument(
99
+ "--get", metavar="KEY", help="读取配置项 (点分路径, 如 build.os)"
100
+ )
101
+ p_cfg.add_argument("--set", metavar="KEY=VALUE", action="append", help="写入配置项")
102
+
103
+ p_new = sub.add_parser(
104
+ "new", parents=[common], help="创建应用工程 (含 .code-workspace)"
105
+ )
106
+ p_new.add_argument("name", help="应用名")
107
+ p_new.add_argument("--force", action="store_true", help="已存在时覆盖")
108
+
109
+ p_lsp = sub.add_parser("ls-projects", parents=[common], help="列出应用工程")
110
+ p_lsp.add_argument("-j", "--json", action="store_true", help="JSON 输出")
111
+
112
+ p_lsv = sub.add_parser(
113
+ "ls-versions", parents=[common], help="列出固件版本及状态 (三态)"
114
+ )
115
+ p_lsv.add_argument("-j", "--json", action="store_true", help="JSON 输出")
116
+
117
+ p_build = sub.add_parser(
118
+ "build", parents=[common], help="buildconfig + buildall (完整构建)"
119
+ )
120
+ p_build.add_argument("--project", help="工程名 (默认取配置)")
121
+ p_build.add_argument("--rev", help="revision (默认取当前 header)")
122
+ p_build.add_argument("--os", choices=["LINUX", "DEBIAN", "UBUNTU"], help="OS 维度")
123
+ p_build.add_argument(
124
+ "--variant", "--ver", dest="variant", choices=["STD", "DBG"], help="发布维度"
125
+ )
126
+ p_build.add_argument("--sec", action="store_true", help="启用安全启动 (SEC)")
127
+
128
+ sub.add_parser(
129
+ "package", parents=[common], help="a_key_generation: 生成可烧录固件包"
130
+ )
131
+
132
+ p_flash = sub.add_parser("flash", parents=[common], help="烧录固件到开发板")
133
+ p_flash.add_argument("storage", nargs="?", choices=["ufs", "emmc"], default="ufs")
134
+
135
+ p_kern = sub.add_parser("kernel", parents=[common], help="内核相关操作")
136
+ p_kern.add_argument("--dtb", action="store_true", help="仅重编 DTB")
137
+ p_kern.add_argument("--menuconfig", action="store_true", help="打开内核 menuconfig")
138
+
139
+ p_clean = sub.add_parser("clean", parents=[common], help="清理构建/固件产物")
140
+ p_clean.add_argument("--packages", action="store_true", help="删除已打包固件目录")
141
+ p_clean.add_argument(
142
+ "--build", action="store_true", help="删除 build-qcom-wayland/tmp-glibc"
143
+ )
144
+ p_clean.add_argument("--yes", action="store_true", help="确认删除")
145
+
146
+ return parser
147
+
148
+
149
+ def main(argv=None):
150
+ parser = build_parser()
151
+ args = parser.parse_args(argv)
152
+
153
+ if not args.command:
154
+ parser.print_help()
155
+ return 0
156
+
157
+ root = find_sdk_root(args.sdk)
158
+ if root is None:
159
+ error(
160
+ "未找到 SDK 根目录 (需包含 %s)。请用 --sdk 或设置 QPI_SDK_ROOT。"
161
+ % BUILD_SH
162
+ )
163
+ return 2
164
+ args.ctx = Ctx(root)
165
+
166
+ handlers = {
167
+ "version": cmd_version,
168
+ "doctor": cmd_doctor,
169
+ "setup": cmd_setup,
170
+ "config": cmd_config,
171
+ "new": cmd_new,
172
+ "ls-projects": cmd_ls_projects,
173
+ "ls-versions": cmd_ls_versions,
174
+ "build": cmd_build,
175
+ "package": cmd_package,
176
+ "flash": cmd_flash,
177
+ "kernel": cmd_kernel,
178
+ "clean": cmd_clean,
179
+ }
180
+ try:
181
+ return handlers[args.command](args)
182
+ except KeyboardInterrupt:
183
+ warn("已中断")
184
+ return 130