pybravia-connect 0.1.0a3__tar.gz

pybravia_connect-0.1.0a3/.github/workflows/ci.yml

@@ -0,0 +1,27 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install package and dev tools
+        run: pip install -e ".[dev]"
+
+      - name: Ruff lint
+        run: ruff check .
+
+      - name: Ruff format
+        run: ruff format --check .
+
+      - name: Tests
+        run: pytest -q

pybravia_connect-0.1.0a3/.github/workflows/publish.yml

@@ -0,0 +1,30 @@
+name: Publish
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

pybravia_connect-0.1.0a3/.gitignore

@@ -0,0 +1,15 @@
+.venv/
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+.eggs/
+dist/
+build/
+.pytest_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+.mypy_cache/
+.tox/
+*.egg

pybravia_connect-0.1.0a3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 steamEngineer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pybravia_connect-0.1.0a3/PKG-INFO

@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: pybravia-connect
+Version: 0.1.0a3
+Summary: HA-agnostic Sony BRAVIA Connect ControlDeviceService client
+Author: steamEngineer
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: aiohttp>=3.9
+Requires-Dist: grpcio>=1.76.0
+Requires-Dist: protobuf<7,>=5
+Provides-Extra: crypto
+Requires-Dist: cryptography>=42; extra == 'crypto'
+Provides-Extra: dev
+Requires-Dist: cryptography>=42; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.9; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# pybravia-connect
+
+HA-agnostic Python client for Sony BRAVIA Connect local gRPC
+(`ControlDeviceService`).
+
+This is a **protocol library**, not a Home Assistant integration. Integrations
+that speak BRAVIA Connect (for example
+[bravia-quad-homeassistant](https://github.com/steamEngineer/bravia-quad-homeassistant)
+and
+[bravia-tv-grpc-homeassistant](https://github.com/braviafanboy/bravia-tv-grpc-homeassistant))
+can depend on this package once cut over.
+
+Protocol code was extracted from those integrations (MIT). Thanks to
+@steamEngineer and @braviafanboy.
+
+## Status
+
+`0.1.0a3` — connect/handshake, `StartNotifyStates`, `GetCapabilities`,
+`get_states`, `ExecCommandWithAuth` (fresh `GetSessionRandom` per write), and
+nonce-gated TV `read_application_list` / `read_resource` (AES-GCM; needs
+`session_key` + `[crypto]`).
+
+## Install
+
+```bash
+pip install pybravia-connect==0.1.0a3
+```
+
+For local development:
+
+```bash
+pip install -e ".[dev]"
+```
+
+For TV app-list and icon reads (AES-GCM decrypt):
+
+```bash
+pip install "pybravia-connect[crypto]"
+```
+
+## Public API (sketch)
+
+```python
+from pybravia_connect import (
+    BraviaConnectClient,
+    DEFAULT_THEATRE_PORT,
+    async_complete_oauth_flow,
+    start_oauth_login,
+    select_device,
+    discover_grpc_port,
+)
+```
+
+Sync gRPC client (run in an executor from asyncio). Async credentials use
+`aiohttp.ClientSession`.
+
+## Live smoke
+
+```bash
+export BRAVIA_HOST=192.168.x.x
+export BRAVIA_PORT=55051          # Theatre default; TVs may need discovery
+export BRAVIA_CREDENTIALS=/path/to/keys.json
+python tools/live_smoke.py
+```
+
+Validated on HT-A9M2: connect/handshake, GetCapabilities, StartNotifyStates,
+`get_states`, and volume writes via `exec_command` while powered on. Volume/mute
+writes are no-ops when the control unit is off — live smoke wakes `power` first.
+Stop any Home Assistant `bravia_quad` session on the same device before smoke
+(dual `key_id` sessions flake).
+
+## Regenerating protobuf stubs
+
+```bash
+python -m grpc_tools.protoc -Isrc/pybravia_connect/proto \
+  --python_out=src/pybravia_connect/proto \
+  --grpc_python_out=src/pybravia_connect/proto \
+  src/pybravia_connect/proto/bravia_control.proto
+```
+
+Then re-apply two manual patches:
+
+1. Make the `pb2_grpc` import relative: `from . import bravia_control_pb2`.
+2. Register the descriptor in a **private** pool, not the global `Default()` one
+   (`_pool = DescriptorPool()` / `DESCRIPTOR = _pool.AddSerializedFile(...)`).
+   This avoids symbol collisions when co-installed with integrations that still
+   vendor their own stubs.
+
+## Development
+
+```bash
+python3 -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+ruff check . && ruff format --check .
+pytest -q
+```

pybravia_connect-0.1.0a3/README.md

@@ -0,0 +1,96 @@
+# pybravia-connect
+
+HA-agnostic Python client for Sony BRAVIA Connect local gRPC
+(`ControlDeviceService`).
+
+This is a **protocol library**, not a Home Assistant integration. Integrations
+that speak BRAVIA Connect (for example
+[bravia-quad-homeassistant](https://github.com/steamEngineer/bravia-quad-homeassistant)
+and
+[bravia-tv-grpc-homeassistant](https://github.com/braviafanboy/bravia-tv-grpc-homeassistant))
+can depend on this package once cut over.
+
+Protocol code was extracted from those integrations (MIT). Thanks to
+@steamEngineer and @braviafanboy.
+
+## Status
+
+`0.1.0a3` — connect/handshake, `StartNotifyStates`, `GetCapabilities`,
+`get_states`, `ExecCommandWithAuth` (fresh `GetSessionRandom` per write), and
+nonce-gated TV `read_application_list` / `read_resource` (AES-GCM; needs
+`session_key` + `[crypto]`).
+
+## Install
+
+```bash
+pip install pybravia-connect==0.1.0a3
+```
+
+For local development:
+
+```bash
+pip install -e ".[dev]"
+```
+
+For TV app-list and icon reads (AES-GCM decrypt):
+
+```bash
+pip install "pybravia-connect[crypto]"
+```
+
+## Public API (sketch)
+
+```python
+from pybravia_connect import (
+    BraviaConnectClient,
+    DEFAULT_THEATRE_PORT,
+    async_complete_oauth_flow,
+    start_oauth_login,
+    select_device,
+    discover_grpc_port,
+)
+```
+
+Sync gRPC client (run in an executor from asyncio). Async credentials use
+`aiohttp.ClientSession`.
+
+## Live smoke
+
+```bash
+export BRAVIA_HOST=192.168.x.x
+export BRAVIA_PORT=55051          # Theatre default; TVs may need discovery
+export BRAVIA_CREDENTIALS=/path/to/keys.json
+python tools/live_smoke.py
+```
+
+Validated on HT-A9M2: connect/handshake, GetCapabilities, StartNotifyStates,
+`get_states`, and volume writes via `exec_command` while powered on. Volume/mute
+writes are no-ops when the control unit is off — live smoke wakes `power` first.
+Stop any Home Assistant `bravia_quad` session on the same device before smoke
+(dual `key_id` sessions flake).
+
+## Regenerating protobuf stubs
+
+```bash
+python -m grpc_tools.protoc -Isrc/pybravia_connect/proto \
+  --python_out=src/pybravia_connect/proto \
+  --grpc_python_out=src/pybravia_connect/proto \
+  src/pybravia_connect/proto/bravia_control.proto
+```
+
+Then re-apply two manual patches:
+
+1. Make the `pb2_grpc` import relative: `from . import bravia_control_pb2`.
+2. Register the descriptor in a **private** pool, not the global `Default()` one
+   (`_pool = DescriptorPool()` / `DESCRIPTOR = _pool.AddSerializedFile(...)`).
+   This avoids symbol collisions when co-installed with integrations that still
+   vendor their own stubs.
+
+## Development
+
+```bash
+python3 -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+ruff check . && ruff format --check .
+pytest -q
+```

pybravia_connect-0.1.0a3/pyproject.toml

@@ -0,0 +1,49 @@
+[project]
+name = "pybravia-connect"
+version = "0.1.0a3"
+description = "HA-agnostic Sony BRAVIA Connect ControlDeviceService client"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.12"
+authors = [{ name = "steamEngineer" }]
+dependencies = [
+    "grpcio>=1.76.0",
+    "protobuf>=5,<7",
+    "aiohttp>=3.9",
+]
+
+[project.optional-dependencies]
+crypto = ["cryptography>=42"]
+dev = [
+    "pytest>=8.0",
+    "ruff>=0.9",
+    "cryptography>=42",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/pybravia_connect"]
+
+[tool.ruff]
+target-version = "py312"
+line-length = 88
+extend-exclude = [
+    "src/pybravia_connect/proto/bravia_control_pb2.py",
+    "src/pybravia_connect/proto/bravia_control_pb2_grpc.py",
+]
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "UP", "B", "C4", "SIM"]
+
+[tool.ruff.lint.isort]
+force-sort-within-sections = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src", "tests"]
+markers = [
+    "live: live device smoke tests (deselect with '-m \"not live\"')",
+]

pybravia_connect-0.1.0a3/src/pybravia_connect/__init__.py

@@ -0,0 +1,70 @@
+"""Sony BRAVIA Connect local gRPC protocol client (HA-agnostic)."""
+
+from .client import BraviaConnectClient
+from .credentials import (
+    async_complete_oauth_flow,
+    async_refresh_credentials,
+    build_authorization_url,
+    build_credentials_bundle,
+    credentials_to_json,
+    device_hardware_info,
+    generate_pkce_pair,
+    keys_need_refresh,
+    parse_authorization_code,
+    parse_credentials_json,
+    parse_oauth_redirect_state,
+    select_device,
+    select_speaker_device,
+    select_tv_device,
+    start_oauth_login,
+)
+from .discovery import (
+    DEFAULT_THEATRE_PORT,
+    discover_grpc_port,
+    is_control_device_service,
+    scan_open_ports,
+)
+from .exceptions import (
+    AuthError,
+    BraviaConnectError,
+    ConnectionError,
+    CredentialsError,
+    CredentialsRefreshError,
+    DeviceSelectError,
+    OAuthError,
+)
+from .wire.capabilities import CapabilityMeta
+
+__version__ = "0.1.0a3"
+
+__all__ = [
+    "DEFAULT_THEATRE_PORT",
+    "AuthError",
+    "BraviaConnectClient",
+    "BraviaConnectError",
+    "CapabilityMeta",
+    "ConnectionError",
+    "CredentialsError",
+    "CredentialsRefreshError",
+    "DeviceSelectError",
+    "OAuthError",
+    "__version__",
+    "async_complete_oauth_flow",
+    "async_refresh_credentials",
+    "build_authorization_url",
+    "build_credentials_bundle",
+    "credentials_to_json",
+    "device_hardware_info",
+    "discover_grpc_port",
+    "generate_pkce_pair",
+    "is_control_device_service",
+    "keys_need_refresh",
+    "parse_authorization_code",
+    "parse_credentials_json",
+    "parse_oauth_redirect_state",
+    "scan_open_ports",
+    "select_device",
+    "select_speaker_device",
+    "select_tv_device",
+    "start_oauth_login",
+]