feat: free-threaded Python (3.13.0+) support

.github/workflows/build.yml

@@ -169,7 +169,7 @@ jobs:
           - { machine: 'ubuntu-20.04', python: '3.13t', java: '8', arch: 'amd64', cmd: '.github/env/Linux/bdist-wheel.sh' }
           - { machine: 'windows-2022', python: '3.13t', java: '8', arch: 'amd64', cmd: '.\.github\env\Windows\bdist-wheel.ps1' }
           - { machine: 'macos-13', python: '3.13t', java: '8', arch: 'amd64', cmd: '.github/env/macOS/bdist-wheel.sh' }
-          - { machine: 'macos-latest', python: '3.13t', java: '11', arch: 'arm64', cmd: '.github/env/macOS/bdist-wheel.sh' }
+          - { machine: 'macos-14', python: '3.13t', java: '11', arch: 'arm64', cmd: '.github/env/macOS/bdist-wheel.sh' }
 
     steps:
       - uses: actions/checkout@v4

.github/workflows/check.yml

@@ -61,7 +61,7 @@ jobs:
             source .venv/bin/activate
             uv pip install pip
             echo $JAVA_HOME
-            echo PATH=$PATH >> $GITHUB_ENV
+            echo PATH=$PATH >> $GITHUB_PATH
 
         - run: pip install "setuptools < 72"
 

jpyutil.py

@@ -331,11 +331,8 @@ def _find_python_dll_file(fail=False):
     # Prepare list of possible library file names
 
     # account for Python debug builds
-    try:
-        sys.gettotalrefcount()
-        debug_build = True
-    except AttributeError:
-        debug_build = False
+
+    debug_build = sysconfig.get_config_var('Py_DEBUG')
 
     # account for Python 3.13+ with GIL disabled
     dll_suffix = ''

src/main/c/jni/org_jpy_PyLib.c

@@ -499,7 +499,7 @@ void dumpDict(const char* dictName, PyObject* dict)
 
     size = PyDict_Size(dict);
     printf(">> dumpDict: %s.size = %ld\n", dictName, size);
-#ifdef Py_GIL_DISABLED
+#if PY_VERSION_HEX >= 0x030D0000 // >=3.13
     // PyDict_Next is not thread-safe, so we need to protect it with a critical section
     // https://docs.python.org/3/howto/free-threading-extensions.html#pydict-next
     Py_BEGIN_CRITICAL_SECTION(dict);
@@ -510,7 +510,7 @@ void dumpDict(const char* dictName, PyObject* dict)
         printf(">> dumpDict: %s[%ld].name = '%s'\n", dictName, i, name);
         i++;
     }
-#ifdef Py_GIL_DISABLED
+#if PY_VERSION_HEX >= 0x030D0000 // >=3.13
     Py_END_CRITICAL_SECTION();
 #endif
 }

src/main/java/org/jpy/PyObject.java

@@ -58,7 +58,7 @@ private static void startCleanupThread() {
     }
 
     public static int cleanup() {
-        return REFERENCES.asProxy().cleanupOnlyUseFromGIL();
+        return REFERENCES.asProxy().threadSafeCleanup();
     }
 
     private final PyObjectState state;
@@ -71,8 +71,8 @@ public static int cleanup() {
     PyObject(long pointer, boolean fromJNI) {
         state = new PyObjectState(pointer);
         if (fromJNI) {
-            if (CLEANUP_ON_INIT && PyLib.hasGil()) {
-                REFERENCES.cleanupOnlyUseFromGIL(); // only performs *one* cleanup
+            if (CLEANUP_ON_INIT) {
+                REFERENCES.threadSafeCleanup(); // only performs *one* cleanup
             }
             if (CLEANUP_ON_THREAD) {
                 // ensures that we've only started after python has been started, and we know there is something to cleanup

src/main/java/org/jpy/PyObjectCleanup.java

@@ -1,5 +1,5 @@
 package org.jpy;
 
 interface PyObjectCleanup {
-    int cleanupOnlyUseFromGIL();
+    int threadSafeCleanup();
 }

src/main/java/org/jpy/PyObjectReferences.java

@@ -76,11 +76,11 @@ private Reference<PyObject> asRef(PyObject pyObject) {
     /**
      * This should *only* be invoked through the proxy, or when we *know* we have the GIL.
      */
-    public int cleanupOnlyUseFromGIL() {
-        return cleanupOnlyUseFromGIL(buffer);
+    public int threadSafeCleanup() {
+        return threadSafeCleanup(buffer);
     }
 
-    private int cleanupOnlyUseFromGIL(long[] buffer) {
+    private int threadSafeCleanup(long[] buffer) {
         return PyLib.ensureGil(() -> {
             int index = 0;
             while (index < buffer.length) {
@@ -164,7 +164,7 @@ def cleanup(references):
                 // any fairness guarantees. As such, we need to be mindful of other python users/code,
                 // and ensure we don't overly acquire the GIL causing starvation issues, especially when
                 // there is no cleanup work to do.
-                final int size = proxy.cleanupOnlyUseFromGIL();
+                final int size = proxy.threadSafeCleanup();
 
 
                 // Although, it *does* make sense to potentially take the GIL in a tight loop when there