python-ember-mug 1.3.0b3__tar.gz → 1.3.0b5__tar.gz

{python_ember_mug-1.3.0b3 → python_ember_mug-1.3.0b5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-ember-mug
-Version: 1.3.0b3
+Version: 1.3.0b5
 Summary: Python Library for Ember Mugs.
 Project-URL: Changelog, https://sopelj.github.io/python-ember-mug/changelog/
 Project-URL: Documentation, https://sopelj.github.io/python-ember-mug/
@@ -16,9 +16,10 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Requires-Python: >=3.11
 Requires-Dist: bleak-retry-connector>=4.0.2
-Requires-Dist: bleak>=1.0.1
+Requires-Dist: bleak<2.2.0,>=1.0.1
 Provides-Extra: dev
 Requires-Dist: ipython; extra == 'dev'
 Provides-Extra: docs
@@ -44,7 +45,7 @@ Description-Content-Type: text/markdown
 [![python](https://img.shields.io/pypi/pyversions/python-ember-mug.svg)](https://pypi.org/project/python-ember-mug/)
 [![Build Status](https://github.com/sopelj/python-ember-mug/actions/workflows/tests.yml/badge.svg)](https://github.com/sopelj/python-ember-mug/actions/workflows/tests.yml)
 [![codecov](https://codecov.io/gh/sopelj/python-ember-mug/graph/badge.svg?token=2Lw2iVjKsG)](https://codecov.io/gh/sopelj/python-ember-mug)
-![Project Maintenance](https://img.shields.io/maintenance/yes/2025.svg)
+![Project Maintenance](https://img.shields.io/maintenance/yes/2026.svg)
 [![Maintainer](https://img.shields.io/badge/maintainer-%40sopelj-blue.svg)](https://github.com/sopelj)
 [![License](https://img.shields.io/github/license/sopelj/python-ember-mug.svg)](https://github.com/sopelj/python-ember-mug/blob/main/LICENSE)
 [![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen)](https://github.com/pre-commit/pre-commit)
@@ -177,8 +178,6 @@ Device Data
 +--------------+----------------------+
 | Target Temp  | 55.00°C              |
 +--------------+----------------------+
-| Use Metric   | True                 |
-+--------------+----------------------+
 
 Watching for changes
 Current Temp changed from "24.50°C" to "25.50°"

{python_ember_mug-1.3.0b3 → python_ember_mug-1.3.0b5}/README.md

@@ -4,7 +4,7 @@
 [![python](https://img.shields.io/pypi/pyversions/python-ember-mug.svg)](https://pypi.org/project/python-ember-mug/)
 [![Build Status](https://github.com/sopelj/python-ember-mug/actions/workflows/tests.yml/badge.svg)](https://github.com/sopelj/python-ember-mug/actions/workflows/tests.yml)
 [![codecov](https://codecov.io/gh/sopelj/python-ember-mug/graph/badge.svg?token=2Lw2iVjKsG)](https://codecov.io/gh/sopelj/python-ember-mug)
-![Project Maintenance](https://img.shields.io/maintenance/yes/2025.svg)
+![Project Maintenance](https://img.shields.io/maintenance/yes/2026.svg)
 [![Maintainer](https://img.shields.io/badge/maintainer-%40sopelj-blue.svg)](https://github.com/sopelj)
 [![License](https://img.shields.io/github/license/sopelj/python-ember-mug.svg)](https://github.com/sopelj/python-ember-mug/blob/main/LICENSE)
 [![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen)](https://github.com/pre-commit/pre-commit)
@@ -137,8 +137,6 @@ Device Data
 +--------------+----------------------+
 | Target Temp  | 55.00°C              |
 +--------------+----------------------+
-| Use Metric   | True                 |
-+--------------+----------------------+
 
 Watching for changes
 Current Temp changed from "24.50°C" to "25.50°"

{python_ember_mug-1.3.0b3 → python_ember_mug-1.3.0b5}/ember_mug/__init__.py

@@ -6,4 +6,4 @@ __all__ = ("EmberMug",)
 
 __author__ = """Jesse Sopel"""
 __email__ = "jesse.sopel@gmail.com"
-__version__ = "1.3.0b3"
+__version__ = "1.3.0b5"

{python_ember_mug-1.3.0b3 → python_ember_mug-1.3.0b5}/ember_mug/cli/commands.py

@@ -112,9 +112,9 @@ async def poll_device_cmd(args: Namespace) -> None:
         for _ in CommandLoop():
             for _ in range(60):
                 await asyncio.sleep(1)
-                print_changes(await mug.update_queued_attributes(), mug.data.use_metric)
+                print_changes(await mug.update_queued_attributes(), mug.data.user_unit)
             # Every minute do a full update
-            print_changes(await mug.update_all(), mug.data.use_metric)
+            print_changes(await mug.update_all(), mug.data.user_unit)
 
 
 async def get_device_value_cmd(args: Namespace) -> None:

{python_ember_mug-1.3.0b3 → python_ember_mug-1.3.0b5}/ember_mug/cli/helpers.py

@@ -8,7 +8,7 @@ from collections import defaultdict
 from functools import partial
 from typing import TYPE_CHECKING
 
-from ember_mug.consts import MAC_ADDRESS_REGEX
+from ember_mug.consts import MAC_ADDRESS_REGEX, TemperatureUnit
 from ember_mug.data import Change
 from ember_mug.formatting import format_led_colour, format_liquid_level, format_temp
 
@@ -62,11 +62,11 @@ def print_info(mug: EmberMug) -> None:
     print_table(list(mug.data.formatted.items()))
 
 
-def print_changes(changes: list[Change], metric: bool = True) -> None:
+def print_changes(changes: list[Change], unit: TemperatureUnit | None) -> None:
     """Print changes."""
     formatters: dict[str, Callable] = {
-        "current_temp": partial(format_temp, metric=metric),
-        "target_temp": partial(format_temp, metric=metric),
+        "current_temp": partial(format_temp, unit=unit),
+        "target_temp": partial(format_temp, unit=unit),
         **base_formatters,
     }
     for attr, old_value, new_value in changes:

{python_ember_mug-1.3.0b3 → python_ember_mug-1.3.0b5}/ember_mug/consts.py

@@ -240,7 +240,6 @@ ATTR_LABELS = {
     "liquid_level": "Liquid Level",
     "current_temp": "Current Temp",
     "target_temp": "Target Temp",
-    "use_metric": "Use Metric",
     "dsk": "DSK",
     "udsk": "UDSK",
     "date_time_zone": "Date Time + Time Zone",

{python_ember_mug-1.3.0b3 → python_ember_mug-1.3.0b5}/ember_mug/data.py

@@ -211,7 +211,7 @@ class MugData(AsDict):
 
     # Options
     model_info: ModelInfo
-    use_metric: bool = True
+    use_metric: bool | None = None
     debug: bool = False
 
     # Attributes
@@ -231,6 +231,15 @@ class MugData(AsDict):
     date_time_zone: datetime | None = None
     battery_voltage: int | None = None
 
+    @property
+    def user_unit(self) -> TemperatureUnit | None:
+        """Get the correct unit for the user."""
+        if self.use_metric is False:
+            return TemperatureUnit.FAHRENHEIT
+        if self.use_metric is True:
+            return TemperatureUnit.CELSIUS
+        return None
+
     @property
     def meta_display(self) -> str:
         """Return Meta infor based on preference."""
@@ -263,12 +272,12 @@ class MugData(AsDict):
     @property
     def current_temp_display(self) -> str:
         """Human-readable current temp with unit."""
-        return format_temp(self.current_temp, self.use_metric)
+        return format_temp(self.current_temp, self.user_unit)
 
     @property
     def target_temp_display(self) -> str:
         """Human-readable target temp with unit."""
-        return format_temp(self.target_temp, self.use_metric)
+        return format_temp(self.target_temp, self.user_unit)
 
     def update_info(self, **kwargs: Any) -> list[Change]:
         """Update attributes of the mug if they haven't changed."""
@@ -288,7 +297,7 @@ class MugData(AsDict):
     @property
     def formatted(self) -> dict[str, Any]:
         """Return human-readable names and values for all attributes for display."""
-        all_attrs = self.model_info.device_attributes | {"use_metric"}
+        all_attrs = set(self.model_info.device_attributes)
         if not self.debug:
             all_attrs -= EXTRA_ATTRS
         return {label: self.get_formatted_attr(attr) for attr, label in ATTR_LABELS.items() if attr in all_attrs}
@@ -296,6 +305,7 @@ class MugData(AsDict):
     def as_dict(self) -> dict[str, Any]:
         """Dump all attributes as dict for info/debugging."""
         data = asdict(self)
+        del data["use_metric"]
         all_attrs = self.model_info.device_attributes
         if not self.debug:
             all_attrs -= EXTRA_ATTRS

{python_ember_mug-1.3.0b3 → python_ember_mug-1.3.0b5}/ember_mug/formatting.py

@@ -5,16 +5,17 @@ from __future__ import annotations
 from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
+    from .consts import TemperatureUnit
     from .data import Colour
 
 
-def format_temp(temp: float, metric: bool = True) -> str:
+def format_temp(temp: float, unit: TemperatureUnit | None = None) -> str:
     """Format temperature with the correct unit."""
-    unit = "C" if metric else "F"
-    return f"{temp:.2f}°{unit}"
+    value = f"{temp:.2f}"
+    return f"{value}{unit.value}" if unit else value
 
 
-def format_capacity(capacity: int | None, metric: bool = True) -> str:
+def format_capacity(capacity: int | None, metric: bool | None = None) -> str:
     """Format capacity for display."""
     if capacity is None:
         return "Unknown"

{python_ember_mug-1.3.0b3 → python_ember_mug-1.3.0b5}/ember_mug/mug.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 import asyncio
 import contextlib
 import logging
+import os
 from datetime import UTC, datetime
 from enum import Enum
 from functools import cached_property
@@ -67,7 +68,7 @@ def require_attribute(
         """Inner decorator."""
 
         async def wrapper(self: EmberMug, *args: P.args, **kwargs: P.kwargs) -> T:
-            if self.has_attribute(attr_name) is False:
+            if not self.has_attribute(attr_name):
                 device_type = self.data.model_info.device_type.value
                 raise NotImplementedError(
                     f"The {device_type} does not have the {attr_name} attribute",
@@ -86,7 +87,7 @@ class EmberMug:
         self,
         ble_device: BLEDevice,
         model_info: ModelInfo,
-        use_metric: bool = True,
+        use_metric: bool | None = None,
         debug: bool = False,
         **kwargs: Any,
     ) -> None:
@@ -135,17 +136,17 @@ class EmberMug:
 
     def _convert_to_device_unit(self, value: float) -> float:
         """Convert user value to the unit the device expects."""
-        if self.data.use_metric and self.data.temperature_unit != TemperatureUnit.CELSIUS:
+        if self.data.user_unit == TemperatureUnit.CELSIUS and self.data.temperature_unit == TemperatureUnit.FAHRENHEIT:
             return convert_temp_to_fahrenheit(value)
-        if not self.data.use_metric and self.data.temperature_unit != TemperatureUnit.FAHRENHEIT:
+        if self.data.user_unit == TemperatureUnit.FAHRENHEIT and self.data.temperature_unit == TemperatureUnit.CELSIUS:
             return convert_temp_to_celsius(value)
         return value
 
     def _convert_to_user_unit(self, value: float) -> float:
         """Convert device value to the unit the user expects."""
-        if self.data.use_metric and self.data.temperature_unit != TemperatureUnit.CELSIUS:
+        if self.data.user_unit == TemperatureUnit.CELSIUS and self.data.temperature_unit == TemperatureUnit.FAHRENHEIT:
             return convert_temp_to_celsius(value)
-        if not self.data.use_metric and self.data.temperature_unit != TemperatureUnit.FAHRENHEIT:
+        if self.data.user_unit == TemperatureUnit.FAHRENHEIT and self.data.temperature_unit == TemperatureUnit.CELSIUS:
             return convert_temp_to_fahrenheit(value)
         return value
 
@@ -275,6 +276,25 @@ class EmberMug:
         """Get Battery percent from mug gatt."""
         return BatteryInfo.from_bytes(await self._read(MugCharacteristic.BATTERY))
 
+    async def make_writable(self) -> bool:
+        """Try to make device writable if need be."""
+        if self.can_write:
+            return True
+        try:
+            await self._ensure_connection()
+            # Attempt to write a random string
+            await self.set_udsk(os.urandom(14).hex())
+            return True
+        except BleakError as e:
+            logger.debug("Failed to make device writable: %s", e)
+            return False
+
+    async def pair(self) -> None:
+        """Attempt to pair."""
+        with contextlib.suppress(BleakError, EOFError):
+            await self._ensure_connection()
+            await self._client.pair()
+
     @require_attribute("led_colour")
     async def get_led_colour(self) -> Colour:
         """Get RGBA colours from mug gatt."""
@@ -294,11 +314,11 @@ class EmberMug:
 
     async def set_target_temp(self, target_temp: float) -> None:
         """Set new target temp for mug."""
-        unit = TemperatureUnit.CELSIUS if self.data.use_metric else TemperatureUnit.FAHRENHEIT
-        min_temp, max_temp = MIN_MAX_TEMPS[unit]
-        if target_temp != 0 and not (min_temp <= target_temp <= max_temp):
-            raise ValueError(f"Temperature should be between {min_temp} and {max_temp} or 0.")
-
+        if self.data.use_metric is not None:
+            unit = TemperatureUnit.FAHRENHEIT if self.data.use_metric is False else TemperatureUnit.CELSIUS
+            min_temp, max_temp = MIN_MAX_TEMPS[unit]
+            if target_temp != 0 and not (min_temp <= target_temp <= max_temp):
+                raise ValueError(f"Temperature should be between {min_temp} and {max_temp} or 0.")
         target_temp = self._convert_to_device_unit(target_temp)
         target = bytearray(round(target_temp / 0.01).to_bytes(2, "little"))
         await self._write(MugCharacteristic.TARGET_TEMPERATURE, target)
@@ -390,12 +410,6 @@ class EmberMug:
         await self._write(MugCharacteristic.TEMPERATURE_UNIT, unit_bytes)
         self.data.temperature_unit = TemperatureUnit(unit)
 
-    async def ensure_correct_unit(self) -> None:
-        """Set mug unit if it's not what we want."""
-        desired = TemperatureUnit.CELSIUS if self.data.use_metric else TemperatureUnit.FAHRENHEIT
-        if self.data.temperature_unit != desired:
-            await self.set_temperature_unit(desired)
-
     async def get_battery_voltage(self) -> int:
         """Get voltage and charge time."""
         battery_voltage_bytes = await self._read(MugCharacteristic.CONTROL_REGISTER_DATA)

{python_ember_mug-1.3.0b3 → python_ember_mug-1.3.0b5}/pyproject.toml

@@ -14,10 +14,11 @@ classifiers = [
     'Programming Language :: Python :: 3.11',
     'Programming Language :: Python :: 3.12',
     'Programming Language :: Python :: 3.13',
+    'Programming Language :: Python :: 3.14',
 ]
 dependencies = [
     "bleak-retry-connector>=4.0.2",
-    "bleak>=1.0.1",
+    "bleak>=1.0.1,<2.2.0",
 ]
 
 [project.optional-dependencies]
@@ -72,7 +73,8 @@ python = "3.13"
 features = ["test"]
 
 [[tool.hatch.envs.test.matrix]]
-python = ["3.11", "3.12", "3.13"]
+python = ["3.11", "3.12", "3.13", "3.14"]
+bleak = ["1.0.1", "2.0.0"]
 
 [tool.hatch.envs.test.scripts]
 cov = "pytest -vvv --asyncio-mode=auto --cov=ember_mug --cov-branch --cov-report=xml --cov-report=term-missing tests"
@@ -89,7 +91,7 @@ serve = "mkdocs serve --dev-addr localhost:8000"
 [tool.black]
 line-length = 120
 skip-string-normalization = true
-target-version = ["py311", "py312", "py313"]
+target-version = ["py311", "py312", "py313", "py314"]
 include = '\.pyi?$'
 exclude = '''
 /(