bareduckdb 0.20.200__tar.gz

bareduckdb-0.20.200/.github/workflows/README_ACT.md

@@ -0,0 +1,70 @@
+# Running GitHub Actions Locally with nektos/act
+
+This guide explains how to run GitHub Actions workflows locally using [nektos/act](https://github.com/nektos/act), which allows you to test workflows before pushing to GitHub.
+
+## Prerequisites
+
+- Docker must be installed and running
+- Install the `act` binary, `curl --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/nektos/act/master/install.sh | sudo bash`
+
+## Quick Start
+
+### List Available Workflows
+
+```bash
+../act/bin/act --list
+```
+
+### Run the Dev Versions Workflow
+
+To run the complete dev_versions workflow:
+
+```bash
+../act/bin/act -W .github/workflows/dev_versions.yml --matrix python-version:3.15t --matrix os:ubuntu-latest -P  ubuntu-latest=catthehacker/ubuntu:act-24.04 --reuse
+```
+
+`--matrix` values have to exist in the workflow. `dev_versions.yml` currently defines
+`python-version` as `3.14` and `3.15t` only, across `ubuntu-latest`, `macos-latest` and
+`windows-latest`; `3.12` and `3.14t` are not in it. Re-read the matrix before copying a
+command from here.
+
+### 3. Run Specific Jobs
+
+`dev_versions.yml` has four jobs: `dev_versions`, `musl`, `graalpy` and `benchmarks`. The
+last two are calls into the reusable workflows `graalpy.yml` and `benchmarks.yml`, and all
+three are chained behind `dev_versions` with `needs:`. To run just the first:
+
+```bash
+../act/bin/act -W .github/workflows/dev_versions.yml --matrix python-version:3.14 -P  ubuntu-latest=catthehacker/ubuntu:act-latest -j dev_versions --artifact-server-path /tmp/artifacts --reuse
+```
+
+### Run the GraalPy job on its own
+
+`graalpy.yml` also accepts `workflow_dispatch`, so it runs standalone without the CPython
+matrix in front of it. The stock runner image has no cmake, so build a derived one first.
+
+```bash
+../act/bin/act -W .github/workflows/graalpy.yml -j graalpy   -P ubuntu-latest=<image with cmake, ninja and build-essential> --reuse
+```
+
+## Common Options
+
+- -n : dry run
+- -v : verbose
+- --reuse
+
+## Known act gaps
+
+Three things bite locally that do not bite on a GitHub runner:
+
+- **`catthehacker/ubuntu:act-24.04` has no `cmake`**, so any job that invokes CMake outside
+  scikit-build-core's own bootstrap dies with `cmake: command not found`. Derive an image:
+  `FROM catthehacker/ubuntu:act-24.04` plus
+  `apt-get install -y cmake ninja-build build-essential`, then pass it with
+  `-P ubuntu-latest=<that image>`.
+- **`--reuse` reuses the container, not the image.** After changing the `-P` image you must
+  `docker rm -f` the existing `act-...` container or act silently keeps the old one.
+- **In a git worktree, `setuptools-scm` cannot see `.git`**, because it is a file pointing at
+  a gitdir outside the bind mount, and the build fails with "unable to detect version".
+  Pass `--env SETUPTOOLS_SCM_PRETEND_VERSION=0.1.dev0`. `actions/checkout` on a real runner
+  produces a normal `.git` directory, so this is local-only.

bareduckdb-0.20.200/.github/workflows/benchmarks.yml

@@ -0,0 +1,100 @@
+name: Benchmarks
+
+# workflow_call so dev_versions.yml runs it after its tests
+on:
+  workflow_call:
+  workflow_dispatch:
+
+jobs:
+  benchmark:
+    name: 'Benchmarks'
+    runs-on: ubuntu-latest
+    timeout-minutes: 60
+
+    permissions:
+      contents: read
+      pull-requests: write
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          fetch-depth: 0
+          submodules: false
+
+      - name: Set up Python
+        uses: actions/setup-python@v7.1.0
+        with:
+          python-version: '3.15'
+
+      - name: Install UV
+        uses: astral-sh/setup-uv@07a047e608db84b3d8c06cd9a7c7dcc9c355c18e # v10.3.2
+        with:
+          enable-cache: true
+          cache-suffix: -benchmarks
+      - name: Check resources
+        run: |
+          cat /proc/meminfo | head -5
+          ulimit -a
+          nproc
+      # gcc-14/g++-14 are preinstalled, so this only selects them via CC/CXX.
+      - name: Setup Compiler
+        shell: bash
+        run: |
+          gcc-14 --version
+          g++-14 --version
+          echo "CC=gcc-14" >> $GITHUB_ENV
+          echo "CXX=g++-14" >> $GITHUB_ENV
+
+      - name: Verify the lock matches pyproject
+        run: uv lock --check
+
+      - name: Build current repo
+        run: uv sync
+
+      - name: Run benchmarks
+        id: bench
+        shell: bash
+        run: |
+          set -u
+          status=0
+          ./run_benchmarks.sh || status=$?
+          echo "status=$status" >> "$GITHUB_OUTPUT"
+
+      - name: Upload results
+        if: always()
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+        with:
+          name: benchmark-results-${{ github.sha }}
+          path: benchmark-results/
+
+      - name: Generate comparison
+        id: comparison
+        if: always()
+        shell: bash
+        run: |
+          set -u
+          status=0
+          uv run python tests/benchmarks/compare_results.py benchmark-results > comparison.md || status=$?
+          cat comparison.md
+          echo "status=$status" >> "$GITHUB_OUTPUT"
+
+      # Fork PRs get a read-only token, so only comment on same-repo PRs.
+      - name: Comment on PR
+        if: >-
+          always() &&
+          github.event_name == 'pull_request' &&
+          github.event.pull_request.head.repo.full_name == github.repository
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          gh pr comment ${{ github.event.pull_request.number }} --body-file comparison.md
+
+      - name: Fail on benchmark error
+        if: >-
+          always() &&
+          (steps.bench.outputs.status != '0' ||
+           steps.comparison.outputs.status != '0')
+        run: |
+          echo "run_benchmarks.sh exited ${{ steps.bench.outputs.status }}, compare_results.py exited ${{ steps.comparison.outputs.status }}."
+          exit 1

bareduckdb-0.20.200/.github/workflows/build_wheels.yml

@@ -0,0 +1,146 @@
+name: Build Wheels
+permissions:
+  contents: read
+
+on:
+  push:
+      branches: [main]
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: ${{ !startsWith(github.ref, 'refs/tags/') }}
+
+jobs:
+  build_wheels:
+    name: 'Wheel: ${{ matrix.python }}-${{ matrix.platform.cibw_system }}_${{ matrix.platform.arch }}'
+    strategy:
+      fail-fast: false
+      matrix:
+        python: [cp312, cp314t, cp315t]
+        platform:
+          - { os: ubuntu-latest,     arch: x86_64,     cibw_system: manylinux }
+          - { os: ubuntu-24.04-arm,  arch: aarch64,    cibw_system: manylinux }
+          - { os: ubuntu-latest,     arch: x86_64,     cibw_system: musllinux }
+          - { os: ubuntu-24.04-arm,  arch: aarch64,    cibw_system: musllinux }
+          - { os: macos-latest,      arch: arm64,      cibw_system: macosx }
+          - { os: windows-latest,    arch: AMD64,      cibw_system: win }
+          # - { os: macos-13,          arch: x86_64,     cibw_system: macosx }
+    runs-on: ${{ matrix.platform.os }}
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          fetch-depth: 0
+          submodules: false
+
+      - name: Install Astral UV
+        uses: astral-sh/setup-uv@07a047e608db84b3d8c06cd9a7c7dcc9c355c18e # v10.3.2
+        with:
+          enable-cache: true
+          cache-suffix: -${{ matrix.python }}-${{ matrix.platform.cibw_system }}_${{ matrix.platform.arch }}
+
+      - name: Build and test wheels
+        if: matrix.platform.cibw_system != 'musllinux'
+        uses: pypa/cibuildwheel@b9e566a2b284570af229f6c2a33673410d0389a3 # v4.3.4
+        env:
+          CIBW_TEST_COMMAND: pytest {project}/tests --import-mode=importlib --ignore={project}/tests/experimental --ignore={project}/tests/downstream --ignore={project}/tests/comparison --ignore={project}/tests/benchmarks -v -n auto --cov=bareduckdb --cov-report=term-missing
+          CIBW_TEST_EXTRAS: "test"
+          CIBW_TEST_REQUIRES: filelock
+          CIBW_ARCHS: ${{ matrix.platform.arch }}
+          CIBW_BUILD: ${{ matrix.python }}-${{ matrix.platform.cibw_system }}_${{ matrix.platform.arch }}
+
+      - name: Build and test wheels (musllinux)
+        if: matrix.platform.cibw_system == 'musllinux'
+        uses: pypa/cibuildwheel@b9e566a2b284570af229f6c2a33673410d0389a3 # v4.3.4
+        env:
+          CIBW_TEST_COMMAND: |
+            set -e
+            LIB={project}/src/bareduckdb/_libs/libduckdb.so
+            test -f "$LIB" || { echo "ERROR: $LIB missing after build"; exit 1; }
+            PKG=$(python -c "import importlib.util as u; print(u.find_spec('bareduckdb').submodule_search_locations[0])")
+            mkdir -p "$PKG/_libs"
+            cp -f "$LIB" "$PKG/_libs/"
+            pytest {project}/tests --import-mode=importlib --ignore={project}/tests/experimental --ignore={project}/tests/downstream --ignore={project}/tests/comparison --ignore={project}/tests/benchmarks -v -n auto --cov=bareduckdb --cov-report=term-missing
+          CIBW_TEST_EXTRAS: "test"
+          CIBW_TEST_REQUIRES: filelock
+          CIBW_ARCHS: ${{ matrix.platform.arch }}
+          CIBW_BUILD: ${{ matrix.python }}-${{ matrix.platform.cibw_system }}_${{ matrix.platform.arch }}
+
+      - name: Upload wheel
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+        with:
+          name: wheel-${{ matrix.python }}-${{ matrix.platform.cibw_system }}_${{ matrix.platform.arch }}
+          path: wheelhouse/*.whl
+          compression-level: 0
+
+  sdist:
+    name: Build sdist
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          fetch-depth: 0  # setuptools-scm needs the tags to compute a version
+          submodules: false
+
+      - name: Install Astral UV
+        uses: astral-sh/setup-uv@07a047e608db84b3d8c06cd9a7c7dcc9c355c18e # v10.3.2
+
+      - name: Build sdist
+        run: uv build --sdist --out-dir dist
+
+      - name: Upload sdist
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+          compression-level: 0
+
+  # Separate job: the matrix's CIBW_TEST_* env vars would mask pyproject's gp* override
+  graalpy_wheel:
+    name: GraalPy wheel
+    uses: ./.github/workflows/graalpy.yml
+    permissions:
+      contents: read
+
+  publish-wheels:
+    name: Publish Wheels to PyPI
+    needs: [build_wheels, graalpy_wheel, sdist]
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download wheels
+        uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
+        with:
+          path: dist/
+          pattern: "*wheel*"
+          merge-multiple: true
+
+      - name: Download sdist
+        uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
+        with:
+          path: dist/
+          name: sdist
+
+      - name: List distributables
+        run: |
+          ls -lhR dist/
+          test -n "$(ls dist/*.tar.gz 2>/dev/null)" || { echo "ERROR: no sdist"; exit 1; }
+          test -n "$(ls dist/*graalpy*.whl 2>/dev/null)" || { echo "ERROR: no GraalPy wheel"; exit 1; }
+          # Anything else in packages-dir fails the upload
+          stray=$(find dist -mindepth 1 ! -name '*.whl' ! -name '*.tar.gz')
+          test -z "$stray" || { echo "ERROR: unexpected entries in dist/:"; echo "$stray"; exit 1; }
+          # PyPI rejects bare linux_* tags. Fail first.
+          bad=$(find dist \( -name '*-linux_x86_64.whl' -o -name '*-linux_aarch64.whl' -o -name '*-linux_i686.whl' \))
+          test -z "$bad" || { echo "ERROR: unrepaired linux tag, PyPI will reject:"; echo "$bad"; exit 1; }
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086 # v1.14.3
+        with:
+          packages-dir: dist/

bareduckdb-0.20.200/.github/workflows/dev_versions.yml

@@ -0,0 +1,325 @@
+name: Extensive Tests
+
+# This tests is a more extensive suite that's likely more fragile and slower:
+# - parallel thread safety tests
+# - Nightly builds of pyarrow and pandas
+# - Downstream integration tests for common libraries
+# - Ensures pyarrow capsules (via polars) works without importing pyarrow
+on:
+  # branches: filters out tag pushes, which otherwise ran the whole matrix again.
+  push:
+    branches: ['**']
+  # schedule:
+  #   - cron: '0 6 * * *'
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  dev_versions:
+    name: 'Full Tests - Python ${{ matrix.python-version }} - ${{ matrix.os }}'
+    runs-on: ${{ matrix.os }}
+
+    permissions:
+      contents: read
+
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            python-version: '3.14'
+          - os: ubuntu-latest
+            python-version: '3.15t'
+          # - os: macos-latest
+          #   python-version: '3.12'
+          - os: macos-latest
+            python-version: '3.15t'
+          - os: windows-latest
+            python-version: '3.14'
+          - os: windows-latest
+            python-version: '3.15t'
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          fetch-depth: 0
+          submodules: false
+
+      - name: Set up Python
+        uses: actions/setup-python@v7.1.0
+        with:
+          python-version: ${{ matrix.python-version }}
+          allow-prereleases: true
+
+      - name: Install UV
+        uses: astral-sh/setup-uv@07a047e608db84b3d8c06cd9a7c7dcc9c355c18e # v10.3.2
+        with:
+          enable-cache: true
+          cache-suffix: -dev-versions-${{ matrix.python-version }}
+
+      - name: Setup Compiler
+        shell: bash
+        run: |
+          if [ "${{ runner.os }}" = "Windows" ]; then
+            # Windows: MSVC ships with the runner and matches DuckDB's prebuilt DLL
+            echo "Using MSVC"
+          elif [ "${{ matrix.os }}" = "macos-latest" ]; then
+            # macOS: Use AppleClang (default) to match DuckDB's build
+            # DuckDB prebuilt binaries are compiled with AppleClang
+            echo "Using default AppleClang compiler"
+            cc --version
+            c++ --version
+          else
+            # Ubuntu: Install and configure GCC 14
+            sudo apt-get update
+            sudo apt-get install -y gcc-14 g++-14
+            sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-14 100
+            sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-14 100
+            echo "CC=gcc-14" >> $GITHUB_ENV
+            echo "CXX=g++-14" >> $GITHUB_ENV
+            gcc --version
+            g++ --version
+          fi
+
+      # Scheduled and manual runs re-resolve
+      - name: Refresh lock for nightly deps
+        if: github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'
+        run: uv lock --upgrade
+
+      - name: Verify the lock matches pyproject
+        if: github.event_name != 'schedule' && github.event_name != 'workflow_dispatch'
+        run: uv lock --check
+
+      - name: Build
+        shell: bash
+        run: |
+          # No --no-build: pyyaml ships no cp315 wheel and must build from its sdist
+          uv sync --no-install-project
+          uv sync --reinstall-package bareduckdb -v
+
+      - name: Install GIL-only deps (polars, vortex-data)
+        shell: bash
+        run: |
+          if uv run --no-sync python -c "import sysconfig, sys; sys.exit(1 if sysconfig.get_config_var('Py_GIL_DISABLED') else 0)"; then
+            uv pip install --group dev-gil --only-binary :all:
+          else
+            echo "free-threaded interpreter: skipping the dev-gil group"
+          fi
+
+      - name: Run core tests 1
+        shell: bash
+        run: |
+          uv run --no-sync pytest tests --ignore=tests/experimental --ignore=tests/downstream --ignore=tests/comparison --ignore=tests/benchmarks -v -n auto
+
+      - name: Run parallel thread safety tests
+        shell: bash
+        run: |
+          NPROC=$(nproc 2>/dev/null || sysctl -n hw.ncpu)
+          THREADS=$((NPROC - 1))
+          THREADS=$((THREADS < 1 ? 1 : THREADS))  # Ensure at least 1 thread
+          # Capped for OOM issues / DEFAULT_TABLE_BATCH_ROWS
+          THREADS=$((THREADS > 4 ? 4 : THREADS))
+          echo "NPROC: $NPROC"
+          echo "THREADS: $THREADS"
+          # NOTE: -m "not anyio and not parallel_threads" deselects two whole categories of
+          # the registry code:
+          #  - all of tests/aio (every async test there carries anyio's "anyio" marker)
+          #  - every registration test file (test_register.py, test_uncached_direct_emit.py,
+          #    test_incremental_scan.py, test_registration_contract.py, test_register_memory.py),
+          #    because each carries a file-level @pytest.mark.parallel_threads(1)
+          # So this pass exercises essentially none of register()/unregister(). The
+          # workflow-side mitigation is the dedicated tests/aio stage below. Closing the
+          # registration half needs a tests/ change rather than a workflow one: narrow those
+          # blanket file-level markers to only the tests that genuinely touch process-global
+          # state, so the rest run under --parallel-threads.
+          uv run --no-sync pytest tests/ -n 0 --parallel-threads=$THREADS --iterations=5 --tb=short -v -m "not anyio and not parallel_threads" --ignore=tests/experimental --ignore=tests/comparison --ignore=tests/downstream --ignore=tests/benchmarks --cov=bareduckdb --cov-append
+
+      - name: Run tests/aio under repetition (async pool concurrency, asyncio and trio)
+        shell: bash
+        run: |
+          # tests/aio is deselected from the OS-thread parallel pass above because async
+          # concurrency is cooperative (one event loop, many tasks), not thread-based, and
+          # pytest-run-parallel and anyio's pytest plugin are not vetted together here. Repetition
+          # via pytest-repeat (--count, already a dev dependency) is the concurrency lever
+          # that fits async code: each repetition re-runs the pool's own internal
+          # task/connection concurrency, the shape that produced a "free(): chunks in
+          # smallbin corrupted" crash in a registered Arrow source scanned through the async
+          # pool. This is NOT a substitute for real multi-thread coverage of tests/aio.
+          uv run --no-sync pytest tests/aio -n 0 --count=20 --tb=short -v --cov=bareduckdb --cov-append
+
+      - name: Test PyArrow is Optional
+        # TODO: 3.15: pola-rs/polars#28347
+        if: matrix.python-version != '3.14t' && !startsWith(matrix.python-version, '3.15')
+        shell: bash
+        run: |
+          # Test that bareduckdb works with polars without pyarrow installed
+          uv pip uninstall pyarrow
+          # Assert polars is importable first, and assert pyarrow is not, otherwise tests skipped
+          uv run --no-sync python -c "import polars; print('polars', polars.__version__)"
+          uv run --no-sync python -c "
+          import importlib.util, sys
+          if importlib.util.find_spec('pyarrow') is not None:
+              sys.exit('pyarrow is still installed; the uninstall above did not take effect')
+          print('pyarrow absent, as intended')
+          "
+          # -n 0: xdist reports a missing path as "0 items"
+          uv run --no-sync pytest tests/polars_only -n 0 -v --cov=bareduckdb --cov-append
+          uv pip install pyarrow
+
+      - name: Run DuckDB comparison tests
+        # duckdb has no 3.14t or 3.15 wheels yet.
+        if: matrix.python-version != '3.14t' && !startsWith(matrix.python-version, '3.15')
+        shell: bash
+        run: |
+          uv pip install "duckdb==2.0.*"
+          uv run --no-sync pytest tests/comparison -v --tb=short --cov=bareduckdb --cov-append
+          uv pip uninstall duckdb
+
+      # - name: Test PyPI DuckDB extensions
+      #   if: matrix.python-version != '3.14t'
+      #   shell: bash
+      #   run: |
+      #     uv pip install duckdb-extensions==1.4.2 duckdb-extension-httpfs
+
+      #     uv run --no-sync python -c "
+      #     import bareduckdb
+      #     conn = bareduckdb.Connection()
+
+      #     conn.load_extension('httpfs')
+
+      #     result = conn.execute('''SELECT * FROM duckdb_extensions() WHERE extension_name = 'httpfs' ''').fetchall()
+      #     assert len(result) > 0, 'httpfs extension not loaded'
+
+      #     extension_info = result[0]
+      #     assert extension_info[1] is False
+      #     assert extension_info[2] is True
+
+      #     conn.close()
+      #     "
+
+      #     uv pip uninstall duckdb-extensions duckdb-extension-httpfs
+
+      - name: Run downstream integration tests
+        # TODO: No duckdb 3.15
+        if: matrix.python-version != '3.14t' && !startsWith(matrix.python-version, '3.15')
+        shell: bash
+        run: |
+          # magic-duckdb
+          uv sync --group downstream
+
+          # Run tests separately to avoid module contamination
+          uv run --no-sync pytest tests/downstream/test_sqlalchemy.py tests/downstream/test_magic_duckdb.py -v --cov=bareduckdb --cov-append
+          uv run --no-sync pytest tests/downstream/test_jupysql.py -v --cov=bareduckdb --cov-append
+
+      - name: Generate coverage report
+        if: always()
+        shell: bash
+        run: |
+          uv run --no-sync coverage report --show-missing
+
+      - name: Count Lines of Code (cloc)
+        uses: djdefi/cloc-action@a0529b3e4543679d21233a9287ee96b1b1a29949 # 7
+        if: matrix.os == 'ubuntu-latest'
+        with:
+          options: --exclude-dir=tests,external,.git,.github,benchmarks,notebooks,include
+
+      - name: Upload test results
+        if: always()
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+        with:
+          name: dev-versions-test-results-${{ matrix.python-version }}
+          path: |
+            .pytest_cache/
+          retention-days: 7
+
+  musl:
+    name: 'Musl Tests - ${{ matrix.python }} - musllinux_1_2'
+    runs-on: ubuntu-latest
+    needs: dev_versions
+
+    permissions:
+      contents: read
+
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - { python: cp314, pydir: cp314-cp314 }
+          - { python: cp315t, pydir: cp315-cp315t }
+
+    steps:
+      # Checkout on the glibc host
+      - name: Checkout code
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          fetch-depth: 0
+          submodules: false
+
+      - name: Cache uv downloads
+        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
+        with:
+          path: .uv-cache
+          key: uv-musl-${{ matrix.python }}-${{ hashFiles('uv.lock') }}
+          restore-keys: uv-musl-${{ matrix.python }}-
+
+      - name: Build and test in musllinux_1_2
+        shell: bash
+        # Same image cibuildwheel uses
+        run: |
+          docker run --rm -v "$PWD:/build" -w /build \
+            -e UV_CACHE_DIR=/build/.uv-cache \
+            quay.io/pypa/musllinux_1_2_x86_64 sh -c '
+              set -e
+              PY=/opt/python/${{ matrix.pydir }}/bin/python
+              test -x "$PY" || { echo "ERROR: no interpreter at $PY"; ls /opt/python; exit 1; }
+              gcc --version | head -1
+              export UV_PYTHON="$PY"
+              uv sync --no-default-groups --extra test --reinstall-package bareduckdb
+
+              # libduckdb must be the musl build, not glibc
+              LIB=$(find src/bareduckdb/_libs -name "libduckdb.so")
+              readelf -d "$LIB" | grep -q "libc.musl" || { echo "ERROR: $LIB is not musl-linked"; exit 1; }
+              echo "OK: $LIB is musl-linked"
+
+              SRC_DIR=$(cd "$(dirname "$LIB")" && pwd)
+              # cd+pwd rather than realpath -m: busybox realpath has no -m.
+              DEST_DIR=$(uv run --no-sync python -c "import os, sysconfig; print(os.path.join(sysconfig.get_paths()[\"platlib\"], \"bareduckdb\", \"_libs\"))")
+              if [ "$DEST_DIR" != "$SRC_DIR" ]; then
+                mkdir -p "$DEST_DIR"
+                # Hard link, so musl dedupes it by inode against the preloaded copy and maps
+                # DuckDB once; cp is the cross-device fallback.
+                ln -f "$SRC_DIR/libduckdb.so" "$DEST_DIR/libduckdb.so" 2>/dev/null \
+                  || cp -f "$SRC_DIR/libduckdb.so" "$DEST_DIR/"
+                echo "Linked $SRC_DIR/libduckdb.so into $DEST_DIR"
+              fi
+
+              uv run --no-sync pytest tests --ignore=tests/experimental --ignore=tests/downstream \
+                  --ignore=tests/comparison --ignore=tests/benchmarks \
+                  -o addopts="" -q -n auto
+
+              # Drop the pre-built wheels that are cheaper to refetch than to store.
+              uv cache prune --ci
+            '
+
+      - name: Make the uv cache readable by the runner
+        if: always()
+        shell: bash
+        run: sudo chown -R "$(id -u):$(id -g)" .uv-cache || true
+
+  graalpy:
+    name: GraalPy
+    needs: dev_versions
+    uses: ./.github/workflows/graalpy.yml
+    permissions:
+      contents: read
+
+  benchmarks:
+    name: Benchmarks
+    needs: dev_versions
+    uses: ./.github/workflows/benchmarks.yml
+    permissions:
+      contents: read
+      pull-requests: write

bareduckdb-0.20.200/.github/workflows/graalpy.yml

@@ -0,0 +1,39 @@
+name: GraalPy
+
+# workflow_call so build_wheels.yml and dev_versions.yml can chain it
+on:
+  workflow_call:
+  workflow_dispatch:
+
+# Build, repair and test settings live in pyproject.toml's `gp*` cibuildwheel override.
+# Linux x86_64 only: Oracle's GraalPy index has no pyarrow wheel for any other platform.
+jobs:
+  graalpy:
+    name: 'GraalPy - gp313_253 - manylinux x86_64'
+    runs-on: ubuntu-latest
+
+    continue-on-error: true
+
+    permissions:
+      contents: read
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          fetch-depth: 0
+          submodules: false
+
+      - name: Build and test GraalPy wheel
+        uses: pypa/cibuildwheel@b9e566a2b284570af229f6c2a33673410d0389a3 # v4.3.4
+        with:
+          only: gp313_253-manylinux_x86_64
+
+      - name: Upload GraalPy wheel
+        if: always()
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+        with:
+          name: graalpy-wheel
+          path: wheelhouse/*.whl
+          if-no-files-found: warn
+          compression-level: 0