Merge branch 'ahayworth:master' into master

Author: averybiteydinosaur

.github/workflows/ci.yaml

@@ -9,27 +9,29 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: [3.7, 3.8, 3.9, "3.10"]
+        python-version: [3.9, "3.10", "3.11", "3.12", "3.13"]
         include:
-          - python-version: 3.7
-            toxenv: py37
-          - python-version: 3.8
-            toxenv: py38
           - python-version: 3.9
             toxenv: py39
           - python-version: "3.10"
             toxenv: py310
+          - python-version: "3.11"
+            toxenv: py311
+          - python-version: "3.12"
+            toxenv: py312
+          - python-version: "3.13"
+            toxenv: py313
     steps:
       - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v5
       - name: Set up python ${{ matrix.python-version }}
-        uses: actions/setup-python@v1
+        uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
       - name: Set up poetry
-        uses: Gr1N/setup-poetry@v7
+        uses: Gr1N/setup-poetry@v9
       - name: Cache dependencies
-        uses: actions/cache@v1
+        uses: actions/cache@v4
         with:
           path: ~/.cache/pypoetry/virtualenvs
           key: ${{ runner.os }}-v2-poetry-${{ matrix.python-version }}-${{ hashFiles('poetry.lock') }}
@@ -43,10 +45,10 @@ jobs:
       - name: Linters
         run: |
           poetry run tox -e lint
-        if: matrix.python-version == '3.8'
+        if: matrix.python-version == '3.9'
       - name: Coverage
         run: |
           poetry run tox -e coverage
         env:
           CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
-        if: matrix.python-version == '3.8'
+        if: matrix.python-version == '3.9'

.pylintrc

@@ -1,2 +1,2 @@
 [MESSAGES CONTROL]
-disable=bad-continuation,too-few-public-methods,too-many-instance-attributes
+disable=too-few-public-methods,too-many-instance-attributes

README.md

@@ -5,8 +5,8 @@
 [![codecov](https://codecov.io/gh/ahayworth/python_awair/branch/master/graph/badge.svg)](https://codecov.io/gh/ahayworth/python_awair)
 [![Documentation Status](https://readthedocs.org/projects/python-awair/badge/?version=latest)](https://python-awair.readthedocs.io/en/latest/?badge=latest)
 
-This is an async library which accesses portions of the [Awair](https://getawair.com) REST API. It exists primarily
-to support the Home Assistant integration, but is considered active and supported by its author. PRs welcome!
+This is an async library which accesses portions of the [Awair](https://getawair.com) REST API, and it exists primarily
+to support the Home Assistant integration for Awair devices.
 
 Features:
 - Object-oriented approach to querying and handling data
@@ -20,6 +20,15 @@ Not yet supported:
 
 Dive into our [documentation](https://python-awair.readthedocs.io/en/latest) to get started!
 
+# Status
+
+This project could be considered in "maintenance mode". It meets the needs of the Home Assistant integration,
+and there are no current plans to add new features. Large PRs adding significant new features or drastically
+changing the library are unlikely to be accepted without prior discussion (please open an issue first).
+
+However, bug fixes and updates to support python and/or Home Assistant compatibility are welcomed and accepted!
+I intend to keep passively maintaining the library, and please open an issue if there is an unaddressed need.
+
 # Development
 
 - We manage dependencies and builds via [poetry](https://python-poetry.org)

docs/conf.py

@@ -1,4 +1,5 @@
 """Sphinx configuration for python_awair."""
+
 # pylint: skip-file
 import os
 import sys

poetry.lock

@@ -18,47 +18,46 @@ classifiers = [
 ]
 
 [tool.poetry.dependencies]
-python = "^3.7"
-aiohttp = "^3.6.1"
+python = ">=3.9"
+aiohttp = ">=3.6.1"
 voluptuous = ">=0.11.7"
 
-[tool.poetry.dev-dependencies]
-black = "^19.10b0"
-codecov = "^2.0.22"
-coverage = "^5.0.4"
-flake8 =  "^3.7.9"
-flake8-docstrings =  "^1.5.0"
-isort =  "^4.3.21"
+[tool.poetry.group.dev.dependencies]
+black = ">=19.10b0"
+codecov = ">=2.1"
+coverage = ">=5.0.4"
+flake8 =  ">=3.7.9"
+flake8-docstrings =  ">=1.5.0"
+isort =  ">=4.3.21"
 mypy =  ">=0.770"
-pydocstyle =  "^5.0.2"
-pylint =  "^2.4.4"
-pyls-mypy = { git = "https://github.com/tomv564/pyls-mypy" }
+pydocstyle =  ">=5.0.2"
+pylint =  ">=2.4.4"
 pytest = ">=5.2"
-pytest-aiohttp = "^0.3.0"
+pytest-aiohttp = ">=0.3.0"
 pytest-cov = ">=2.8.1"
-python-language-server =  "^0.31.9"
-sphinx =  "^3.0.1"
-sphinx-readable-theme =  "^1.3.0"
-tox = "^3.14.6"
-vcrpy = "^4.0.2"
+python-language-server =  ">=0.31.9"
+sphinx =  ">=3.0.1"
+sphinx-readable-theme =  ">=1.3.0"
+tox = ">=4"
+vcrpy = ">=4.0.2"
 
-[tool.poetry.urls]
-"Say Thanks" = "https://saythanks.io/to/ahayworth@gmail.com"
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
 
 [tool.tox]
 legacy_tox_ini = """
 [tox]
-envlist = py37, py38, py39, py310
+envlist = py39, py310, py311, py312, py313
 isolated_build = True
 skipsdist = True
 skip_missing_interpreters = True
 
 [testenv]
-whitelist_externals = poetry
+allowlist_externals = poetry
 commands = poetry run pytest {posargs}
 
 [testenv:lint]
-whitelist_externals = poetry
+allowlist_externals = poetry
 commands =
   poetry run black . --check
   poetry run isort --check python_awair/ tests/
@@ -67,10 +66,10 @@ commands =
   poetry run mypy python_awair/ tests/
 
 [testenv:coverage]
-whitelist_externals =
+allowlist_externals =
   poetry
   codecov
-passenv = CI CODECOV* GITHUB_ACTION GITHUB_REF GITHUB_REPOSITORY GITHUB_HEAD_REF GITHUB_SHA GITHUB_RUN_ID
+passenv = CI,CODECOV*,GITHUB_ACTION,GITHUB_REF,GITHUB_REPOSITORY,GITHUB_HEAD_REF,GITHUB_SHA,GITHUB_RUN_ID
 commands =
   poetry run pytest --cov=python_awair {posargs}
   codecov

pyproject.toml

@@ -1,4 +1,5 @@
 """Mostly query constants."""
+
 BASE_URL = "https://developer-apis.awair.is/v1"
 USER_URL = f"{BASE_URL}/users/self"
 DEVICE_URL = f"{USER_URL}/devices"

python_awair/const.py

@@ -436,7 +436,7 @@ class AwairLocalDevice(AwairBaseDevice):
     device_addr: str
     """The DNS or IP address of the device."""
 
-    fw_version: str
+    fw_version: Optional[str]
     """The firmware version currently running on the device."""
 
     def __init__(

python_awair/devices.py

@@ -1,4 +1,5 @@
 """Indices dict with attribute access."""
+
 from python_awair.attrdict import AttrDict
 
 

python_awair/indices.py

@@ -1,6 +1,5 @@
 """An Awair user."""
 
-
 from datetime import date
 from typing import Any, Dict, List, Optional
 
@@ -116,7 +115,7 @@ def __init__(self, client: AwairClient, attributes: Dict[str, Any]) -> None:
         dob_month = attributes.get("dobMonth", None)
         dob_year = attributes.get("dobYear", None)
 
-        if all([dob_day, dob_month, dob_year]):
+        if dob_day and dob_month and dob_year:
             self.dob = date(day=dob_day, month=dob_month, year=dob_year)
         else:
             self.dob = None