qpi-cli 0.2.0__tar.gz → 0.2.1__tar.gz

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.
@@ -1,10 +1,13 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: qpi-cli
3
- Version: 0.2.0
3
+ Version: 0.2.1
4
4
  Summary: QuecPi QCS6490 (PI H1) Yocto Linux SDK 命令行工具 (构建 / 打包 / 烧录)
5
5
  Author: Quectel Pi
6
6
  License: MIT
7
- Project-URL: Homepage, https://github.com/Quectel-Pi/Pi-H1-Linux-SDK
7
+ Project-URL: Homepage, https://github.com/james-liu18/qpi-cli
8
+ Project-URL: Repository, https://github.com/james-liu18/qpi-cli
9
+ Project-URL: Bug Tracker, https://github.com/james-liu18/qpi-cli/issues
10
+ Project-URL: SDK (Pi-H1-Linux-SDK), https://github.com/Quectel-Pi/Pi-H1-Linux-SDK
8
11
  Keywords: quectel,quecpi,qpi,qcs6490,yocto,sdk,bitbake,cli
9
12
  Classifier: Development Status :: 4 - Beta
10
13
  Classifier: Environment :: Console
@@ -269,7 +272,7 @@ FLASH_ENTRY=scripts/flash.sh
269
272
  ## 10. 从源码安装与发布
270
273
 
271
274
  ```bash
272
- git clone <本仓库>
275
+ git clone https://github.com/james-liu18/qpi-cli.git
273
276
  cd qpi-cli
274
277
 
275
278
  # 本地开发安装(可编辑)
@@ -288,6 +291,36 @@ twine upload dist/*
288
291
  版本号唯一来源是 `src/qpi_cli/__init__.py` 中的 `__version__`,
289
292
  `pyproject.toml` 通过 `dynamic = ["version"]` 自动读取,无需两处同步。
290
293
 
294
+ ### 自动发布(GitHub Actions)
295
+
296
+ 仓库内的 `.github/workflows/release.yml` 实现打 tag 自动发布:
297
+
298
+ ```bash
299
+ # 发布 0.2.1:先把 __version__ 改成 0.2.1 并提交,再打 tag
300
+ git tag v0.2.1
301
+ git push origin v0.2.1
302
+ ```
303
+
304
+ 工作流依次做三件事:
305
+
306
+ 1. 校验 tag 与包内 `__version__` 一致(不一致直接失败,避免发错版本);
307
+ 2. `python -m build` + `twine check`,并在干净 venv 里
308
+ `pip install --no-deps dist/*.whl` 后跑 `qpi-cli --version` / `--help` 自检;
309
+ 3. 用 PyPI **Trusted Publishing(OIDC)** 上传,无需在仓库里存 API token。
310
+
311
+ 首次发布前需在 PyPI 配置一次性授权(<https://pypi.org/manage/account/publishing/>
312
+ 的 "pending publisher",项目已存在则在 Project → Publishing 里加):
313
+
314
+ | 字段 | 值 |
315
+ |------|-----|
316
+ | PyPI Project Name | `qpi-cli` |
317
+ | Owner | GitHub 账号或组织(例如 `james-liu18`) |
318
+ | Repository name | `qpi-cli` |
319
+ | Workflow name | `release.yml` |
320
+ | Environment name | `pypi` |
321
+
322
+ 也支持手动触发(Actions → release → Run workflow):只构建与自检,不会上传。
323
+
291
324
  ---
292
325
 
293
326
  ## 11. 常见问题
@@ -1,27 +1,3 @@
1
- Metadata-Version: 2.1
2
- Name: qpi-cli
3
- Version: 0.2.0
4
- Summary: QuecPi QCS6490 (PI H1) Yocto Linux SDK 命令行工具 (构建 / 打包 / 烧录)
5
- Author: Quectel Pi
6
- License: MIT
7
- Project-URL: Homepage, https://github.com/Quectel-Pi/Pi-H1-Linux-SDK
8
- Keywords: quectel,quecpi,qpi,qcs6490,yocto,sdk,bitbake,cli
9
- Classifier: Development Status :: 4 - Beta
10
- Classifier: Environment :: Console
11
- Classifier: Intended Audience :: Developers
12
- Classifier: License :: OSI Approved :: MIT License
13
- Classifier: Operating System :: POSIX :: Linux
14
- Classifier: Programming Language :: Python :: 3
15
- Classifier: Programming Language :: Python :: 3.8
16
- Classifier: Programming Language :: Python :: 3.9
17
- Classifier: Programming Language :: Python :: 3.10
18
- Classifier: Programming Language :: Python :: 3.11
19
- Classifier: Programming Language :: Python :: 3.12
20
- Classifier: Topic :: Software Development :: Build Tools
21
- Requires-Python: >=3.8
22
- Description-Content-Type: text/markdown
23
- License-File: LICENSE
24
-
25
1
  # qpi-cli 用户使用手册
26
2
 
27
3
  **适用平台:** Linux 宿主(Ubuntu 22.04 LTS 为 SDK 验证环境)
@@ -269,7 +245,7 @@ FLASH_ENTRY=scripts/flash.sh
269
245
  ## 10. 从源码安装与发布
270
246
 
271
247
  ```bash
272
- git clone <本仓库>
248
+ git clone https://github.com/james-liu18/qpi-cli.git
273
249
  cd qpi-cli
274
250
 
275
251
  # 本地开发安装(可编辑)
@@ -288,6 +264,36 @@ twine upload dist/*
288
264
  版本号唯一来源是 `src/qpi_cli/__init__.py` 中的 `__version__`,
289
265
  `pyproject.toml` 通过 `dynamic = ["version"]` 自动读取,无需两处同步。
290
266
 
267
+ ### 自动发布(GitHub Actions)
268
+
269
+ 仓库内的 `.github/workflows/release.yml` 实现打 tag 自动发布:
270
+
271
+ ```bash
272
+ # 发布 0.2.1:先把 __version__ 改成 0.2.1 并提交,再打 tag
273
+ git tag v0.2.1
274
+ git push origin v0.2.1
275
+ ```
276
+
277
+ 工作流依次做三件事:
278
+
279
+ 1. 校验 tag 与包内 `__version__` 一致(不一致直接失败,避免发错版本);
280
+ 2. `python -m build` + `twine check`,并在干净 venv 里
281
+ `pip install --no-deps dist/*.whl` 后跑 `qpi-cli --version` / `--help` 自检;
282
+ 3. 用 PyPI **Trusted Publishing(OIDC)** 上传,无需在仓库里存 API token。
283
+
284
+ 首次发布前需在 PyPI 配置一次性授权(<https://pypi.org/manage/account/publishing/>
285
+ 的 "pending publisher",项目已存在则在 Project → Publishing 里加):
286
+
287
+ | 字段 | 值 |
288
+ |------|-----|
289
+ | PyPI Project Name | `qpi-cli` |
290
+ | Owner | GitHub 账号或组织(例如 `james-liu18`) |
291
+ | Repository name | `qpi-cli` |
292
+ | Workflow name | `release.yml` |
293
+ | Environment name | `pypi` |
294
+
295
+ 也支持手动触发(Actions → release → Run workflow):只构建与自检,不会上传。
296
+
291
297
  ---
292
298
 
293
299
  ## 11. 常见问题
@@ -27,7 +27,10 @@ classifiers = [
27
27
  ]
28
28
 
29
29
  [project.urls]
30
- Homepage = "https://github.com/Quectel-Pi/Pi-H1-Linux-SDK"
30
+ Homepage = "https://github.com/james-liu18/qpi-cli"
31
+ Repository = "https://github.com/james-liu18/qpi-cli"
32
+ "Bug Tracker" = "https://github.com/james-liu18/qpi-cli/issues"
33
+ "SDK (Pi-H1-Linux-SDK)" = "https://github.com/Quectel-Pi/Pi-H1-Linux-SDK"
31
34
 
32
35
  [project.scripts]
33
36
  qpi-cli = "qpi_cli.cli:main"
@@ -8,7 +8,7 @@
8
8
  只依赖 Python 3 标准库, 不引入任何第三方包。
9
9
  """
10
10
 
11
- __version__ = "0.2.0"
11
+ __version__ = "0.2.1"
12
12
  CLI_NAME = "qpi-cli"
13
13
 
14
14
  __all__ = ["__version__", "CLI_NAME", "main"]
@@ -1,3 +1,30 @@
1
+ Metadata-Version: 2.1
2
+ Name: qpi-cli
3
+ Version: 0.2.1
4
+ Summary: QuecPi QCS6490 (PI H1) Yocto Linux SDK 命令行工具 (构建 / 打包 / 烧录)
5
+ Author: Quectel Pi
6
+ License: MIT
7
+ Project-URL: Homepage, https://github.com/james-liu18/qpi-cli
8
+ Project-URL: Repository, https://github.com/james-liu18/qpi-cli
9
+ Project-URL: Bug Tracker, https://github.com/james-liu18/qpi-cli/issues
10
+ Project-URL: SDK (Pi-H1-Linux-SDK), https://github.com/Quectel-Pi/Pi-H1-Linux-SDK
11
+ Keywords: quectel,quecpi,qpi,qcs6490,yocto,sdk,bitbake,cli
12
+ Classifier: Development Status :: 4 - Beta
13
+ Classifier: Environment :: Console
14
+ Classifier: Intended Audience :: Developers
15
+ Classifier: License :: OSI Approved :: MIT License
16
+ Classifier: Operating System :: POSIX :: Linux
17
+ Classifier: Programming Language :: Python :: 3
18
+ Classifier: Programming Language :: Python :: 3.8
19
+ Classifier: Programming Language :: Python :: 3.9
20
+ Classifier: Programming Language :: Python :: 3.10
21
+ Classifier: Programming Language :: Python :: 3.11
22
+ Classifier: Programming Language :: Python :: 3.12
23
+ Classifier: Topic :: Software Development :: Build Tools
24
+ Requires-Python: >=3.8
25
+ Description-Content-Type: text/markdown
26
+ License-File: LICENSE
27
+
1
28
  # qpi-cli 用户使用手册
2
29
 
3
30
  **适用平台:** Linux 宿主(Ubuntu 22.04 LTS 为 SDK 验证环境)
@@ -245,7 +272,7 @@ FLASH_ENTRY=scripts/flash.sh
245
272
  ## 10. 从源码安装与发布
246
273
 
247
274
  ```bash
248
- git clone <本仓库>
275
+ git clone https://github.com/james-liu18/qpi-cli.git
249
276
  cd qpi-cli
250
277
 
251
278
  # 本地开发安装(可编辑)
@@ -264,6 +291,36 @@ twine upload dist/*
264
291
  版本号唯一来源是 `src/qpi_cli/__init__.py` 中的 `__version__`,
265
292
  `pyproject.toml` 通过 `dynamic = ["version"]` 自动读取,无需两处同步。
266
293
 
294
+ ### 自动发布(GitHub Actions)
295
+
296
+ 仓库内的 `.github/workflows/release.yml` 实现打 tag 自动发布:
297
+
298
+ ```bash
299
+ # 发布 0.2.1:先把 __version__ 改成 0.2.1 并提交,再打 tag
300
+ git tag v0.2.1
301
+ git push origin v0.2.1
302
+ ```
303
+
304
+ 工作流依次做三件事:
305
+
306
+ 1. 校验 tag 与包内 `__version__` 一致(不一致直接失败,避免发错版本);
307
+ 2. `python -m build` + `twine check`,并在干净 venv 里
308
+ `pip install --no-deps dist/*.whl` 后跑 `qpi-cli --version` / `--help` 自检;
309
+ 3. 用 PyPI **Trusted Publishing(OIDC)** 上传,无需在仓库里存 API token。
310
+
311
+ 首次发布前需在 PyPI 配置一次性授权(<https://pypi.org/manage/account/publishing/>
312
+ 的 "pending publisher",项目已存在则在 Project → Publishing 里加):
313
+
314
+ | 字段 | 值 |
315
+ |------|-----|
316
+ | PyPI Project Name | `qpi-cli` |
317
+ | Owner | GitHub 账号或组织(例如 `james-liu18`) |
318
+ | Repository name | `qpi-cli` |
319
+ | Workflow name | `release.yml` |
320
+ | Environment name | `pypi` |
321
+
322
+ 也支持手动触发(Actions → release → Run workflow):只构建与自检,不会上传。
323
+
267
324
  ---
268
325
 
269
326
  ## 11. 常见问题
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes