fspack 0.2.2__tar.gz → 0.2.4__tar.gz

{fspack-0.2.2 → fspack-0.2.4}/.bumpversion.toml

@@ -1,5 +1,5 @@
 [tool.bumpversion]
-current_version = "0.2.2"
+current_version = "0.2.4"
 commit = true
 exclude = ["template/*"]
 message = "chore: 更新版本 {current_version} → {new_version}"

fspack-0.2.4/.github/workflows/release.yml

@@ -0,0 +1,232 @@
+name: Release
+
+# 触发：push v*.*.* tag
+#
+# 三个并行 job：
+#   - pypi        : uv build → uv publish（OIDC）→ 上传 sdist/wheel artifact
+#   - pack-windows: windows-latest 原生打包 fspack 自身（mingw + NSIS）
+#   - pack-linux   : ubuntu-latest  原生打包 fspack 自身（gcc + dpkg-dev）
+#
+# release job 依赖以上三个 job，收集构建产物（exe/deb/tar.gz/zip）+
+# PyPI 产物（whl/sdist），统一上传到 GitHub Release。
+# 任一前置 job 失败时 release 仍尝试发布已成功产物，但最终标记 workflow 失败。
+
+on:
+  push:
+    tags: ['v*.*.*']
+
+permissions:
+  contents: write
+  id-token: write
+
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  # ===== PyPI 发布 =====
+  pypi:
+    name: Build & Publish PyPI
+    runs-on: ubuntu-latest
+    environment: pypi
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.3.2
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Build distributions
+        run: uv build
+
+      - name: Publish to PyPI (OIDC)
+        run: uv publish
+
+      - name: Upload sdist & wheel artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: pypi-dist
+          path: dist/*
+          retention-days: 7
+          if-no-files-found: error
+
+  # ===== Windows 原生打包（用 fspack 打包 fspack 自身）=====
+  pack-windows:
+    name: Pack (Windows native)
+    runs-on: windows-latest
+    timeout-minutes: 25
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.3.2
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      # windows-2025 镜像移除了 NSIS；mingw-w64 提供 x86_64-w64-mingw32-gcc 前缀的交叉编译器
+      - name: Install NSIS & mingw-w64
+        run: |
+          choco install nsis mingw -y --no-progress
+          echo "C:\Program Files (x86)\NSIS" >> $GITHUB_PATH
+          echo "C:\Program Files\mingw-w64\mingw64\bin" >> $GITHUB_PATH
+
+      - name: Sync dependencies
+        run: uv sync --frozen
+
+      # fspack 的 download_wheels 用 `pip download` 拉 wheel，但 uv 管理的 venv 默认不含 pip，
+      # 且 CI runner 上 PATH 中可能没有带 pip 的系统 python，故显式安装 pip 到 venv。
+      - name: Install pip
+        run: uv pip install pip
+
+      - name: Cache fspack assets
+        uses: actions/cache@v4
+        with:
+          path: ~/.fspack/cache/
+          key: fspack-windows-${{ hashFiles('pyproject.toml') }}
+          restore-keys: |
+            fspack-windows-
+            fspack-
+
+      - name: Build fspack with fspack
+        run: uv run fspack b . --target windows
+
+      - name: Generate installer
+        run: uv run fspack p . --target windows --format all --no-build
+
+      - name: Smoke test (version)
+        run: ./dist/fspack.exe -V
+
+      - name: Assert artifacts
+        shell: bash
+        run: |
+          test -f dist/release/fspack-*-windows-*-setup.exe
+          test -f dist/release/fspack-*-windows-*.zip
+
+      - name: Upload failure artifacts
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: pack-windows-failure
+          path: dist/
+          retention-days: 3
+
+      - name: Upload release artifacts
+        if: success()
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-windows
+          path: dist/release/
+          retention-days: 7
+          if-no-files-found: error
+
+  # ===== Linux 原生打包（用 fspack 打包 fspack 自身）=====
+  pack-linux:
+    name: Pack (Linux native)
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.3.2
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Install toolchain
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y gcc dpkg-dev
+
+      - name: Sync dependencies
+        run: uv sync --frozen
+
+      # fspack 的 download_wheels 用 `pip download` 拉 wheel，但 uv 管理的 venv 默认不含 pip，
+      # 且 CI runner 上 PATH 中可能没有带 pip 的系统 python，故显式安装 pip 到 venv。
+      - name: Install pip
+        run: uv pip install pip
+
+      - name: Cache fspack assets
+        uses: actions/cache@v4
+        with:
+          path: ~/.fspack/cache/
+          key: fspack-linux-${{ hashFiles('pyproject.toml') }}
+          restore-keys: |
+            fspack-linux-
+            fspack-
+
+      - name: Build fspack with fspack
+        run: uv run fspack b . --target linux
+
+      - name: Generate installer
+        run: uv run fspack p . --target linux --format all --no-build
+
+      - name: Smoke test (version)
+        run: ./dist/fspack -V
+
+      - name: Assert artifacts
+        run: |
+          test -f dist/release/fspack-*-linux-*.tar.gz
+          test -f dist/release/fspack_*-slim_amd64.deb
+          test -f dist/release/fspack-*-linux-*.zip
+
+      - name: Upload failure artifacts
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: pack-linux-failure
+          path: dist/
+          retention-days: 3
+
+      - name: Upload release artifacts
+        if: success()
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-linux
+          path: dist/release/
+          retention-days: 7
+          if-no-files-found: error
+
+  # ===== 收集产物并上传到 GitHub Release =====
+  release:
+    name: Upload to GitHub Release
+    needs: [pypi, pack-windows, pack-linux]
+    runs-on: ubuntu-latest
+    if: always() && !cancelled()
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: release-assets/
+
+      - name: Collect release files
+        run: |
+          mkdir -p release-files/
+          # 构建产物（exe/deb/tar.gz/zip）+ PyPI 产物（whl/sdist）
+          # sdist 也是 .tar.gz，但命名 fspack-<version>.tar.gz 不与 Linux 便携包冲突
+          find release-assets/ -type f \
+            \( -name "*.exe" -o -name "*.deb" -o -name "*.tar.gz" -o -name "*.zip" -o -name "*.whl" \) \
+            -exec cp {} release-files/ \;
+          echo "::group::Release files"
+          ls -la release-files/
+          echo "::endgroup::"
+
+      - name: Create GitHub Release & Upload
+        env:
+          GH_TOKEN: ${{ github.token }}
+          TAG_NAME: ${{ github.ref_name }}
+        run: |
+          gh release create "$TAG_NAME" \
+            --title "Release $TAG_NAME" \
+            --generate-notes \
+            release-files/*
+
+      - name: Report failure (if any upstream job failed)
+        if: contains(needs.pypi.result, 'failure') || contains(needs.pack-windows.result, 'failure') || contains(needs.pack-linux.result, 'failure')
+        run: |
+          echo "::error::部分 job 失败（pypi=${{ needs.pypi.result }} windows=${{ needs.pack-windows.result }} linux=${{ needs.pack-linux.result }}），已成功的产物已上传到 Release。"
+          exit 1

{fspack-0.2.2 → fspack-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fspack
-Version: 0.2.2
+Version: 0.2.4
 Summary: 极速 Python 项目打包器。
 Author-email: gooker_young <gooker_young@qq.com>
 License-Expression: MIT
@@ -258,6 +258,19 @@ fspack 可集成到其他 Python 项目的 CI/CD 工作流，实现自动打包
 - [`templates/pack-check.yml`](templates/pack-check.yml) — PR 验证打包（push/PR 触发，验证打包不破坏）
 - [`templates/release-pack.yml`](templates/release-pack.yml) — Release 发布安装包（tag 触发，矩阵打包 Windows + Linux 安装包附到 GitHub Release）
 
+### fspack 自身的发布流程
+
+fspack 自身通过 [.github/workflows/release.yml](.github/workflows/release.yml) 在 `git push v*.*.*` 时用**各平台原生 runner 打包自身**发布到 GitHub Release：
+
+| job | runner | 产物 |
+|-----|--------|------|
+| `pypi` | ubuntu-latest | sdist + wheel（uv build → uv publish）|
+| `pack-windows` | windows-latest | NSIS 安装包 `.exe` + 跨平台便携包 `.zip` |
+| `pack-linux` | ubuntu-latest | tar.gz 便携包 + `.deb` 安装包 + 跨平台便携包 `.zip` |
+| `release` | ubuntu-latest | 收集以上产物统一上传到 GitHub Release |
+
+原生平台打包使 pyc 预编译生效、loader 用本机 gcc/mingw 原生编译，避免交叉编译的 wine 不稳定。任一 job 失败时 `release` 仍尝试发布已成功产物，但最终标记 workflow 失败。
+
 ### 快速上手
 
 1. 复制模板到你的项目：

{fspack-0.2.2 → fspack-0.2.4}/README.md

@@ -210,6 +210,19 @@ fspack 可集成到其他 Python 项目的 CI/CD 工作流，实现自动打包
 - [`templates/pack-check.yml`](templates/pack-check.yml) — PR 验证打包（push/PR 触发，验证打包不破坏）
 - [`templates/release-pack.yml`](templates/release-pack.yml) — Release 发布安装包（tag 触发，矩阵打包 Windows + Linux 安装包附到 GitHub Release）
 
+### fspack 自身的发布流程
+
+fspack 自身通过 [.github/workflows/release.yml](.github/workflows/release.yml) 在 `git push v*.*.*` 时用**各平台原生 runner 打包自身**发布到 GitHub Release：
+
+| job | runner | 产物 |
+|-----|--------|------|
+| `pypi` | ubuntu-latest | sdist + wheel（uv build → uv publish）|
+| `pack-windows` | windows-latest | NSIS 安装包 `.exe` + 跨平台便携包 `.zip` |
+| `pack-linux` | ubuntu-latest | tar.gz 便携包 + `.deb` 安装包 + 跨平台便携包 `.zip` |
+| `release` | ubuntu-latest | 收集以上产物统一上传到 GitHub Release |
+
+原生平台打包使 pyc 预编译生效、loader 用本机 gcc/mingw 原生编译，避免交叉编译的 wine 不稳定。任一 job 失败时 `release` 仍尝试发布已成功产物，但最终标记 workflow 失败。
+
 ### 快速上手
 
 1. 复制模板到你的项目：

{fspack-0.2.2 → fspack-0.2.4}/docs/integration.md

@@ -3,6 +3,33 @@
 fspack 可集成到其他 Python 项目的 CI/CD 工作流，实现自动打包与打包成功验证。
 本文介绍三种集成模式、测试反馈机制，并提供可复用的 GitHub Actions workflow 模板。
 
+## fspack 自身的发布流程
+
+fspack 自身通过 [.github/workflows/release.yml](https://github.com/gookeryoung/fspack/blob/main/.github/workflows/release.yml)
+在 `git push v*.*.*` tag 时，用**各平台原生 runner 打包自身**发布到 GitHub Release：
+
+| job | runner | 工具链 | 产物 |
+|-----|--------|--------|------|
+| `pypi` | ubuntu-latest | uv | sdist + wheel（PyPI 发布） |
+| `pack-windows` | windows-latest | mingw-w64 + NSIS | NSIS 安装包 `.exe` + 跨平台便携包 `.zip` |
+| `pack-linux` | ubuntu-latest | gcc + dpkg-dev | tar.gz 便携包 + `.deb` 安装包 + 跨平台便携包 `.zip` |
+| `release` | ubuntu-latest | gh | 收集以上所有产物统一上传到 GitHub Release |
+
+**原生平台打包**而非 ubuntu 交叉编译的原因：
+
+- pyc 预编译仅在 `target is detect_platform()` 时执行（避免跨版本字节码不兼容）
+- loader 用本机 gcc/mingw 原生编译，无需 wine 兼容层
+- Windows Server 2025 runner 已移除 NSIS 预装，workflow 中显式 `choco install nsis mingw`
+
+任一前置 job 失败时 `release` job 仍尝试发布已成功产物（`if: always() && !cancelled()`），
+但最终通过 `Report failure` 步骤标记 workflow 失败，便于追踪问题。
+
+**工具链安装要点**：
+
+- Windows runner：`choco install nsis mingw -y` 安装 NSIS 与带 `x86_64-w64-mingw32-gcc` 前缀的 mingw-w64，
+  并将路径追加到 `$GITHUB_PATH`
+- Linux runner：`apt-get install -y gcc dpkg-dev`，gcc 与 dpkg-deb 均为标准包
+
 ## 集成架构
 
 ```text

{fspack-0.2.2 → fspack-0.2.4}/pyproject.toml

@@ -22,7 +22,7 @@ license         = "MIT"
 name            = "fspack"
 readme          = "README.md"
 requires-python = ">=3.8"
-version         = "0.2.2"
+version         = "0.2.4"
 
 [project.optional-dependencies]
 dev = [

{fspack-0.2.2 → fspack-0.2.4}/src/fspack/__init__.py

@@ -23,4 +23,4 @@ except (ImportError, AttributeError):  # pragma: no cover
 
 __all__ = ["__version__"]
 
-__version__ = "0.2.2"
+__version__ = "0.2.4"

{fspack-0.2.2 → fspack-0.2.4}/src/fspack/slim/__init__.py

@@ -24,14 +24,10 @@
 - :func:`classify_entry`：分类 wheel 条目归属
 - :class:`SlimSpec`：精简规则抽象基类
 - :func:`register_spec`/``get_spec``：注册表接口
-
-``zipfile`` 暴露在模块命名空间供外部 monkeypatch 使用。
 """
 
 from __future__ import annotations
 
-import zipfile  # noqa: F401  暴露在 fspack.slim 命名空间，供外部 monkeypatch 使用
-
 from fspack.slim.base import (
     SlimSpec,
     classify_entry,

{fspack-0.2.2 → fspack-0.2.4}/uv.lock

@@ -656,7 +656,7 @@ wheels = [
 
 [[package]]
 name = "fspack"
-version = "0.2.1"
+version = "0.2.3"
 source = { editable = "." }
 dependencies = [
     { name = "rich", version = "14.3.4", source = { registry = "https://mirrors.aliyun.com/pypi/simple/" }, marker = "python_full_version < '3.9'" },

fspack-0.2.2/.github/workflows/release.yml

@@ -1,44 +0,0 @@
-name: Release
-
-on:
-  push:
-    tags: ['v*.*.*']
-
-permissions:
-  contents: write
-  id-token: write
-
-concurrency:
-  group: release-${{ github.ref }}
-  cancel-in-progress: false
-
-jobs:
-  release:
-    name: Build & Publish
-    runs-on: ubuntu-latest
-    environment: pypi
-    timeout-minutes: 10
-    steps:
-      - uses: actions/checkout@v5
-
-      - name: Install uv
-        uses: astral-sh/setup-uv@v8.3.2
-        with:
-          enable-cache: true
-          cache-dependency-glob: "uv.lock"
-
-      - name: Build distributions
-        run: uv build
-
-      - name: Publish to PyPI (OIDC)
-        run: uv publish
-
-      - name: Create GitHub Release
-        env:
-          GH_TOKEN: ${{ github.token }}
-          TAG_NAME: ${{ github.ref_name }}
-        run: |
-          gh release create "$TAG_NAME" \
-            --title "Release $TAG_NAME" \
-            --generate-notes \
-            dist/*