Add uv-managed Ruff lint and ty type checks

.github/workflows/pr-lint-typecheck.yml

@@ -0,0 +1,35 @@
+name: PR Lint and Type Check
+
+on:
+  pull_request:
+    paths:
+      - ".github/workflows/pr-lint-typecheck.yml"
+      - "pyproject.toml"
+      - "uv.lock"
+      - "stackchan_server/**"
+      - "example_apps/**"
+
+jobs:
+  lint-and-typecheck:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install dependencies
+        run: uv sync --group dev --group example-gemini --frozen
+
+      - name: Ruff
+        run: uv run ruff check stackchan_server example_apps
+
+      - name: ty
+        run: uv run ty check stackchan_server example_apps

README.md

@@ -67,6 +67,17 @@ async def talk_session(proxy: WsProxy):
 ```
 
 
+
+## Lint / Type Check
+
+`stackchan_server/` と `example_apps/` を対象に、`uv` で Ruff と ty を実行できます。
+
+```bash
+uv sync --group dev --group example-gemini
+uv run ruff check stackchan_server example_apps
+uv run ty check stackchan_server example_apps
+```
+
 ## 現在開発中の環境
 
 - 本体: M5Stack CoreS3 SE

example_apps/gemini.py

@@ -1,13 +1,13 @@
 from __future__ import annotations
 
-import asyncio
 from logging import StreamHandler, getLogger
 
-from stackchan_server.app import StackChanApp
-from stackchan_server.ws_proxy import WsProxy
 from google import genai
 from google.genai import types
 
+from stackchan_server.app import StackChanApp
+from stackchan_server.ws_proxy import WsProxy
+
 logger = getLogger(__name__)
 logger.addHandler(StreamHandler())
 logger.setLevel("DEBUG")

pyproject.toml

@@ -9,17 +9,25 @@ description = "A WebSocket control interface for StackChan AI agent"
 readme = "README.md"
 requires-python = ">=3.13"
 dependencies = [
-    "fastapi[websockets]>=0.128.0",
+    "fastapi>=0.128.0",
     "google-cloud-speech>=2.35.0",
     "uvicorn[standard]>=0.40.0",
     "voicevox-client>=1.1.0",
 ]
 
 [dependency-groups]
+dev = [
+    "ruff>=0.15.2",
+    "ty>=0.0.17",
+]
 example-gemini = [
     "google-genai>=1.59.0",
 ]
 
+[tool.ruff]
+target-version = "py313"
+
+
 [tool.hatch.build.targets.wheel]
 packages = ["stackchan_server"]
 

stackchan_server/ws_proxy.py

@@ -6,7 +6,7 @@
 import struct
 import wave
 from contextlib import suppress
-from datetime import datetime
+from datetime import UTC, datetime
 from enum import IntEnum
 from logging import getLogger
 from pathlib import Path
@@ -380,7 +380,7 @@ async def _send_state_command(self, state_id: int | FirmwareState) -> None:
         self._down_seq += 1
 
     def _save_wav(self, pcm_bytes: bytes) -> tuple[Path, str]:
-        timestamp = datetime.utcnow().strftime("%Y%m%d_%H%M%S_%f")
+        timestamp = datetime.now(UTC).strftime("%Y%m%d_%H%M%S_%f")
         filename = f"rec_ws_{timestamp}.wav"
         filepath = self.recordings_dir / filename