sok-ble 0.1.8__tar.gz → 0.1.9b2__tar.gz

sok_ble-0.1.9b2/.github/workflows/prerelease.yml

@@ -0,0 +1,105 @@
+name: Prerelease
+
+on:
+  pull_request:
+    branches: [main]
+    types: [opened]
+  workflow_dispatch:
+    inputs:
+      release_branch:
+        description: Branch to build from
+        required: false
+        default: release-please--branches--main
+      semantic_version:
+        description: Optional semantic version to publish (x.x.x)
+        required: false
+      prerelease:
+        description: Prerelease type (defaults to beta)
+        required: false
+        type: choice
+        options:
+          - beta
+          - alpha
+      beta_iteration:
+        description: Optional alpha/beta iteration identifier (defaults to run number)
+        required: false
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  publish-beta:
+    if: |
+      github.event_name == 'workflow_dispatch' ||
+      (github.event_name == 'pull_request' && startsWith(github.event.pull_request.head.ref, 'release-please--'))
+    runs-on: ubuntu-latest
+    environment: release
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: ${{ github.event_name == 'workflow_dispatch' && (inputs.release_branch || 'release-please--main') || github.event.pull_request.head.ref }}
+          fetch-depth: 0
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Set up Python
+        run: uv python install
+
+      - name: Derive beta version
+        id: version
+        env:
+          BETA_ITERATION: ${{ github.event_name == 'workflow_dispatch' && inputs.beta_iteration || '' }}
+          SEMANTIC_VERSION: ${{ github.event_name == 'workflow_dispatch' && inputs.semantic_version || '' }}
+          PRERELEASE_ID: ${{ github.event_name == 'workflow_dispatch' && inputs.prerelease || '' }}
+        run: |
+          python - <<'PY'
+          from pathlib import Path
+          import os
+          import re
+          import sys
+
+          pyproject = Path("pyproject.toml")
+          content = pyproject.read_text(encoding="utf-8")
+
+          match = re.search(r'^version\s*=\s*"(?P<version>[^"]+)"', content, flags=re.MULTILINE)
+          if not match:
+            sys.exit("Version not found in pyproject.toml")
+
+          semver_input = os.environ.get("SEMANTIC_VERSION", "").strip()
+          prerelease_input = os.environ.get("PRERELEASE_ID", "").strip().lower()
+          prerelease_map = {"alpha": "a", "beta": "b", "a": "a", "b": "b"}
+          if prerelease_input and prerelease_input not in prerelease_map:
+            sys.exit("Invalid prerelease identifier. Use 'alpha' or 'beta'.")
+
+          if semver_input:
+            if not re.fullmatch(r"\d+\.\d+\.\d+", semver_input):
+              sys.exit("Invalid semantic version. Use x.x.x format.")
+            base_version = semver_input
+          else:
+            base_version = match.group("version")
+
+          prerelease = prerelease_map.get(prerelease_input, "b")
+          iteration = os.environ.get("BETA_ITERATION") or os.environ.get("GITHUB_RUN_NUMBER")
+          beta_version = f"{base_version}{prerelease}{iteration}"
+
+          new_content = re.sub(
+            r'^version\s*=\s*".*"',
+            f'version = "{beta_version}"',
+            content,
+            count=1,
+            flags=re.MULTILINE,
+          )
+          pyproject.write_text(new_content, encoding="utf-8")
+
+          print(f"Publishing beta version {beta_version}")
+          with open(os.environ["GITHUB_OUTPUT"], "a", encoding="utf-8") as output:
+            output.write(f"beta_version={beta_version}\n")
+          PY
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish beta to PyPI
+        run: uv publish

{sok_ble-0.1.8 → sok_ble-0.1.9b2}/.github/workflows/release.yml

@@ -37,12 +37,12 @@ jobs:
       id-token: write
       contents: write
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@v7
 
       - name: Set up Python
         run: uv python install

{sok_ble-0.1.8 → sok_ble-0.1.9b2}/.github/workflows/test.yml

@@ -22,12 +22,13 @@ jobs:
           - "3.11"
           - "3.12"
           - "3.13"
+          - "3.14"
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Install uv and set the python version
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@v7
         with:
           python-version: ${{ matrix.python-version }}
 
@@ -42,3 +43,6 @@ jobs:
 
       - name: Lint with Ruff
         run: uv run ruff check . --output-format=github
+
+      - name: Type check with ty
+        run: uv run ty check . --output-format=github

sok_ble-0.1.9b2/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.1.9"
+}

sok_ble-0.1.8/.github/copilot-instructions.md → sok_ble-0.1.9b2/AGENTS.md

@@ -32,3 +32,36 @@ sok-ble is a library written in Python. Its purpose is to connect to SOK LiFePO4
 
 - Use conventional commits for all changes
   - Prefix all commit messages with fix:; feat:; build:; chore:; ci:; docs:; style:; refactor:; perf:; or test: as appropriate.
+
+# Before Checking In Code
+
+- Fix all code formatting and quality issues in the entire codebase.
+- Ensure all new code is covered by appropriate unit tests.
+
+## Python
+
+Fix all Python formatting and linting issues.
+
+### Steps:
+
+1. **Format with ruff**: `uv run ruff format .`
+2. **Lint with ruff**: `uv run ruff check . --output-format=github`
+3. **Type check with ty**: `uv run ty check . --output-format=github`
+4. **Run unit tests**: `uv run pytest tests`
+
+## General Process:
+
+1. Run automated formatters first.
+2. Fix remaining linting issues manually.
+3. Resolve type checking errors.
+4. Verify all tests pass with no errors.
+5. Review changes before committing.
+
+## Common Issues:
+
+- Import order conflicts between tools
+- Line length violations
+- Unused imports/variables
+- Type annotation requirements
+- Missing return types
+- Inconsistent quotes/semicolons

{sok_ble-0.1.8 → sok_ble-0.1.9b2}/CHANGELOG.md

@@ -1,6 +1,13 @@
 # CHANGELOG
 
 
+## [0.1.9](https://github.com/IAmTheMitchell/sok-ble/compare/v0.1.8...v0.1.9) (2026-02-05)
+
+
+### Documentation
+
+* update AI directives ([afb9309](https://github.com/IAmTheMitchell/sok-ble/commit/afb9309eaa061d9087fc49f74593b1358810307a))
+
 ## [0.1.8](https://github.com/IAmTheMitchell/sok-ble/compare/v0.1.7...v0.1.8) (2025-08-03)
 
 

{sok_ble-0.1.8 → sok_ble-0.1.9b2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sok-ble
-Version: 0.1.8
+Version: 0.1.9b2
 Summary: SOK BLE battery interface library
 Project-URL: Homepage, https://github.com/IAmTheMitchell/sok-ble
 Project-URL: Bug Tracker, https://github.com/IAmTheMitchell/sok-ble/issues

{sok_ble-0.1.8 → sok_ble-0.1.9b2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sok-ble"
-version = "0.1.8"
+version = "0.1.9b2"
 description = "SOK BLE battery interface library"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -24,6 +24,7 @@ dev = [
     "pytest>=7.0.1",
     "pytest-asyncio>=1.0.0",
     "ruff>=0.12.3",
+    "ty>=0.0.15",
 ]
 
 [project.urls]

{sok_ble-0.1.8 → sok_ble-0.1.9b2}/src/sok_ble/sok_bluetooth_device.py

@@ -10,6 +10,7 @@ from contextlib import asynccontextmanager
 from typing import AsyncIterator, Optional
 
 import async_timeout
+from bleak.backends.characteristic import BleakGATTCharacteristic
 from bleak.backends.device import BLEDevice
 from bleak.exc import BleakError
 
@@ -114,7 +115,7 @@ class SokBluetoothDevice:
 
                 queue: asyncio.Queue[bytes] = asyncio.Queue()
 
-                def handler(_: int, data: bytearray) -> None:
+                def handler(_: BleakGATTCharacteristic, data: bytearray) -> None:
                     queue.put_nowait(bytes(data))
 
                 await client.start_notify(UUID_RX, handler)
@@ -136,6 +137,10 @@ class SokBluetoothDevice:
                     await asyncio.sleep(0.2)
                     continue
                 raise
+        raise BleakError(
+            f"Failed to receive response 0x{expected:04X} "
+            f"from {self._ble_device.address}"
+        )
 
     async def async_update(self) -> None:
         """Poll the device for all telemetry and update attributes."""
@@ -180,13 +185,30 @@ class SokBluetoothDevice:
         parsed = SokParser.parse_all(responses)
         logger.debug("Parsed update: %s", parsed)
 
-        self.voltage = parsed["voltage"]
-        self.current = parsed["current"]
-        self.soc = parsed["soc"]
-        self.temperature = parsed["temperature"]
-        self.capacity = parsed["capacity"]
-        self.num_cycles = parsed["num_cycles"]
-        self.cell_voltages = parsed["cell_voltages"]
+        voltage = parsed.get("voltage")
+        self.voltage = voltage if isinstance(voltage, (int, float)) else None
+
+        current = parsed.get("current")
+        self.current = current if isinstance(current, (int, float)) else None
+
+        soc = parsed.get("soc")
+        self.soc = soc if isinstance(soc, int) else None
+
+        temperature = parsed.get("temperature")
+        self.temperature = (
+            temperature if isinstance(temperature, (int, float)) else None
+        )
+
+        capacity = parsed.get("capacity")
+        self.capacity = capacity if isinstance(capacity, (int, float)) else None
+
+        num_cycles = parsed.get("num_cycles")
+        self.num_cycles = num_cycles if isinstance(num_cycles, int) else None
+
+        cell_voltages = parsed.get("cell_voltages")
+        self.cell_voltages = (
+            list(cell_voltages) if isinstance(cell_voltages, list) else None
+        )
 
         self.num_samples += 1