Version v0.9.0

Version v0.9.0

Author: andrewsayre

.coveragerc

@@ -3,7 +3,7 @@
 {
 	"name": "pyheos Dev",
 	// Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
-	"image": "mcr.microsoft.com/devcontainers/python:1-3.12-bullseye",
+	"image": "mcr.microsoft.com/devcontainers/python:1-3.13-bullseye",
 	"postCreateCommand": "git config --global --add safe.directory ${containerWorkspaceFolder} | script/setup",
 	"containerEnv": {
 		"PYTHONASYNCIODEBUG": "1",

.devcontainer/devcontainer.json

@@ -16,15 +16,16 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
-          python-version: "3.12"
+          python-version: "3.13"
       - uses: actions/cache@v4
         with:
           path: ${{ env.pythonLocation }}
           key: ${{ env.pythonLocation }}-${{ hashFiles('requirements.txt') }}-${{ hashFiles('test-requirements.txt') }}
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install -r requirements.txt -r test-requirements.txt --upgrade --upgrade-strategy eager
+          pip install uv
+          uv pip install -r requirements.txt -r test-requirements.txt --upgrade --system
       - name: Spelling (codespell)
         run: codespell
       - name: Lint (Ruff)
@@ -42,7 +43,7 @@ jobs:
     needs: lint
     strategy:
       matrix:
-        python-version: ["3.11", "3.12"]
+        python-version: ["3.11", "3.12", "3.13"]
     steps:
       - uses: actions/checkout@v4
       - name: Set up Python
@@ -56,7 +57,8 @@ jobs:
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install -r requirements.txt -r test-requirements.txt --upgrade --upgrade-strategy eager
+          pip install uv
+          uv pip install -r requirements.txt -r test-requirements.txt --upgrade --system
       - name: Run pytest on ${{ matrix.python-version }}
         run: pytest
 
@@ -69,19 +71,19 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
-          python-version: "3.12"
+          python-version: "3.13"
       - uses: actions/cache@v4
         with:
           path: ${{ env.pythonLocation }}
           key: ${{ env.pythonLocation }}-${{ hashFiles('requirements.txt') }}-${{ hashFiles('test-requirements.txt') }}
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install -r requirements.txt -r test-requirements.txt --upgrade --upgrade-strategy eager
+          pip install uv
+          uv pip install -r requirements.txt -r test-requirements.txt --upgrade --system
       - name: Run pytest on ${{ matrix.python-version }}
-        run: pytest --cov=./ --cov-report=xml
+        run: pytest --cov --cov-report=xml
       - name: Upload coverage reports to Codecov
-        uses: codecov/codecov-action@v4.0.1
+        uses: codecov/codecov-action@v5
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
-          fail_ci_if_error: true

.github/workflows/ci.yaml

@@ -14,16 +14,17 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
-          python-version: "3.12"
+          python-version: "3.13"
       - uses: actions/cache@v4
         with:
           path: ${{ env.pythonLocation }}
           key: ${{ env.pythonLocation }}-${{ hashFiles('requirements.txt') }}-${{ hashFiles('test-requirements.txt') }}
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install -r requirements.txt -r test-requirements.txt --upgrade --upgrade-strategy eager
-          pip install build twine --upgrade --upgrade-strategy eager
+          pip install uv
+          uv pip install -r requirements.txt -r test-requirements.txt --upgrade --system
+          uv pip install build twine --upgrade --system
       - name: Build
         run: |
           python -m build

.github/workflows/publish.yaml

@@ -6,20 +6,14 @@
 [![image](https://img.shields.io/pypi/pyversions/pyheos.svg)](https://pypi.org/project/pyheos/)
 [![image](https://img.shields.io/pypi/l/pyheos.svg)](https://pypi.org/project/pyheos/)
 
-An async python library for controlling HEOS devices through the HEOS CLI Protocol (version 1.17 for players with firmware 2.41.140 or newer).
+An async python library for controlling HEOS devices through the HEOS CLI Protocol (version 1.21 for HEOS firmware 3.40 or newer).
 
 ## Installation
 
 ```bash
 pip install pyheos
 ```
 
-or
-
-```bash
-pip install --use-wheel pyheos
-```
-
 ## Getting Started
 
 ### `Heos` class

README.md

@@ -2,28 +2,54 @@
 
 from . import const
 from .credentials import Credentials
-from .dispatch import Dispatcher
+from .dispatch import (
+    CallbackType,
+    ConnectType,
+    ControllerEventCallbackType,
+    DisconnectType,
+    Dispatcher,
+    EventCallbackType,
+    PlayerEventCallbackType,
+    SendType,
+    TargetType,
+)
 from .error import CommandError, CommandFailedError, HeosError
 from .group import HeosGroup
 from .heos import Heos, HeosOptions
-from .player import HeosNowPlayingMedia, HeosPlayer
-from .source import HeosSource, InputSource
+from .media import (
+    BrowseResult,
+    Media,
+    MediaItem,
+    MediaMusicSource,
+)
+from .player import HeosNowPlayingMedia, HeosPlayer, PlayMode
 from .system import HeosHost, HeosSystem
 
 __all__ = [
-    "const",
+    "BrowseResult",
+    "CallbackType",
     "CommandError",
     "CommandFailedError",
+    "ConnectType",
+    "const",
+    "ControllerEventCallbackType",
     "Credentials",
+    "DisconnectType",
     "Dispatcher",
+    "EventCallbackType",
     "Heos",
     "HeosError",
     "HeosGroup",
     "HeosHost",
     "HeosOptions",
     "HeosPlayer",
     "HeosNowPlayingMedia",
-    "HeosSource",
     "HeosSystem",
-    "InputSource",
+    "Media",
+    "MediaItem",
+    "MediaMusicSource",
+    "PlayerEventCallbackType",
+    "PlayMode",
+    "SendType",
+    "TargetType",
 ]