Merge branch 'master' into min_version

Author: marscher

.azure/build.yml

@@ -1,4 +1,14 @@
 # JPype CI pipeline
+
+# NOTE: 
+# - Some commented-out sections (e.g., Python 3.14, JDK 22) are placeholders for future versions.
+#   These will be activated once the corresponding tools are available on Azure (usually ~4 months after release).
+# - Debug jobs are only activated when issues cannot be replicated locally; otherwise, they remain disabled.
+# - macOS coverage is limited to the oldest and newest supported Python/JDK versions, as most issues are platform-independent and our primary support is for Linux.
+# - We only test against LTS (Long-Term Support) JDK releases, as newer versions (e.g., JDK 22) are not yet available on Azure.
+# - Fast tests are enabled on macOS to avoid long build times, especially for tests with high overhead (e.g., leak checkers).
+# - Documentation jobs are run only on Ubuntu, since documentation generation is OS-agnostic and only needs to be validated for HTML publication.
+
 trigger:
   branches:
     include:
@@ -7,9 +17,9 @@ trigger:
   paths:
     include:
     - .azure/build.yml
+    - pyproject.toml
+    - CMakeLists.txt
     - doc/*
-    - setup.py
-    - setupext/*
     - jpype/*
     - native/*
     - test/*
@@ -18,8 +28,10 @@ variables:
 # indicate whether the testsuite should skip long-running tests or not.
 - name: jpypetest.fast
   value: 'false'
-- name: system.debug
-  value: 'true'
+
+# shall Azure Pipeline verbose debugging output be turned on?
+#- name: system.debug
+#  value: 'true'
 
 jobs:
 - job: Deps
@@ -49,14 +61,20 @@ jobs:
   - template: scripts/tracing.yml
 
 - job: Test
+  variables:
+  # TODO: do we really need this, or can pip cache handle the slash as path?
+#  - ${{ if eq( variables['Agent.OS'], 'Windows_NT') }}:
+#      - name: PIP_CACHE_DIR
+#        value: $(Pipeline.Workspace)\.pip_cache
+#
+#  - ${{ if ne( variables['Agent.OS'], 'Windows_NT') }}:
+      - name: PIP_CACHE_DIR
+        value: $(Pipeline.Workspace)/.pip_cache
+
   dependsOn: Deps
   strategy:
     matrix:
       # Linux
-      linux_py38_jdk11:  # todo: 3.8 will be EOL on October 31, 2024
-        imageName: "ubuntu-latest"
-        python.version: '3.8'
-        jdk.version: '11'
       linux_py39_jdk11:
         imageName: "ubuntu-latest"
         python.version: '3.9'
@@ -76,40 +94,37 @@ jobs:
       linux_py313_jdk17:
         imageName: "ubuntu-latest"
         python.version: "3.13"
-        jdk.version: '17' # jdk 22 is not there yet.
-      #linux_py314_jdk22:
-      #  imageName: "ubuntu-latest"
-      #  python.version: "3.14.0-alpha.0"
-      #  jdk.version: '22'
+        jdk.version: '17'
+# todo: refresh github token to download python versions.
+#      linux_py314_jdk22:
+#        imageName: "ubuntu-latest"
+#        python.version: "3.14"
+#        jdk.version: '25'
       # Windows
-      windows_py38_jdk11:
-        imageName: "windows-2019"
-        python.version: '3.8' # todo: 3.8 will be EOL on October 31, 2024
-        jdk.version: '11'
       windows_py39_jdk11:
-        imageName: "windows-2019"
+        imageName: "windows-2022"
         python.version: '3.9'
         jdk.version: '11'
       windows_py310_jdk11:
-        imageName: "windows-2019"
+        imageName: "windows-2022"
         python.version: '3.10'
         jdk.version: '11'
       windows_py311_jdk17:
-        imageName: "windows-2019"
+        imageName: "windows-2022"
         python.version: '3.11'
         jdk.version: '17'
       windows_py312_jdk21:
-        imageName: "windows-2019"
+        imageName: "windows-2022"
         python.version: '3.12'
         jdk.version: '21'
       # OSX, we only test an old Python version with JDK8 and recent Py with recent JDK.
-      mac_py38_jdk11:
-        imageName: "macos-13"
-        python.version: '3.8' # todo: 3.8 will be EOL on October 31, 2024
+      mac_py39_jdk11:
+        imageName: "macos-14"
+        python.version: '3.9'
         jpypetest.fast: 'true'
         jdk.version: '11'
       mac_py312_jdk17:
-        imageName: "macos-13"
+        imageName: "macos-latest"
         python.version: '3.12'
         jpypetest.fast: 'true'
         jdk.version: '17'
@@ -118,6 +133,7 @@ jobs:
     vmImage: $(imageName)
   steps:
 
+  - template: scripts/pip-caching.yml
   - template: scripts/deps.yml
   - template: scripts/test.yml
 
@@ -129,7 +145,7 @@ jobs:
       linux_py38_jdk11:
         imageName: "ubuntu-16.04"
         jdk.version: "11"
-        python.version: '3.8'
+        python.version: '3.9'
   pool:
     vmImage: $(imageName)
   steps:

.azure/check.sh

@@ -0,0 +1,50 @@
+#!/bin/bash
+
+# Script to verify the integrity of Python wheel files after downloading.
+# Prevents the high cost of publishing a bad wheel.
+
+# Ensure 'wheel' is installed
+pip show wheel >/dev/null 2>&1 || pip install wheel
+
+for whl in *.whl; do
+    echo "======================================"
+    echo "Checking wheel: $whl"
+    echo "--------------------------------------"
+    
+    # 1. List contents
+    unzip -l "$whl"
+    
+    # 2. Unpack wheel and capture output to get directory name
+    unpack_output=$(python3 -m wheel unpack "$whl")
+    echo "$unpack_output"
+    unpack_dir=$(echo "$unpack_output" | grep "Unpacking to:" | sed 's/Unpacking to: //' | sed 's/\.\.\..*//')
+    unpack_dir=$(echo "$unpack_dir" | xargs)  # trim whitespace
+
+    # 3. Check for METADATA and WHEEL files
+    dist_info_dir=$(find "$unpack_dir" -type d -name "*.dist-info" | head -n 1)
+    if [ -n "$dist_info_dir" ]; then
+        echo "Found dist-info directory: $dist_info_dir"
+        if [ -f "$dist_info_dir/METADATA" ]; then
+            echo "METADATA file present."
+        else
+            echo "WARNING: METADATA file missing!"
+        fi
+        if [ -f "$dist_info_dir/WHEEL" ]; then
+            echo "WHEEL file present."
+        else
+            echo "WARNING: WHEEL file missing!"
+        fi
+    else
+        echo "WARNING: dist-info directory not found!"
+    fi
+
+    # 4. Auditwheel check (if available)
+    if command -v auditwheel >/dev/null 2>&1; then
+        auditwheel show "$whl"
+    fi
+
+    # Clean up unpacked directory
+    rm -rf "$unpack_dir"
+    echo "======================================"
+    echo
+done

.azure/doc-requirements.txt

@@ -1,8 +1,7 @@
-# TODO: consider unpinning these?
-Pygments==2.15.0
-docutils==0.14
-commonmark==0.8.1
-recommonmark==0.5.0
+Pygments
+docutils
+commonmark
+recommonmark
 sphinx
 sphinx-rtd-theme
 readthedocs-sphinx-ext