betaquant 0.5.3__tar.gz

betaquant-0.5.3/.gitea/builder/Dockerfile

@@ -0,0 +1,121 @@
+# syntax=docker/dockerfile:1.7
+#
+# py-alpha-lib 构建环境
+# ----------------------------------------------------------------------------
+# 一切都烤进镜像：工具链 + cargo 依赖 + MSVC CRT/SDK。
+# CI 不挂任何 volume，跑起来就是镜像内自带的状态，没有 docker-in-docker
+# 的挂卷路径解析坑。
+#
+# 镜像内置：
+#   - Python 3.11
+#   - Rust stable + 三个 target (linux-gnu / linux-musl / windows-msvc)
+#   - sccache（编译缓存）
+#   - cargo-xwin + 预下载好的 MSVC CRT/SDK（写入 /opt/xwin/xwin/DONE）
+#   - maturin[zig] + twine
+#   - llvm / clang / lld（提供 llvm-dlltool / llvm-lib / lld-link / clang-cl）
+#   - Node.js 20（Gitea Actions / act 跑 actions/checkout 必需）
+#
+# 合规提示：
+#   镜像里包含 Microsoft VC++ Build Tools 和 Windows SDK 文件，许可证见
+#       https://go.microsoft.com/fwlink/?LinkId=2086102
+#   按 EULA 这些文件不得再分发到第三方。**只能推到对内可信的 registry**
+#   （内网 Gitea / Harbor），不要推到 Docker Hub 等公网仓库。
+# ----------------------------------------------------------------------------
+
+FROM python:3.11-slim-bookworm
+
+LABEL org.opencontainers.image.title="py-alpha-lib builder" \
+      org.opencontainers.image.description="Pre-baked toolchain for building py-alpha-lib wheels (manylinux/musllinux/win_amd64) + sdist"
+
+ENV DEBIAN_FRONTEND=noninteractive \
+    LANG=C.UTF-8 \
+    LC_ALL=C.UTF-8 \
+    PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1
+
+ENV RUSTUP_HOME=/usr/local/rustup \
+    CARGO_HOME=/usr/local/cargo \
+    PATH=/usr/local/cargo/bin:$PATH \
+    CARGO_INCREMENTAL=0 \
+    RUSTC_WRAPPER=sccache \
+    SCCACHE_DIR=/opt/sccache \
+    SCCACHE_CACHE_SIZE=2G \
+    XWIN_CACHE_DIR=/opt/xwin \
+    XWIN_ACCEPT_LICENSE=1 \
+    RUSTFLAGS="-C target-feature=+sse4.2 -C target-feature=+avx2 -C target-feature=+pclmulqdq"
+
+# ---- 系统依赖 + LLVM 工具链（cargo-xwin 需要 llvm-dlltool / lld-link 等） ----
+RUN apt-get update \
+ && apt-get install -y --no-install-recommends \
+        build-essential \
+        ca-certificates \
+        curl \
+        git \
+        gnupg \
+        pkg-config \
+        xz-utils \
+        llvm \
+        clang \
+        lld \
+ && rm -rf /var/lib/apt/lists/*
+
+# ---- Node.js（actions/checkout@v4 等 JS action 必需） ----
+ARG NODE_MAJOR=20
+RUN set -eux; \
+    curl -fsSL "https://deb.nodesource.com/setup_${NODE_MAJOR}.x" | bash -; \
+    apt-get install -y --no-install-recommends nodejs; \
+    rm -rf /var/lib/apt/lists/*; \
+    node --version; \
+    npm --version
+
+# ---- Rust stable + 三个 target ----
+ARG RUST_TOOLCHAIN=stable
+RUN curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs \
+      | sh -s -- -y --default-toolchain "${RUST_TOOLCHAIN}" --profile minimal --no-modify-path \
+ && rustup target add x86_64-unknown-linux-gnu \
+ && rustup target add x86_64-unknown-linux-musl \
+ && rustup target add x86_64-pc-windows-msvc \
+ && rustc --version
+
+# ---- sccache（mozilla 官方静态二进制） ----
+ARG SCCACHE_VERSION=v0.10.0
+RUN set -eux; \
+    curl -fL -o /tmp/sccache.tgz \
+        "https://github.com/mozilla/sccache/releases/download/${SCCACHE_VERSION}/sccache-${SCCACHE_VERSION}-x86_64-unknown-linux-musl.tar.gz"; \
+    tar -xzf /tmp/sccache.tgz -C /tmp; \
+    install -m 0755 \
+        "/tmp/sccache-${SCCACHE_VERSION}-x86_64-unknown-linux-musl/sccache" \
+        /usr/local/cargo/bin/sccache; \
+    rm -rf /tmp/sccache*; \
+    sccache --version
+
+# ---- maturin (含 zig) + twine ----
+RUN python -m pip install --no-cache-dir --upgrade pip \
+ && python -m pip install --no-cache-dir \
+        "maturin[zig]>=1.10,<2.0" \
+        twine \
+ && maturin --version \
+ && twine --version
+
+# ---- cargo-xwin（windows-msvc 交叉编译驱动） ----
+RUN cargo install --locked cargo-xwin --root /usr/local/cargo \
+ && ls -l /usr/local/cargo/bin/cargo-xwin
+
+# ---- 预下载并解包 MSVC CRT + Windows SDK 到 /opt/xwin/xwin/ ----
+# cargo-xwin 命中缓存的关键文件是 $XWIN_CACHE_DIR/xwin/DONE。
+# 直接把它写到镜像里 /opt/xwin，CI 不挂卷直接命中。
+#
+# 重要：cargo-xwin 命中缓存要求“请求架构 ⊆ DONE 中已下载架构”。
+# 这里只 splat x86_64，所以 CI 调用 cargo-xwin 时也必须强制
+# XWIN_ARCH=x86_64（默认是 [x86_64, aarch64]），否则会重新下载。
+# 这条 ENV 不在镜像里，而是在 publish.yml 的 job env 中设置，
+# 这样以后想换架构组合时只改一处即可，不需要重 build 镜像。
+RUN set -eux; \
+    mkdir -p /opt/xwin; \
+    cargo xwin cache xwin --xwin-arch x86_64; \
+    test -f /opt/xwin/xwin/DONE; \
+    du -sh /opt/xwin; \
+    ls /opt/xwin/xwin
+
+WORKDIR /work
+CMD ["bash"]

betaquant-0.5.3/.gitea/builder/README.md

@@ -0,0 +1,84 @@
+# py-alpha-lib builder image
+
+把原来 `publish.yml` 里每次 CI 都重装一遍的 Rust 工具链、sccache、cargo-xwin、
+maturin、twine、llvm 等全部烤进一个镜像，CI 只负责跑 `maturin build` 和
+`twine upload`，构建更快、流程更短、跨 workflow 也能复用。
+
+镜像内容见同目录 `Dockerfile`。
+
+## 一、构建并推送镜像
+
+在能访问 docker.io 的机器上一次性构建好，再推到你自建的 Gitea 容器仓库
+（或任意私有 registry）。下面以 `my-gitea` 上的命名空间 `infra` 为例：
+
+```bash
+cd .gitea/builder
+
+# 1) 构建（如需指定 rust 版本可加 --build-arg RUST_TOOLCHAIN=1.82.0）
+docker build -t my-gitea/infra/py-alpha-builder:latest .
+
+# 2) 登录并推送
+docker login my-gitea
+docker push my-gitea/infra/py-alpha-builder:latest
+```
+
+> 如果暂时没有私有 registry，也可以直接在 act_runner 主机上 `docker build`
+> 出本地镜像，然后让 workflow 里 `container.image` 指向同名 tag，
+> 配合 `act_runner` 的 `pull: false`（或 `force_pull: false`）即可使用本地镜像。
+
+## 二、CI 中如何使用
+
+`publish.yml` 里把 `container.image` 换成这个镜像就行：
+
+```yaml
+container:
+  image: my-gitea/infra/py-alpha-builder:latest
+  options: --add-host=my-gitea:host-gateway
+  volumes:
+    # 真正“可变”的缓存仍然挂在宿主机，跨 workflow 复用
+    - /opt/act_cache/cargo-registry:/usr/local/cargo/registry
+    - /opt/act_cache/cargo-git:/usr/local/cargo/git
+    - /opt/act_cache/sccache:/opt/sccache
+    - /opt/act_cache/xwin:/opt/xwin
+    - /opt/act_cache/target:/work/target
+```
+
+宿主机一次性准备：
+
+```bash
+sudo mkdir -p \
+  /opt/act_cache/cargo-registry \
+  /opt/act_cache/cargo-git \
+  /opt/act_cache/sccache \
+  /opt/act_cache/xwin \
+  /opt/act_cache/target
+sudo chmod -R 0777 /opt/act_cache
+```
+
+并在 `act_runner` 的 `config.yaml` 里允许这些挂载：
+
+```yaml
+container:
+  valid_volumes:
+    - /opt/act_cache
+    - /opt/act_cache/*
+```
+
+## 三、本地手动验证镜像
+
+```bash
+docker run --rm -it \
+  -v "$PWD":/work \
+  -v /opt/act_cache/sccache:/opt/sccache \
+  -v /opt/act_cache/xwin:/opt/xwin \
+  my-gitea/infra/py-alpha-builder:latest bash -lc '
+    maturin build --release --out dist \
+      --target x86_64-unknown-linux-gnu --zig --compatibility manylinux_2_17 &&
+    maturin build --release --out dist \
+      --target x86_64-unknown-linux-musl --zig --compatibility musllinux_1_2 &&
+    maturin build --release --out dist \
+      --target x86_64-pc-windows-msvc &&
+    maturin sdist --out dist &&
+    ls -la dist
+  '
+```

betaquant-0.5.3/.gitea/workflows/publish.yml

@@ -0,0 +1,104 @@
+name: Publish
+
+# 在 Gitea Actions 上构建 Linux + Windows wheel + sdist，发布到公网 PyPI。
+# 包名：betalib。
+#
+# 工具链 + 所有缓存都烤进了 .gitea/builder/Dockerfile 对应的镜像里：
+#   - rustup / 三个 target / sccache / maturin[zig] / twine / llvm
+#   - cargo-xwin + 预下载的 MSVC CRT/SDK（DONE 标记已就位）
+#   - cargo install 时拉取的依赖
+#
+# 所以这里不挂任何 volume，CI 起来就是镜像里自带的状态，没有
+# docker-in-docker 挂卷路径解析问题；代价是 cargo target 增量编译
+# 不跨 workflow 复用，每次 release 全量编译一次（~1 分钟可接受）。
+#
+# 触发：
+#   - push v* tag
+#   - workflow_dispatch（只构建不发布）
+#
+# Secrets:
+#   PYPI_API_TOKEN   PyPI 项目级 API Token，前缀 "pypi-..."
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        # act/Gitea Actions 默认用 sh(dash) 跑 `run:`，dash 不认识
+        # `set -o pipefail`；强制 bash。镜像里有 bash。
+        shell: bash
+    env:
+      # 让 CI 容器里的 cargo-xwin 只请求 x86_64，匹配镜像里 DONE 标记
+      # 写入的架构（Dockerfile 里 cargo xwin cache xwin --xwin-arch x86_64）。
+      # 否则 cargo-xwin 默认 [x86_64,aarch64]，与 DONE 不一致 →
+      # 重新下载整套 MSVC CRT/SDK（约 40 分钟）。
+      XWIN_ARCH: x86_64
+    container:
+      # 由 .gitea/builder/Dockerfile 构建并推送，里面已经预装好工具链 + SDK。
+      image: my-gitea/infra/py-alpha-builder:latest
+      options: --add-host=my-gitea:host-gateway
+
+    steps:
+      - uses: https://gitea.com/actions/checkout@v4
+
+      - name: Toolchain sanity check
+        run: |
+          set -euxo pipefail
+          python --version
+          rustc --version
+          cargo --version
+          sccache --version
+          cargo xwin --version || cargo-xwin --version
+          maturin --version
+          twine --version
+          which llvm-dlltool lld-link clang-cl || true
+          # 确认镜像内已有 MSVC CRT/SDK，跳过下载
+          test -f /opt/xwin/xwin/DONE && echo "✅ MSVC CRT/SDK ready" \
+                                     || echo "⚠️  cold xwin cache, will download"
+
+      - name: Build manylinux wheel
+        run: |
+          maturin build --release --out dist \
+            --target x86_64-unknown-linux-gnu \
+            --zig \
+            --compatibility manylinux_2_17 \
+            --interpreter "$(which python)"
+
+      - name: Build musllinux wheel
+        run: |
+          maturin build --release --out dist \
+            --target x86_64-unknown-linux-musl \
+            --zig \
+            --compatibility musllinux_1_2 \
+            --interpreter "$(which python)"
+
+      - name: Build Windows wheel (cargo-xwin, win_amd64 MSVC)
+        run: |
+          maturin build --release --out dist \
+            --target x86_64-pc-windows-msvc \
+            --interpreter "$(which python)"
+
+      - name: Build sdist
+        run: maturin sdist --out dist
+
+      - name: sccache stats
+        run: sccache --show-stats || true
+
+      - name: List built artifacts
+        run: ls -la dist
+
+      - name: Upload to PyPI
+        if: startsWith(github.ref, 'refs/tags/')
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+        run: python -m twine upload --verbose --non-interactive --skip-existing dist/*

betaquant-0.5.3/.gitignore

@@ -0,0 +1,82 @@
+/target
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+.pytest_cache/
+*.py[cod]
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+.venv/
+env/
+bin/
+build/
+develop-eggs/
+dist/
+eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+include/
+man/
+venv/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+pip-selfcheck.json
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.cache
+nosetests.xml
+coverage.xml
+
+# Translations
+*.mo
+
+# Mr Developer
+.mr.developer.cfg
+.project
+.pydevproject
+
+# Rope
+.ropeproject
+
+# Django stuff:
+*.log
+*.pot
+
+.DS_Store
+
+# Sphinx documentation
+docs/_build/
+
+# PyCharm
+.idea/
+
+# VSCode
+.vscode/
+
+# Pyenv
+.python-version
+
+uv.lock
+dataPerformance.*
+
+.cargo/
+
+# mid-build files
+al_alpha101.csv
+al_timing.csv
+comparison_results.csv

betaquant-0.5.3/CHANGELOG.md

@@ -0,0 +1,8 @@
+# ChangeLog
+
+## [0.3.9] - 2026-05-29
+
+### Added
+
+-  新分支，正式上线
+