excel-codegen 0.9.0__tar.gz → 0.9.1__tar.gz

{excel_codegen-0.9.0 → excel_codegen-0.9.1}/CHANGELOG.md

@@ -4,11 +4,30 @@
 0.3.0 加公式模式 → 0.4.0 补齐公式模式的验证链 → 0.5.0 派生参数 → 0.5.x 跨平台与文档 →
 0.6.0 取值约束 / `extends` / 行内 `{% if %}` / 质量护栏 → 0.7.0 校验与复用补齐 →
 0.8.0 行列风格 / 成员表落地 / NASTRAN 工况控制 → 0.8.1 环境体检（`setup.sh`）→
-0.9.0 内置示例随包发布（`excel-codegen examples`）。逐条实测证据见
+0.9.0 内置示例随包发布（`excel-codegen examples`）→ 0.9.1 文档修正。逐条实测证据见
 [`abs_fpi/FINDINGS.md`](abs_fpi/FINDINGS.md)。
 
 ---
 
+## 0.9.1 — 文档修正：PyPI 项目描述（2026-09-30）
+
+**纯文档，工具行为无变化。**
+
+0.9.0 是本项目首个 PyPI 版本，但它的项目描述取自**打包那一刻的 README**，而那版 README
+还写着"PyPI 发布流程已就绪、**尚未首次发布**" —— 在一本已经发布的页面上自相矛盾。
+PyPI 的项目描述不能事后编辑，只能发新版本覆盖，于是有了这个补丁版。
+
+* README「安装」拆成两路：**只是要用**（`uv tool install` / `pipx install` /
+  `pip install excel-codegen`）与**改工具本身**（克隆 + `pip install -e ".[dev]"`），
+  并注记当前版本；
+* [`docs/publishing.md`](docs/publishing.md) 记下首次发布已完成，并新增
+  **「排错：`invalid-publisher`」**：含义（OIDC token 有效，但 PyPI 上没有对得上的
+  publisher；**一个字节都没上传，版本没被烧**）、对着日志里的 OIDC claims 逐字核对的
+  5 个字段、两个最常见的错法（Workflow name 写成 `.github/workflows/release.yml`、
+  Environment name 留空），以及改完怎么重发（`rerun-failed-jobs`，或删 tag 重推）。
+
+---
+
 ## 0.9.0 — 内置示例随包发布 + `excel-codegen examples`（2026-09-30）
 
 这一版把"干过真活的用例"变成**软件自带的东西**：装了 pip 包、没克隆仓库的人也能直接跑。
@@ -88,6 +107,16 @@ sdist 解包后 `pytest` 全过；`abs_fpi/build.py --check` 公式求值 28 项
 三个工作簿 `check` 全过；探针 A–H / G / N 全部通过；
 净 venv 只装 wheel 后 `examples --copy` / `check` / `render` / `init` / `*_render.sh` 全走通。
 
+### 已发布
+
+**0.9.0 是本项目首个 PyPI 版本**（tag `v0.9.0` → `release.yml` → Trusted Publishing，
+仓库里不存任何 token）：<https://pypi.org/project/excel-codegen/0.9.0/>
+
+发布后做了一次**从 PyPI 装**的闭环验证（不是从本地 dist）：干净 venv 里
+`pip install excel-codegen` → `examples --copy` → 对随包发布的 `abs_fpi_internal.xlsx`
+跑 `check`（OK）→ `render --outdir` 导出 → `init` 生成新工作簿；
+`uv tool install excel-codegen` 同样通过。
+
 ---
 
 ## 0.8.1 — 坏掉的旧 venv 必须在装依赖之前被拦住（2026-09-30）

{excel_codegen-0.9.0 → excel_codegen-0.9.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: excel_codegen
-Version: 0.9.0
+Version: 0.9.1
 Summary: Excel 模板参数填写 + Jinja2 代码生成器（支持 Prefix/Value/Suffix 组合）
 Author: JG. Luo
 License-Expression: MIT
@@ -142,6 +142,19 @@ excel-codegen render -c examples/basic/example_formula.yaml \
 
 需要 **Python 3.11+**（Windows / Linux / macOS 均可）。
 
+**只是要用它**（不克隆仓库）：
+
+```bash
+uv tool install excel-codegen        # 推荐
+pipx install excel-codegen           # 或
+pip install excel-codegen            # 或
+```
+
+装好后得到命令 `excel-codegen`（也可用 `python -m excel_codegen`），
+`excel-codegen examples --copy ./examples` 就能拿到带工作簿的示例。
+
+**改这个工具本身**（开发）：
+
 ```bash
 # 推荐：uv —— 不用建 venv、不用 pip、不用管本机 Python 版本
 curl -LsSf https://astral.sh/uv/install.sh | sh     # Windows 见 docs/setup.md
@@ -151,11 +164,10 @@ python3 -m venv ~/.venvs/excel_codegen && source ~/.venvs/excel_codegen/bin/acti
 pip install -e ".[dev]"
 ```
 
-装好后得到命令 `excel-codegen`（也可用 `python -m excel_codegen`）。
 跨平台细节、外置盘注意事项与 Python 版本策略见 [`docs/setup.md`](docs/setup.md)。
 
-> **PyPI 发布流程已就绪、尚未首次发布**（[`docs/publishing.md`](docs/publishing.md) 里有一次性登记步骤）。
-> 发布之后就可以不克隆仓库、直接 `uv tool install excel-codegen`（或 `pipx install excel-codegen`）。
+> **已发布到 PyPI**：当前版本 **0.9.1**（[PyPI 页面](https://pypi.org/project/excel-codegen/)）。
+> 之后的发版流程（Trusted Publishing，仓库里不存 token）见 [`docs/publishing.md`](docs/publishing.md)。
 
 ## 开发
 

{excel_codegen-0.9.0 → excel_codegen-0.9.1}/README.md

@@ -109,6 +109,19 @@ excel-codegen render -c examples/basic/example_formula.yaml \
 
 需要 **Python 3.11+**（Windows / Linux / macOS 均可）。
 
+**只是要用它**（不克隆仓库）：
+
+```bash
+uv tool install excel-codegen        # 推荐
+pipx install excel-codegen           # 或
+pip install excel-codegen            # 或
+```
+
+装好后得到命令 `excel-codegen`（也可用 `python -m excel_codegen`），
+`excel-codegen examples --copy ./examples` 就能拿到带工作簿的示例。
+
+**改这个工具本身**（开发）：
+
 ```bash
 # 推荐：uv —— 不用建 venv、不用 pip、不用管本机 Python 版本
 curl -LsSf https://astral.sh/uv/install.sh | sh     # Windows 见 docs/setup.md
@@ -118,11 +131,10 @@ python3 -m venv ~/.venvs/excel_codegen && source ~/.venvs/excel_codegen/bin/acti
 pip install -e ".[dev]"
 ```
 
-装好后得到命令 `excel-codegen`（也可用 `python -m excel_codegen`）。
 跨平台细节、外置盘注意事项与 Python 版本策略见 [`docs/setup.md`](docs/setup.md)。
 
-> **PyPI 发布流程已就绪、尚未首次发布**（[`docs/publishing.md`](docs/publishing.md) 里有一次性登记步骤）。
-> 发布之后就可以不克隆仓库、直接 `uv tool install excel-codegen`（或 `pipx install excel-codegen`）。
+> **已发布到 PyPI**：当前版本 **0.9.1**（[PyPI 页面](https://pypi.org/project/excel-codegen/)）。
+> 之后的发版流程（Trusted Publishing，仓库里不存 token）见 [`docs/publishing.md`](docs/publishing.md)。
 
 ## 开发
 

{excel_codegen-0.9.0 → excel_codegen-0.9.1}/docs/publishing.md

@@ -79,6 +79,9 @@ git push -u origin main
 用 **Trusted Publishing（OIDC）** —— 仓库里不存任何 token，GitHub 每次发布时向 PyPI
 换一张短期凭据。
 
+> ✅ **首次发布已完成**：`v0.9.0` → <https://pypi.org/project/excel-codegen/0.9.0/>
+> 下面的一次性配置留档，之后每次发版直接跳到「每次发版」。
+
 ### 一次性配置（只在第一次做）
 
 1. **注册 PyPI 账号**并开启两步验证（发版必需）。
@@ -94,7 +97,6 @@ git push -u origin main
 
    > 项目名写成 `excel-codegen`（连字符）是因为**分发的名字**与**导入的名字**可以不同：
    > `pip install excel-codegen` 装进来的是 `import excel_codegen`。
-   > 已确认 PyPI 上 `excel-codegen` 与 `excel_codegen` 都还没被占用。
 3. GitHub 仓库 → Settings → Environments → 新建一个叫 **`pypi`** 的环境
    （可以顺手加 "Required reviewers"，发版前多一道人工确认）。
 4. 确认 `pyproject.toml` 的 `[project.urls]` 都是真地址（占位符在 PyPI 页面上会变成
@@ -134,4 +136,42 @@ pipx install excel-codegen
 pip install excel-codegen
 ```
 
+> 装完 `excel-codegen examples --copy ./examples` 就能拿到带工作簿的内置示例。
+
+---
+
+### 排错：`invalid-publisher`
+
+```
+Trusted publishing exchange failure:
+* `invalid-publisher`: valid token, but no corresponding publisher
+```
+
+**含义**：OIDC token 本身没问题（签名有效），只是 PyPI 上**没有能对上的 (pending) publisher**。
+**一个字节都没上传**，所以版本号没有被烧掉 —— 改完直接重跑即可。
+
+对着日志里渲染出来的 claims 逐字核对 PyPI 表单（下面是 `v0.9.0` 的实际值）：
+
+| 日志里的 claim | PyPI 表单字段 | 实际值 |
+| --- | --- | --- |
+| `repository_owner` | Owner | `Dog-Chest` |
+| `repository` | Repository name | `excel_codegen`（**下划线**） |
+| `workflow_ref` 的文件名 | Workflow name | `release.yml`（**只写文件名**，别写路径） |
+| `environment` | Environment name | `pypi`（**留空就对不上**） |
+| 发行包 METADATA 的 `Name` | PyPI Project Name | `excel_codegen` → 归一化成 `excel-codegen` |
+
+最常见的两个错：**Workflow name 写成 `.github/workflows/release.yml`**、
+**Environment name 留空**（workflow 里用的是 `pypi`）。
+另外确认加的是 **pypi.org 生产站**的 pending publisher，不是 TestPyPI 的。
+
+**改完怎么重发**（不用重新走一遍 build）：
+
+1. 首选：Actions 页面打开上次失败的 run → **Re-run failed jobs**
+   （用 API 则是 `POST /repos/{owner}/{repo}/actions/runs/{id}/rerun-failed-jobs`，
+   需要 `actions: write` 权限的 token）；
+2. 没有那个权限时：**删掉 tag 再重推**，同样安全（版本没烧）：
+   ```bash
+   git push origin --delete v0.9.0 && git push origin v0.9.0
+   ```
+
 这样同事就不需要克隆仓库了 —— 「多平台零配置」这条线到此才算闭环。

{excel_codegen-0.9.0 → excel_codegen-0.9.1}/docs/template_guide.md

@@ -776,6 +776,7 @@ Prefix/Suffix 是按变量（不是按 Case）生效的。见 4.4：再加一个
 | **0.8.0** | **行列风格 `excel.local_direction`**：Local 表可切成“一行一个工况”（见 §19）；公式模式与求值器支持二维 `INDEX` / 行区间 `MATCH`；**`filename` 里可用任意参数**；abs_fpi 舱数据改用成员表；新增 NASTRAN 工况控制用例（§20） |
 | 0.8.1 | 只动开发环境脚本 `setup.sh` 与测试：复用旧 venv 之前先体检（解释器版本 / `site-packages` / `pip`），拦住在换过 Python 后"能执行却什么也 import 不到"的坏环境（见 `docs/setup.md`）。**工具行为无变化** |
 | **0.9.0** | **内置示例随包发布 + 新增 `excel-codegen examples`**：`basic` / `nastran` / `abs_fpi` 三个示例（含已填好样例参数的工作簿）进 wheel 与 sdist，`--copy DIR` 一键拷出 —— 装了 pip 包、没克隆仓库的人也能用（见 [`excel_codegen/examples/README.md`](../excel_codegen/examples/README.md)）；`docs/setup.md` 补 Windows 用法。另修一个真 bug：**`setup.sh` 在 macOS（bash 3.2）上第一屏就 `unbound variable` 退出** —— `$VAR` 紧邻中文要写成 `${VAR}` |
+| 0.9.1 | 纯文档：0.9.0 的 PyPI 项目描述取自打包时的 README，上面还写着"尚未首次发布"，发这个补丁版覆盖；README「安装」拆成"只是要用 / 改工具本身"两路；`docs/publishing.md` 记下首次发布并新增 `invalid-publisher` 排错。**工具行为无变化** |
 
 ---
 

{excel_codegen-0.9.0 → excel_codegen-0.9.1}/excel_codegen/__init__.py

@@ -92,7 +92,7 @@ from .utils import (
     to_text,
 )
 
-__version__ = "0.9.0"
+__version__ = "0.9.1"
 
 __all__ = [
     "FIRST_CASE_COLUMN",

{excel_codegen-0.9.0 → excel_codegen-0.9.1}/excel_codegen.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: excel_codegen
-Version: 0.9.0
+Version: 0.9.1
 Summary: Excel 模板参数填写 + Jinja2 代码生成器（支持 Prefix/Value/Suffix 组合）
 Author: JG. Luo
 License-Expression: MIT
@@ -142,6 +142,19 @@ excel-codegen render -c examples/basic/example_formula.yaml \
 
 需要 **Python 3.11+**（Windows / Linux / macOS 均可）。
 
+**只是要用它**（不克隆仓库）：
+
+```bash
+uv tool install excel-codegen        # 推荐
+pipx install excel-codegen           # 或
+pip install excel-codegen            # 或
+```
+
+装好后得到命令 `excel-codegen`（也可用 `python -m excel_codegen`），
+`excel-codegen examples --copy ./examples` 就能拿到带工作簿的示例。
+
+**改这个工具本身**（开发）：
+
 ```bash
 # 推荐：uv —— 不用建 venv、不用 pip、不用管本机 Python 版本
 curl -LsSf https://astral.sh/uv/install.sh | sh     # Windows 见 docs/setup.md
@@ -151,11 +164,10 @@ python3 -m venv ~/.venvs/excel_codegen && source ~/.venvs/excel_codegen/bin/acti
 pip install -e ".[dev]"
 ```
 
-装好后得到命令 `excel-codegen`（也可用 `python -m excel_codegen`）。
 跨平台细节、外置盘注意事项与 Python 版本策略见 [`docs/setup.md`](docs/setup.md)。
 
-> **PyPI 发布流程已就绪、尚未首次发布**（[`docs/publishing.md`](docs/publishing.md) 里有一次性登记步骤）。
-> 发布之后就可以不克隆仓库、直接 `uv tool install excel-codegen`（或 `pipx install excel-codegen`）。
+> **已发布到 PyPI**：当前版本 **0.9.1**（[PyPI 页面](https://pypi.org/project/excel-codegen/)）。
+> 之后的发版流程（Trusted Publishing，仓库里不存 token）见 [`docs/publishing.md`](docs/publishing.md)。
 
 ## 开发
 

{excel_codegen-0.9.0 → excel_codegen-0.9.1}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "excel_codegen"
-version = "0.9.0"
+version = "0.9.1"
 description = "Excel 模板参数填写 + Jinja2 代码生成器（支持 Prefix/Value/Suffix 组合）"
 readme = "README.md"
 # 支持下限 = **CI 真正测过的最老版本**（见 .github/workflows/ci.yml）。

{excel_codegen-0.9.0 → excel_codegen-0.9.1}/uv.lock

@@ -227,7 +227,7 @@ wheels = [
 
 [[package]]
 name = "excel-codegen"
-version = "0.9.0"
+version = "0.9.1"
 source = { editable = "." }
 dependencies = [
     { name = "jinja2" },