build: switch to abi3 build to make build faster and reduce size (#945)

* build: switch to abi3 build to make build faster and reduce size

* build: `release` need to happen after `test-abi3`

* fix: allow test install download from pypi

* fix: `release-doc` only triggered for tags

* docs: update comments

Author: georgeh0

.github/workflows/release.yml

@@ -1,8 +1,7 @@
-# This file is autogenerated by maturin v1.8.1
-# To update, run
-#
-#    maturin generate-ci github
+# This workflow can be triggered on tags push (automatic release) or manually on any branch.
 #
+# - When triggered on tags push, it will build and publishes a new version including docs.
+# - When triggered manually, it's a dry-run: only build, without publishing anything.
 name: release
 
 on:
@@ -43,7 +42,7 @@ jobs:
           name: Cargo.toml
       - uses: actions/setup-python@v5
         with:
-          python-version: 3.x
+          python-version: 3.13
       - name: Build wheels
         uses: PyO3/maturin-action@v1
         with:
@@ -58,6 +57,24 @@ jobs:
           name: wheels-${{ matrix.platform.os }}-${{ matrix.platform.target }}
           path: dist
 
+  test-abi3:
+    runs-on: ubuntu-24.04
+    needs: build
+    strategy:
+      matrix:
+        py: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: wheels-linux-x86_64
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.py }}
+      - run: python -V
+      - run: pip install --find-links=./ cocoindex
+      - run: python -c "import cocoindex, sys; print('import ok on', sys.version)"
+
+
   sdist:
     runs-on: ubuntu-latest
     needs: [create-versioned-toml]
@@ -80,7 +97,7 @@ jobs:
   release:
     name: Release
     runs-on: ubuntu-latest
-    needs: [create-versioned-toml, build, sdist]
+    needs: [create-versioned-toml, build, test-abi3, sdist]
     permissions:
       # Use to sign the release artifacts
       id-token: write
@@ -111,5 +128,6 @@ jobs:
   release-docs:
     name: Release Docs
     needs: [release]
+    if: ${{ startsWith(github.ref, 'refs/tags/') }}
     uses: ./.github/workflows/_doc_release.yml
     secrets: inherit

Cargo.toml

@@ -15,7 +15,12 @@ name = "cocoindex_engine"
 crate-type = ["cdylib"]
 
 [dependencies]
-pyo3 = { version = "0.25.1", features = ["chrono", "auto-initialize", "uuid"] }
+pyo3 = { version = "0.25.1", features = [
+    "abi3-py311",
+    "auto-initialize",
+    "chrono",
+    "uuid",
+] }
 pythonize = "0.25.0"
 pyo3-async-runtimes = { version = "0.25.0", features = ["tokio-runtime"] }