xqdb 0.1.1__tar.gz

xqdb-0.1.1/.github/workflows/CI.yml

@@ -0,0 +1,221 @@
+name: XQDB CI
+
+on:
+  workflow_dispatch:
+    inputs:
+      # Commit to build. If omitted, use the workflow-dispatch ref.
+      sha:
+        description: Commit SHA
+        type: string
+      # Create the sdist and build the wheels, but do not publish to PyPI / GitHub.
+      dry-run:
+        description: Dry run
+        type: boolean
+        default: true
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: false
+
+defaults:
+  run:
+    shell: bash
+
+jobs:
+  source:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    outputs:
+      commit: ${{ steps.commit.outputs.sha }}
+    steps:
+      - name: Validate live release source
+        if: inputs.dry-run == false
+        env:
+          REQUESTED_SHA: ${{ inputs.sha }}
+          DISPATCH_REF: ${{ github.ref }}
+          DEFAULT_BRANCH: ${{ github.event.repository.default_branch }}
+        run: |
+          if [[ -n "$REQUESTED_SHA" || "$DISPATCH_REF" != "refs/heads/$DEFAULT_BRANCH" ]]; then
+            echo "Live releases must be dispatched from the default branch without a SHA override." >&2
+            exit 1
+          fi
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          ref: ${{ inputs.dry-run && inputs.sha || github.sha }}
+          fetch-depth: 0
+      - name: Resolve immutable source commit
+        id: commit
+        env:
+          LIVE_RELEASE: ${{ inputs.dry-run == false }}
+        run: |
+          sha="$(git rev-parse HEAD)"
+          echo "sha=$sha" >> "$GITHUB_OUTPUT"
+          if [[ "$LIVE_RELEASE" == "true" ]]; then
+            version="$(python -c 'import tomllib; print(tomllib.load(open("Cargo.toml", "rb"))["workspace"]["package"]["version"])')"
+            expected_tag="v$version"
+            if ! actual_tag="$(git describe --tags --exact-match --match 'v[0-9]*')"; then
+              echo "Live releases require an exact v-prefixed version tag on the source commit." >&2
+              exit 1
+            fi
+            if [[ "$actual_tag" != "$expected_tag" ]]; then
+              echo "Release tag $actual_tag does not match workspace version $version." >&2
+              exit 1
+            fi
+          fi
+
+  linux:
+    needs: source
+    runs-on: ubuntu-latest
+    container: quay.io/pypa/manylinux_2_28_x86_64@sha256:4dc41da7df20400310c80d162a2fe2d2c2f3d9734d8dec20f6b9843711618deb
+    timeout-minutes: 60
+    env:
+      UV_PYTHON: /opt/python/cp312-cp312/bin/python
+      SETUPTOOLS_RUST_CARGO_PROFILE: release
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          ref: ${{ needs.source.outputs.commit }}
+          fetch-depth: 0
+      - name: Setup Rust
+        uses: actions-rust-lang/setup-rust-toolchain@166cdcfd11aee3cb47222f9ddb555ce30ddb9659 # v1
+      - name: Setup uv
+        uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+        with:
+          version: latest-known
+      - name: Build wheel
+        run: uv build --wheel --out-dir build-wheel
+      - name: Repair manylinux wheel
+        run: auditwheel repair build-wheel/*.whl --plat manylinux_2_28_x86_64 --wheel-dir dist
+      - name: Smoke-test wheel
+        run: |
+          uv venv smoke --python "$UV_PYTHON"
+          python="$PWD/smoke/bin/python"
+          uv pip install --python "$python" dist/*.whl
+          "$python" -c 'import xqdb; data = xqdb.serialize_as_ipc_bytes6("sync", False, 42); assert data'
+      - name: Upload wheel
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        with:
+          name: wheels-linux-x86_64
+          path: dist
+
+  windows:
+    needs: source
+    runs-on: windows-latest
+    timeout-minutes: 60
+    env:
+      SETUPTOOLS_RUST_CARGO_PROFILE: release
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          ref: ${{ needs.source.outputs.commit }}
+          fetch-depth: 0
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7
+        with:
+          python-version: "3.12"
+      - name: Setup Rust
+        uses: actions-rust-lang/setup-rust-toolchain@166cdcfd11aee3cb47222f9ddb555ce30ddb9659 # v1
+      - name: Setup uv
+        uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+        with:
+          version: latest-known
+      - name: Build wheel
+        run: uv build --wheel --out-dir dist
+      - name: Smoke-test wheel
+        run: |
+          uv venv smoke --python 3.12
+          python="$PWD/smoke/Scripts/python.exe"
+          uv pip install --python "$python" dist/*.whl
+          "$python" -c 'import xqdb; data = xqdb.serialize_as_ipc_bytes6("sync", False, 42); assert data'
+      - name: Upload wheel
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        with:
+          name: wheels-windows-x86_64
+          path: dist
+
+  macos:
+    needs: source
+    runs-on: macos-15
+    timeout-minutes: 60
+    env:
+      MACOSX_DEPLOYMENT_TARGET: "11.0"
+      SETUPTOOLS_RUST_CARGO_PROFILE: release
+      _PYTHON_HOST_PLATFORM: macosx-11.0-arm64
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          ref: ${{ needs.source.outputs.commit }}
+          fetch-depth: 0
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7
+        with:
+          python-version: "3.12"
+      - name: Setup Rust
+        uses: actions-rust-lang/setup-rust-toolchain@166cdcfd11aee3cb47222f9ddb555ce30ddb9659 # v1
+      - name: Setup uv
+        uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+        with:
+          version: latest-known
+      - name: Build wheel
+        run: uv build --wheel --out-dir dist
+      - name: Verify wheel platform tag
+        run: |
+          wheel=(dist/*.whl)
+          [[ ${#wheel[@]} -eq 1 && ${wheel[0]} == *-macosx_11_0_arm64.whl ]]
+      - name: Smoke-test wheel
+        run: |
+          uv venv smoke --python 3.12
+          python="$PWD/smoke/bin/python"
+          uv pip install --python "$python" dist/*.whl
+          "$python" -c 'import xqdb; data = xqdb.serialize_as_ipc_bytes6("sync", False, 42); assert data'
+      - name: Upload wheel
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        with:
+          name: wheels-macos-arm64
+          path: dist
+
+  sdist:
+    runs-on: ubuntu-latest
+    needs: source
+    timeout-minutes: 60
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          ref: ${{ needs.source.outputs.commit }}
+          fetch-depth: 0
+      - name: Setup uv
+        uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+        with:
+          version: latest-known
+      - name: Build sdist
+        run: uv build --sdist --out-dir dist
+      - name: Upload sdist
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        with:
+          name: wheels-sdist
+          path: dist
+
+  release:
+    name: Release
+    if: inputs.dry-run == false && inputs.sha == '' && github.ref == format('refs/heads/{0}', github.event.repository.default_branch)
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    needs: [linux, windows, macos, sdist]
+    environment:
+      name: pypi
+      url: https://pypi.org/project/xqdb
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
+        with:
+          path: dist
+          merge-multiple: true
+
+      - name: Publish with provenance attestations
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2
+        with:
+          attestations: true

xqdb-0.1.1/.github/workflows/JS.yml

@@ -0,0 +1,208 @@
+name: JavaScript CI
+
+on:
+  push:
+    branches:
+      - "**"
+    paths:
+      - ".github/workflows/JS.yml"
+      - "Cargo.toml"
+      - "Cargo.lock"
+      - "rust-toolchain.toml"
+      - "crates/xqdb/**"
+      - "bindings/napi-xqdb/**"
+      - "js-xqdb/**"
+  pull_request:
+    paths:
+      - ".github/workflows/JS.yml"
+      - "Cargo.toml"
+      - "Cargo.lock"
+      - "rust-toolchain.toml"
+      - "crates/xqdb/**"
+      - "bindings/napi-xqdb/**"
+      - "js-xqdb/**"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  windows-x64-msvc:
+    name: Windows x64 MSVC
+    runs-on: windows-latest
+    timeout-minutes: 30
+    defaults:
+      run:
+        shell: pwsh
+        working-directory: js-xqdb
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7
+        with:
+          node-version: 24
+          cache: npm
+          cache-dependency-path: js-xqdb/package-lock.json
+      - uses: dtolnay/rust-toolchain@4360b52568e2003a75bf9bc1d59f33a8e3fc893c # stable
+        with:
+          toolchain: 1.98.0
+          targets: x86_64-pc-windows-msvc
+      - uses: Swatinem/rust-cache@6323deb102c322ba6fcbdcafc7e3dddab59af2b6 # v2.9.2
+
+      - name: Install JavaScript dependencies
+        run: npm install --no-audit --no-fund
+      - name: Build release native addon
+        run: npm run build:native:release -- --target x86_64-pc-windows-msvc
+      - name: Build TypeScript
+        run: npm run build:ts
+      - name: Run Vitest
+        run: npm test
+      - name: Stage and pack packages
+        run: |
+          New-Item -ItemType Directory -Force artifacts | Out-Null
+          Copy-Item xqdb.win32-x64-msvc.node npm/win32-x64-msvc/xqdb.win32-x64-msvc.node
+          npm pack --pack-destination artifacts
+          npm pack ./npm/win32-x64-msvc --pack-destination artifacts
+      - name: Smoke-test packed installation
+        run: |
+          $version = node -p "require('./package.json').version"
+          $platformVersion = node -p "require('./npm/win32-x64-msvc/package.json').version"
+          $rootTarball = (Resolve-Path "artifacts/xqdb-$version.tgz").Path
+          $platformTarball = (Resolve-Path "artifacts/xqdb-win32-x64-msvc-$platformVersion.tgz").Path
+          $smokeDir = Join-Path $env:RUNNER_TEMP "xqdb-smoke-$env:GITHUB_RUN_ID-$env:GITHUB_RUN_ATTEMPT"
+          New-Item -ItemType Directory $smokeDir | Out-Null
+          Set-Location $smokeDir
+          npm init -y
+          npm install --omit=optional --no-audit --no-fund $rootTarball $platformTarball
+          node --input-type=module -e 'const { serializeAsIpcBytes6 } = await import("xqdb"); const bytes = await serializeAsIpcBytes6("sync", false, 42); if (!Buffer.isBuffer(bytes) || bytes.length === 0) throw new Error("native serialization returned no bytes");'
+      - name: Upload packed packages and native addon
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        with:
+          name: xqdb-win32-x64-msvc
+          if-no-files-found: error
+          retention-days: 7
+          path: |
+            js-xqdb/artifacts/*.tgz
+            js-xqdb/xqdb.win32-x64-msvc.node
+
+  linux-x64-gnu:
+    name: Linux x64 GNU (glibc 2.28)
+    runs-on: ubuntu-22.04
+    timeout-minutes: 30
+    container:
+      image: quay.io/pypa/manylinux_2_28_x86_64@sha256:4dc41da7df20400310c80d162a2fe2d2c2f3d9734d8dec20f6b9843711618deb
+    defaults:
+      run:
+        shell: bash
+        working-directory: js-xqdb
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7
+        with:
+          node-version: 24
+          cache: npm
+          cache-dependency-path: js-xqdb/package-lock.json
+      - uses: dtolnay/rust-toolchain@4360b52568e2003a75bf9bc1d59f33a8e3fc893c # stable
+        with:
+          toolchain: 1.98.0
+          targets: x86_64-unknown-linux-gnu
+      - uses: Swatinem/rust-cache@6323deb102c322ba6fcbdcafc7e3dddab59af2b6 # v2.9.2
+      - name: Run Rust unit tests
+        working-directory: .
+        run: cargo test --locked -p xqdb -p napi-xqdb
+
+      - name: Install JavaScript dependencies
+        run: npm install --no-audit --no-fund
+      - name: Build release native addon
+        run: npm run build:native:release -- --target x86_64-unknown-linux-gnu
+      - name: Build TypeScript
+        run: npm run build:ts
+      - name: Run Vitest
+        run: npm test
+      - name: Stage and pack packages
+        run: |
+          mkdir -p artifacts
+          cp xqdb.linux-x64-gnu.node npm/linux-x64-gnu/xqdb.linux-x64-gnu.node
+          npm pack --pack-destination artifacts
+          npm pack ./npm/linux-x64-gnu --pack-destination artifacts
+      - name: Smoke-test packed installation on glibc 2.28
+        run: |
+          version="$(node -p "require('./package.json').version")"
+          platform_version="$(node -p "require('./npm/linux-x64-gnu/package.json').version")"
+          root_tarball="$PWD/artifacts/xqdb-$version.tgz"
+          platform_tarball="$PWD/artifacts/xqdb-linux-x64-gnu-$platform_version.tgz"
+          smoke_dir="$RUNNER_TEMP/xqdb-smoke-$GITHUB_RUN_ID-$GITHUB_RUN_ATTEMPT"
+          mkdir "$smoke_dir"
+          cd "$smoke_dir"
+          npm init -y
+          npm install --omit=optional --no-audit --no-fund "$root_tarball" "$platform_tarball"
+          node --input-type=module -e 'const { serializeAsIpcBytes6 } = await import("xqdb"); const bytes = await serializeAsIpcBytes6("sync", false, 42); if (!Buffer.isBuffer(bytes) || bytes.length === 0) throw new Error("native serialization returned no bytes");'
+      - name: Upload packed packages and native addon
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        with:
+          name: xqdb-linux-x64-gnu
+          if-no-files-found: error
+          retention-days: 7
+          path: |
+            js-xqdb/artifacts/*.tgz
+            js-xqdb/xqdb.linux-x64-gnu.node
+
+  macos-arm64:
+    name: macOS arm64
+    runs-on: macos-15
+    timeout-minutes: 30
+    defaults:
+      run:
+        shell: bash
+        working-directory: js-xqdb
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7
+        with:
+          node-version: 24
+          cache: npm
+          cache-dependency-path: js-xqdb/package-lock.json
+      - uses: dtolnay/rust-toolchain@4360b52568e2003a75bf9bc1d59f33a8e3fc893c # stable
+        with:
+          toolchain: 1.98.0
+          targets: aarch64-apple-darwin
+      - uses: Swatinem/rust-cache@6323deb102c322ba6fcbdcafc7e3dddab59af2b6 # v2.9.2
+
+      - name: Install JavaScript dependencies
+        run: npm install --no-audit --no-fund
+      - name: Build release native addon
+        run: npm run build:native:release -- --target aarch64-apple-darwin
+      - name: Build TypeScript
+        run: npm run build:ts
+      - name: Run Vitest
+        run: npm test
+      - name: Stage and pack packages
+        run: |
+          mkdir -p artifacts
+          cp xqdb.darwin-arm64.node npm/darwin-arm64/xqdb.darwin-arm64.node
+          npm pack --pack-destination artifacts
+          npm pack ./npm/darwin-arm64 --pack-destination artifacts
+      - name: Smoke-test packed installation
+        run: |
+          version="$(node -p "require('./package.json').version")"
+          platform_version="$(node -p "require('./npm/darwin-arm64/package.json').version")"
+          root_tarball="$PWD/artifacts/xqdb-$version.tgz"
+          platform_tarball="$PWD/artifacts/xqdb-darwin-arm64-$platform_version.tgz"
+          smoke_dir="$RUNNER_TEMP/xqdb-smoke-$GITHUB_RUN_ID-$GITHUB_RUN_ATTEMPT"
+          mkdir "$smoke_dir"
+          cd "$smoke_dir"
+          npm init -y
+          npm install --omit=optional --no-audit --no-fund "$root_tarball" "$platform_tarball"
+          node --input-type=module -e 'const { serializeAsIpcBytes6 } = await import("xqdb"); const bytes = await serializeAsIpcBytes6("sync", false, 42); if (!Buffer.isBuffer(bytes) || bytes.length === 0) throw new Error("native serialization returned no bytes");'
+      - name: Upload packed packages and native addon
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        with:
+          name: xqdb-darwin-arm64
+          if-no-files-found: error
+          retention-days: 7
+          path: |
+            js-xqdb/artifacts/*.tgz
+            js-xqdb/xqdb.darwin-arm64.node