add CI workflow for utils package tests

- Add .github/workflows/utils.yml with unit and integration test jobs
- Use localstack.utils.net.wait_for_port_open instead of custom implementation

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: whummer

.github/workflows/utils.yml

@@ -0,0 +1,68 @@
+name: LocalStack Extensions Utils Tests
+
+on:
+  push:
+    paths:
+      - utils/**
+    branches:
+      - main
+  pull_request:
+    paths:
+      - .github/workflows/utils.yml
+      - utils/**
+  workflow_dispatch:
+
+jobs:
+  unit-tests:
+    name: Run Unit Tests
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: |
+          cd utils
+          pip install -e .[dev,test]
+
+      - name: Lint
+        run: |
+          cd utils
+          make lint
+
+      - name: Run unit tests
+        run: |
+          cd utils
+          make test-unit
+
+  integration-tests:
+    name: Run Integration Tests
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: |
+          cd utils
+          pip install -e .[dev,test]
+
+      - name: Pull grpcbin image
+        run: docker pull moul/grpcbin
+
+      - name: Run integration tests
+        run: |
+          cd utils
+          make test-integration

utils/tests/integration/conftest.py

@@ -7,34 +7,16 @@
 
 import subprocess
 import time
-import socket
 import pytest
 
+from localstack.utils.net import wait_for_port_open
+
 
 GRPCBIN_IMAGE = "moul/grpcbin"
 GRPCBIN_INSECURE_PORT = 9000  # HTTP/2 without TLS
 GRPCBIN_SECURE_PORT = 9001  # HTTP/2 with TLS
 
 
-def is_port_open(host: str, port: int, timeout: float = 1.0) -> bool:
-    """Check if a port is open and accepting connections."""
-    try:
-        with socket.create_connection((host, port), timeout=timeout):
-            return True
-    except (socket.timeout, socket.error, ConnectionRefusedError, OSError):
-        return False
-
-
-def wait_for_port(host: str, port: int, timeout: float = 30.0) -> bool:
-    """Wait for a port to become available."""
-    start_time = time.time()
-    while time.time() - start_time < timeout:
-        if is_port_open(host, port):
-            return True
-        time.sleep(0.5)
-    return False
-
-
 @pytest.fixture(scope="session")
 def grpcbin_container():
     """
@@ -92,7 +74,9 @@ def grpcbin_container():
     container_id = result.stdout.strip()
 
     # Wait for the insecure port to be ready
-    if not wait_for_port("localhost", GRPCBIN_INSECURE_PORT, timeout=30):
+    try:
+        wait_for_port_open(GRPCBIN_INSECURE_PORT, retries=60, sleep_time=0.5)
+    except Exception:
         # Clean up and fail
         subprocess.run(["docker", "rm", "-f", container_name], capture_output=True)
         pytest.fail(f"grpcbin port {GRPCBIN_INSECURE_PORT} did not become available")