Add Windows ARM64 support

- objectbox-clib: win_arm64 wheel with the ARM64 library (objectbox-c 5.x)
- Windows: select the library by the interpreter's architecture (sysconfig.get_platform()),
  e.g. x64 Python (emulated) on Windows ARM64 needs the x64 library
- GitHub Actions: test on Windows ARM64 (windows-11-arm, Python 3.12)

Author: greenrobot

.github/workflows/test.yaml

@@ -16,7 +16,11 @@ jobs:
           python: "3.7" # Prevent "The version '3.7' with architecture 'arm64' was not found for macOS 14.4.1"
         - os: "ubuntu"
           python: "3.7" # Python 3.7 is not available in ubuntu-latest i.e. version 24.04
-    runs-on: ${{ matrix.os }}-latest
+        include:
+        - os: "windows-arm64"
+          runner: "windows-11-arm" # Python for Windows ARM64 is available from 3.11
+          python: "3.12"
+    runs-on: ${{ matrix.runner || format('{0}-latest', matrix.os) }}
 
     steps:
       - uses: actions/checkout@v7

AGENTS.md

@@ -46,4 +46,4 @@ Two pip packages are built from this repository:
 
 ## CI
 
-GitHub Actions (`.github/workflows/test.yaml`) runs `make depend && make test` on Linux/Windows/macOS for Python 3.7–3.12, so code must stay compatible with Python 3.7. GitLab CI (`.gitlab-ci.yml`) builds the wheels with `make depend test build` on Linux x64, then tests the built `objectbox` wheel (installed in place of the source packages, which are deleted; the platform's `objectbox-clib` wheel is picked via `--find-links dist`) on Linux x64 (Python 3.7–3.12 Docker images), Linux armv7hf and aarch64, macOS (arm64 runner; the macOS library is universal) and Windows x64.
+GitHub Actions (`.github/workflows/test.yaml`) runs `make depend && make test` on Linux/Windows/macOS for Python 3.7–3.12 (plus Windows ARM64 with Python 3.12), so code must stay compatible with Python 3.7. GitLab CI (`.gitlab-ci.yml`) builds the wheels with `make depend test build` on Linux x64, then tests the built `objectbox` wheel (installed in place of the source packages, which are deleted; the platform's `objectbox-clib` wheel is picked via `--find-links dist`) on Linux x64 (Python 3.7–3.12 Docker images), Linux armv7hf and aarch64, macOS (arm64 runner; the macOS library is universal) and Windows x64.

CHANGELOG.md

@@ -5,11 +5,12 @@ ObjectBox Python ChangeLog
 --------------------
 
 * Update to ObjectBox C library 5.3.2 (was 4.0.0), see https://github.com/objectbox/objectbox-c/blob/main/CHANGELOG.md;
+* New platform: Windows ARM64 (64-bit ARM, e.g. Snapdragon-based devices)
 * Log callback (`log_callback`): the log level values passed to the callback changed (see `LogLevel`, now also `Trace`);
   code comparing against `LogLevel` members is not affected.
 * The ObjectBox C library is now a separate package, `objectbox-clib`, which is installed automatically as a dependency.
   There is a wheel for each platform, so only the library for your platform is downloaded (was: libraries for all platforms):
-  Linux x86_64, aarch64 and armv7l (glibc 2.28+), macOS 11+ (universal) and Windows x64.
+  Linux x86_64, aarch64 and armv7l (glibc 2.28+), macOS 11+ (universal) and Windows x64 and ARM64 (new).
   **Breaking:** Linux ARMv6hf (e.g. Raspberry Pi Zero/1) is no longer supported, as PyPI does not support wheels for it.
 * Linux: support 32-bit Python on a 64-bit kernel, e.g. Raspberry Pi OS 32-bit on a Raspberry Pi 4/5
   (64-bit kernel by default); this failed to load the library before.

README.md

@@ -35,6 +35,7 @@ Feature Highlights
 * Linux ARMv8   (e.g. Raspberry PI 4, 5, etc.)
 * MacOS x86-64 and arm64 (Intel 64-bit and Apple Silicon)
 * Windows x86-64 (64-bit)
+* Windows ARM64
 
 Code Example: CRUD (Create, Read, Update, Delete)
 -------------------------------------------------

download-c-lib.py

@@ -29,6 +29,7 @@
 
     # windows
     "AMD64/objectbox.dll": "windows-x64.zip",
+    "ARM64/objectbox.dll": "windows-arm64.zip",
 }
 
 def url_for(rel_path: str) -> str:

objectbox/c.py

@@ -17,6 +17,7 @@
 import os
 import platform
 import sys
+import sysconfig
 from objectbox.version import Version
 from typing import *
 import numpy as np
@@ -47,6 +48,11 @@ def lib_dir_name() -> str:
     """Returns the name of the library directory (inside objectbox_clib/lib) for the current platform."""
     if platform.system() == 'Darwin':
         return 'macos-universal'
+    if platform.system() == 'Windows':
+        # Use the architecture the Python interpreter was built for (derived from sys.version), e.g. "win-arm64";
+        # the library must match the Python process, which may differ from the OS (e.g. x64 Python on Windows ARM64).
+        windows_dirs = {'win-amd64': 'AMD64', 'win-arm64': 'ARM64'}
+        return windows_dirs.get(sysconfig.get_platform(), platform.machine())
     machine = platform.machine()
     # platform.machine() reports the kernel's architecture, but the library must match the (Python) process.
     # These differ for a 32-bit Python on a 64-bit kernel, e.g. Raspberry Pi OS 32-bit on a Raspberry Pi 4/5

objectbox_clib/README.md

@@ -9,7 +9,7 @@ pip install objectbox
 ```
 
 There is a wheel for each supported platform, so only the library for your platform is installed:
-Linux x86_64, aarch64 and armv7l (glibc 2.28+), macOS 11+ (Intel and Apple Silicon) and Windows x64.
+Linux x86_64, aarch64 and armv7l (glibc 2.28+), macOS 11+ (Intel and Apple Silicon) and Windows (x64 and ARM64).
 
 The version of this package is the version of the ObjectBox C library it contains.
 

setup-clib.py

@@ -29,6 +29,7 @@
     "manylinux_2_28_armv7l": "armv7l",
     "macosx_11_0_universal2": "macos-universal",
     "win_amd64": "AMD64",
+    "win_arm64": "ARM64",
 }
 
 

tests/test_clib_package.py

@@ -40,17 +40,20 @@ def test_clib_platform_wheel():
         "Only the library for this platform shall be installed"
 
 
-@pytest.mark.parametrize("system, machine, maxsize, expected", [
-    ("Linux", "x86_64", 2 ** 63 - 1, "x86_64"),
-    ("Linux", "aarch64", 2 ** 63 - 1, "aarch64"),
-    ("Linux", "aarch64", 2 ** 31 - 1, "armv7l"),  # 32-bit Python on a 64-bit kernel (e.g. Raspberry Pi OS 32-bit)
-    ("Linux", "armv7l", 2 ** 31 - 1, "armv7l"),
-    ("Windows", "AMD64", 2 ** 63 - 1, "AMD64"),
-    ("Darwin", "arm64", 2 ** 63 - 1, "macos-universal"),
-    ("Darwin", "x86_64", 2 ** 63 - 1, "macos-universal"),
+@pytest.mark.parametrize("system, machine, maxsize, sys_platform, expected", [
+    ("Linux", "x86_64", 2 ** 63 - 1, "linux-x86_64", "x86_64"),
+    ("Linux", "aarch64", 2 ** 63 - 1, "linux-aarch64", "aarch64"),
+    ("Linux", "aarch64", 2 ** 31 - 1, "linux-aarch64", "armv7l"),  # 32-bit Python on a 64-bit kernel (e.g. Raspberry Pi OS 32-bit)
+    ("Linux", "armv7l", 2 ** 31 - 1, "linux-armv7l", "armv7l"),
+    ("Windows", "AMD64", 2 ** 63 - 1, "win-amd64", "AMD64"),
+    ("Windows", "ARM64", 2 ** 63 - 1, "win-arm64", "ARM64"),
+    ("Windows", "ARM64", 2 ** 63 - 1, "win-amd64", "AMD64"),  # x64 Python (emulated) on Windows ARM64
+    ("Darwin", "arm64", 2 ** 63 - 1, "macosx-11.0-arm64", "macos-universal"),
+    ("Darwin", "x86_64", 2 ** 63 - 1, "macosx-11.0-x86_64", "macos-universal"),
 ])
-def test_lib_dir_name(monkeypatch, system, machine, maxsize, expected):
+def test_lib_dir_name(monkeypatch, system, machine, maxsize, sys_platform, expected):
     monkeypatch.setattr(c.platform, "system", lambda: system)
     monkeypatch.setattr(c.platform, "machine", lambda: machine)
     monkeypatch.setattr(c.sys, "maxsize", maxsize)
+    monkeypatch.setattr(c.sysconfig, "get_platform", lambda: sys_platform)
     assert c.lib_dir_name() == expected