Merge remote-tracking branch 'origin/main' into refactor-tests

Author: JakubAndrysek

.github/workflows/ci.yaml

@@ -9,8 +9,10 @@ on:
 jobs:
     test:
         strategy:
+            fail-fast: false
             matrix:
                 py: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+
         runs-on: ubuntu-24.04
         steps:
             - uses: actions/checkout@v4
@@ -24,5 +26,6 @@ jobs:
             - name: Run a Wokwi CI server
               uses: wokwi/wokwi-ci-server-action@v1
             - run: hatch run dev:pytest
+              if: env.WOKWI_CLI_TOKEN != ''
               env:
                   WOKWI_CLI_TOKEN: ${{ secrets.WOKWI_CLI_TOKEN }}

src/wokwi_client/client.py

@@ -4,8 +4,9 @@
 
 import base64
 from pathlib import Path
-from typing import Any, Optional, Union
+from typing import Any, Optional, Union, cast
 
+from wokwi_client.exceptions import ProtocolError
 from wokwi_client.framebuffer import (
     read_framebuffer_png_bytes,
     save_framebuffer_png,
@@ -256,9 +257,17 @@ async def listen_pin(self, part: str, pin: str, listen: bool = True) -> Response
         """
         return await pin_listen(self._transport, part=part, pin=pin, listen=listen)
 
-    async def gpio_list(self) -> ResponseMessage:
-        """Get a list of all GPIO pins available in the simulation."""
-        return await gpio_list(self._transport)
+    async def gpio_list(self) -> list[str]:
+        """Get a list of all GPIO pins available in the simulation.
+
+        Returns:
+            list[str]: Example: ["esp32:GPIO0", "esp32:GPIO1", ...]
+        """
+        resp = await gpio_list(self._transport)
+        pins_val: Any = resp.get("result", {}).get("pins")
+        if not isinstance(pins_val, list) or not all(isinstance(p, str) for p in pins_val):
+            raise ProtocolError("Malformed gpio:list response: expected result.pins: list[str]")
+        return cast(list[str], pins_val)
 
     async def set_control(
         self, part: str, control: str, value: Union[int, bool, float]