feature: Add Python 3.14/3.14t builds (#15)

Author: achimnol

.github/workflows/ci.yml

@@ -20,7 +20,7 @@ jobs:
           {os: "ubuntu-22.04", arch: "x86_64", etcd_arch: "amd64"},
           {os: "ubuntu-22.04-arm", arch: "aarch64", etcd_arch: "arm64"},
         ]
-        python-version: ["3.11", "3.12", "3.13"]
+        python-version: ["3.11", "3.12", "3.13", "3.14", "3.14t"]
     runs-on: ${{ matrix.platform.os }}
     steps:
     - name: Checkout the revision
@@ -29,6 +29,7 @@ jobs:
       uses: actions/setup-python@v5
       with:
         python-version: ${{ matrix.python-version }}
+        allow-prereleases: true
     - name: Set up Rust toolchain
       uses: actions-rust-lang/setup-rust-toolchain@v1
       with:
@@ -59,7 +60,43 @@ jobs:
           {os: "ubuntu-22.04-arm", arch: "aarch64", maturin_arch: "aarch_64"},
         ]
         manylinux: ["manylinux2014"]
-        python-version: ["3.11", "3.12", "3.13"]
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
+    runs-on: ${{ matrix.platform.os }}
+    steps:
+      - name: Checkout the revision
+        uses: actions/checkout@v4
+      - name: Build the wheel
+        uses: PyO3/maturin-action@v1
+        env:
+          PROTOC: /home/runner/.local/bin/protoc
+        with:
+          command: build
+          args: --release -o dist -i python${{ matrix.python-version }}
+          before-script-linux: |
+            PB_REL="https://github.com/protocolbuffers/protobuf/releases"
+            curl -LO $PB_REL/download/v23.2/protoc-23.2-linux-${{ matrix.platform.maturin_arch }}.zip
+            unzip protoc-23.2-linux-${{ matrix.platform.maturin_arch }}.zip -d $HOME/.local
+            export PATH="$PATH:$HOME/.local/bin"
+          manylinux: ${{ matrix.manylinux }}
+          target: ${{ matrix.platform.arch }}
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.manylinux }}-${{ matrix.platform.arch }}-${{ matrix.python-version }}
+          path: dist
+
+  release-linux-freethreaded:
+    if: github.event_name == 'push' && contains(github.ref, 'refs/tags/')
+    needs: test
+    strategy:
+      fail-fast: false
+      matrix:
+        platform: [
+          {os: "ubuntu-22.04", arch: "x86_64", maturin_arch: "x86_64"},
+          {os: "ubuntu-22.04-arm", arch: "aarch64", maturin_arch: "aarch_64"},
+        ]
+        manylinux: ["manylinux2014"]
+        python-version: ["3.14t"]
     runs-on: ${{ matrix.platform.os }}
     steps:
       - name: Checkout the revision
@@ -91,7 +128,32 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.11", "3.12", "3.13"]
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - name: Checkout the revision
+        uses: actions/checkout@v4
+      - name: Install prerequisites
+        run: |
+          brew install protobuf
+      - name: Build the wheel
+        uses: PyO3/maturin-action@v1
+        with:
+          command: build
+          args: --release -o dist --target universal2-apple-darwin -i python${{ matrix.python-version }}
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-macos-universal2-${{ matrix.python-version }}
+          path: dist/*
+
+  release-macos-freethreaded:
+    if: github.event_name == 'push' && contains(github.ref, 'refs/tags/')
+    needs: test
+    runs-on: macos-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.14t"]
     steps:
       - name: Checkout the revision
         uses: actions/checkout@v4
@@ -132,7 +194,7 @@ jobs:
           path: dist
 
   publish-to-pypi:
-    needs: [release-linux, release-macos, release-source]
+    needs: [release-linux, release-linux-freethreaded, release-macos, release-macos-freethreaded, release-source]
     environment: deploy-to-pypi
     permissions:
       id-token: write

Cargo.lock

@@ -11,8 +11,8 @@ crate-type = ["cdylib"]
 
 [dependencies]
 etcd-client = "0.16.1"
-pyo3 = { version = "0.25.1", features = ["extension-module", "multiple-pymethods"] }
-pyo3-async-runtimes = { version = "0.25.0", features = ["attributes", "tokio-runtime"] }
+pyo3 = { version = "0.27.2", features = ["extension-module", "multiple-pymethods"] }
+pyo3-async-runtimes = { version = "0.27.0", features = ["attributes", "tokio-runtime"] }
 scopeguard = "1.2.0"
 tokio = { version = "1.46.1", features = ["sync"] }
 tokio-stream = "0.1.17"

Cargo.toml

@@ -14,13 +14,18 @@ authors = [
 ]
 classifiers = [
   "Development Status :: 4 - Beta",
-  "Programming Language :: Python"
+  "Programming Language :: Python",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
 ]
 
 [project.urls]
 homepage = "https://github.com/lablup/etcd-client-py"
 repository = "https://github.com/lablup/etcd-client-py"
 
 [build-system]
-requires = ["maturin>=1.0,<2.0"]
+requires = ["maturin>=1.7,<2.0"]
 build-backend = "maturin"

pyproject.toml

@@ -1,4 +1,4 @@
-maturin==1.9.1
+maturin==1.10.2
 pytest~=8.4.1
 pytest-asyncio~=1.1.0
 trafaret~=2.1

requirements.txt

@@ -27,7 +27,7 @@ impl PyCompareOp {
         }
     }
 
-    pub fn __richcmp__(&self, py: Python, rhs: &PyCompareOp, op: PyO3CompareOp) -> PyResult<PyObject> {
+    pub fn __richcmp__(&self, py: Python, rhs: &PyCompareOp, op: PyO3CompareOp) -> PyResult<Py<PyAny>> {
         match op {
             PyO3CompareOp::Eq => (self.0 == rhs.0)
                 .into_pyobject(py)

src/compare.rs

@@ -45,7 +45,7 @@ pub struct PyClientError(pub etcd_client::Error);
 impl From<PyClientError> for PyErr {
     fn from(error: PyClientError) -> Self {
         match &error.0 {
-            etcd_client::Error::GRpcStatus(e) => Python::with_gil(|py| {
+            etcd_client::Error::GRpcStatus(e) => Python::attach(|py| {
                 let error_details = PyDict::new(py);
                 error_details.set_item("code", e.code() as u64).unwrap();
                 error_details
@@ -55,7 +55,7 @@ impl From<PyClientError> for PyErr {
                     .set_item("message", e.message().to_owned())
                     .unwrap();
 
-                let kv_args: PyObject = error_details.into();
+                let kv_args: Py<PyAny> = error_details.unbind().into_any();
                 GRPCStatusError::new_err(kv_args)
             }),
             etcd_client::Error::InvalidArgs(e) => {

src/error.rs

@@ -83,7 +83,7 @@ impl PyWatch {
         self.clone()
     }
 
-    fn __anext__<'a>(&'a mut self, py: Python<'a>) -> PyResult<Option<PyObject>> {
+    fn __anext__<'a>(&'a mut self, py: Python<'a>) -> PyResult<Option<Py<PyAny>>> {
         let watch = Arc::new(Mutex::new(self.clone()));
         let event_stream_init_notifier = self.event_stream_init_notifier.clone();
         let watcher = self.watcher.clone();

src/watch.rs

@@ -39,7 +39,7 @@ impl PyWatchEvent {
         )
     }
 
-    fn __richcmp__(&self, py: Python, other: &Self, op: CompareOp) -> PyResult<PyObject> {
+    fn __richcmp__(&self, py: Python, other: &Self, op: CompareOp) -> PyResult<Py<PyAny>> {
         match op {
             CompareOp::Eq => (self == other)
                 .into_pyobject(py)
@@ -91,7 +91,7 @@ impl PyWatchEventType {
         }
     }
 
-    pub fn __richcmp__(&self, py: Python, rhs: &PyWatchEventType, op: CompareOp) -> PyResult<PyObject> {
+    pub fn __richcmp__(&self, py: Python, rhs: &PyWatchEventType, op: CompareOp) -> PyResult<Py<PyAny>> {
         match op {
             CompareOp::Eq => (self.0 == rhs.0)
                 .into_pyobject(py)