[CLIENT-3146] Add support for free threading mode in Python 3.13

.github/workflows/build-wheels.yml

@@ -27,7 +27,7 @@ on:
         type: string
         description: Valid JSON list of Python tags to build the client for
         required: false
-        default: '["cp38", "cp39", "cp310", "cp311", "cp312"]'
+        default: '["cp38", "cp39", "cp310", "cp311", "cp312", "cp313", "cp313t"]'
       platform-tag:
         description: Platform to build the client for.
         type: choice
@@ -76,7 +76,7 @@ on:
       python-tags:
         type: string
         required: false
-        default: '["cp38", "cp39", "cp310", "cp311", "cp312"]'
+        default: '["cp38", "cp39", "cp310", "cp311", "cp312", "cp313", "cp313t"]'
       platform-tag:
         type: string
         required: true
@@ -238,7 +238,7 @@ jobs:
       run: echo "INCLUDE_DSYM=1" >> $GITHUB_ENV
 
     - name: Build wheel
-      uses: pypa/cibuildwheel@v2.20.0
+      uses: pypa/cibuildwheel@v2.21.3
       env:
         CIBW_ENVIRONMENT_PASS_LINUX: ${{ inputs.unoptimized && 'UNOPTIMIZED' || '' }}
         CIBW_ENVIRONMENT_MACOS: SSL_LIB_PATH="$(brew --prefix openssl@1.1)/lib/" CPATH="$(brew --prefix openssl@1.1)/include/" STATIC_SSL=1
@@ -250,6 +250,7 @@ jobs:
           yum install python-setuptools -y
         # delvewheel is not enabled by default but we do need to repair the wheel
         CIBW_BEFORE_BUILD_WINDOWS: "pip install delvewheel"
+        CIBW_FREE_THREADED_SUPPORT: ${{ matrix.python-tag == 'cp313t' && '1' || '0' }}
         CIBW_REPAIR_WHEEL_COMMAND_WINDOWS: "delvewheel repair --add-path ./aerospike-client-c/vs/x64/Release -w {dest_dir} {wheel}"
         CIBW_TEST_COMMAND: ${{ env.TEST_COMMAND }}
 
@@ -294,6 +295,11 @@ jobs:
       - uses: actions/checkout@v4
         with:
           ref: ${{ env.COMMIT_SHA_TO_BUILD_AND_TEST }}
+          sparse-checkout-cone-mode: false
+          sparse-checkout: |
+            !pyproject.toml
+            test/**
+            .github/**
 
       # Need to be able to save Docker Hub credentials to keychain
       - if: ${{ inputs.platform-tag == 'macosx_arm64' && inputs.use-server-rc }}
@@ -312,6 +318,7 @@ jobs:
           name: ${{ env.BUILD_IDENTIFIER }}.build
 
       - name: Convert Python tag to Python version
+        if: ${{ matrix.python-tag != 'cp313t' }}
         # Don't use sed because we want this command to work on both mac and windows
         # The command used in GNU sed is different than in macOS sed
         run: |
@@ -321,11 +328,26 @@ jobs:
         shell: bash
 
       - uses: actions/setup-python@v5
+        if: ${{ matrix.python-tag != 'cp313t' }}
         with:
           python-version: ${{ env.PYTHON_VERSION }}
 
+      - if: ${{ matrix.python-tag == 'cp313t' }}
+        uses: astral-sh/setup-uv@v3
+        with:
+          version: "0.4.x"
+
+      - if: ${{ matrix.python-tag == 'cp313t' }}
+        # Will automatically install Python 3.13t if not present
+        run: uv venv --python 3.13t
+        shell: bash
+
+      # TODO: check if uv is installed, instead
+      - run: echo PIP_COMMAND="${{ matrix.python-tag == 'cp313t' && 'uv' || '' }} pip" >> $GITHUB_ENV
+        shell: bash
+
       - name: Install wheel
-        run: python3 -m pip install aerospike --force-reinstall --no-index --find-links=./
+        run: ${{ env.PIP_COMMAND }} install aerospike --force-reinstall --no-index --find-links=./
         shell: bash
 
       - name: Connect to Docker container on remote machine with Docker daemon
@@ -336,11 +358,14 @@ jobs:
           crudini --set config.conf enterprise-edition hosts ${env:DOCKER_HOST_IP}:3000
         working-directory: test
 
-      - run: python3 -m pip install pytest -c requirements.txt
+      - run: ${{ env.PIP_COMMAND }} install pytest -c requirements.txt
         working-directory: test
         shell: bash
 
-      - run: python3 -m pytest new_tests/
+      - run: echo PYTHON_M_COMMAND=${{ matrix.python-tag == 'cp313t' && 'uv run --module' || 'python3 -m' }} >> $GITHUB_ENV
+        shell: bash
+
+      - run: ${{ env.PYTHON_M_COMMAND }} pytest new_tests/
         working-directory: test
         shell: bash
 

.github/workflows/tests.yml

@@ -44,7 +44,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        py-version: ["3.8", "3.9", "3.10", "3.11", "3.12"]
+        py-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13"]
       fail-fast: false
 
     steps: