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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: python-ember-mug
3
- Version: 1.3.0b4
3
+ Version: 1.3.0b5
4
4
  Summary: Python Library for Ember Mugs.
5
5
  Project-URL: Changelog, https://sopelj.github.io/python-ember-mug/changelog/
6
6
  Project-URL: Documentation, https://sopelj.github.io/python-ember-mug/
@@ -16,9 +16,10 @@ Classifier: Programming Language :: Python :: 3
16
16
  Classifier: Programming Language :: Python :: 3.11
17
17
  Classifier: Programming Language :: Python :: 3.12
18
18
  Classifier: Programming Language :: Python :: 3.13
19
+ Classifier: Programming Language :: Python :: 3.14
19
20
  Requires-Python: >=3.11
20
21
  Requires-Dist: bleak-retry-connector>=4.0.2
21
- Requires-Dist: bleak>=1.0.1
22
+ Requires-Dist: bleak<2.2.0,>=1.0.1
22
23
  Provides-Extra: dev
23
24
  Requires-Dist: ipython; extra == 'dev'
24
25
  Provides-Extra: docs
@@ -44,7 +45,7 @@ Description-Content-Type: text/markdown
44
45
  [![python](https://img.shields.io/pypi/pyversions/python-ember-mug.svg)](https://pypi.org/project/python-ember-mug/)
45
46
  [![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)
46
47
  [![codecov](https://codecov.io/gh/sopelj/python-ember-mug/graph/badge.svg?token=2Lw2iVjKsG)](https://codecov.io/gh/sopelj/python-ember-mug)
47
- ![Project Maintenance](https://img.shields.io/maintenance/yes/2025.svg)
48
+ ![Project Maintenance](https://img.shields.io/maintenance/yes/2026.svg)
48
49
  [![Maintainer](https://img.shields.io/badge/maintainer-%40sopelj-blue.svg)](https://github.com/sopelj)
49
50
  [![License](https://img.shields.io/github/license/sopelj/python-ember-mug.svg)](https://github.com/sopelj/python-ember-mug/blob/main/LICENSE)
50
51
  [![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen)](https://github.com/pre-commit/pre-commit)
@@ -177,8 +178,6 @@ Device Data
177
178
  +--------------+----------------------+
178
179
  | Target Temp | 55.00°C |
179
180
  +--------------+----------------------+
180
- | Use Metric | True |
181
- +--------------+----------------------+
182
181
 
183
182
  Watching for changes
184
183
  Current Temp changed from "24.50°C" to "25.50°"
@@ -4,7 +4,7 @@
4
4
  [![python](https://img.shields.io/pypi/pyversions/python-ember-mug.svg)](https://pypi.org/project/python-ember-mug/)
5
5
  [![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)
6
6
  [![codecov](https://codecov.io/gh/sopelj/python-ember-mug/graph/badge.svg?token=2Lw2iVjKsG)](https://codecov.io/gh/sopelj/python-ember-mug)
7
- ![Project Maintenance](https://img.shields.io/maintenance/yes/2025.svg)
7
+ ![Project Maintenance](https://img.shields.io/maintenance/yes/2026.svg)
8
8
  [![Maintainer](https://img.shields.io/badge/maintainer-%40sopelj-blue.svg)](https://github.com/sopelj)
9
9
  [![License](https://img.shields.io/github/license/sopelj/python-ember-mug.svg)](https://github.com/sopelj/python-ember-mug/blob/main/LICENSE)
10
10
  [![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen)](https://github.com/pre-commit/pre-commit)
@@ -137,8 +137,6 @@ Device Data
137
137
  +--------------+----------------------+
138
138
  | Target Temp | 55.00°C |
139
139
  +--------------+----------------------+
140
- | Use Metric | True |
141
- +--------------+----------------------+
142
140
 
143
141
  Watching for changes
144
142
  Current Temp changed from "24.50°C" to "25.50°"
@@ -6,4 +6,4 @@ __all__ = ("EmberMug",)
6
6
 
7
7
  __author__ = """Jesse Sopel"""
8
8
  __email__ = "jesse.sopel@gmail.com"
9
- __version__ = "1.3.0b4"
9
+ __version__ = "1.3.0b5"
@@ -112,9 +112,9 @@ async def poll_device_cmd(args: Namespace) -> None:
112
112
  for _ in CommandLoop():
113
113
  for _ in range(60):
114
114
  await asyncio.sleep(1)
115
- print_changes(await mug.update_queued_attributes(), mug.data.use_metric)
115
+ print_changes(await mug.update_queued_attributes(), mug.data.user_unit)
116
116
  # Every minute do a full update
117
- print_changes(await mug.update_all(), mug.data.use_metric)
117
+ print_changes(await mug.update_all(), mug.data.user_unit)
118
118
 
119
119
 
120
120
  async def get_device_value_cmd(args: Namespace) -> None:
@@ -8,7 +8,7 @@ from collections import defaultdict
8
8
  from functools import partial
9
9
  from typing import TYPE_CHECKING
10
10
 
11
- from ember_mug.consts import MAC_ADDRESS_REGEX
11
+ from ember_mug.consts import MAC_ADDRESS_REGEX, TemperatureUnit
12
12
  from ember_mug.data import Change
13
13
  from ember_mug.formatting import format_led_colour, format_liquid_level, format_temp
14
14
 
@@ -62,11 +62,11 @@ def print_info(mug: EmberMug) -> None:
62
62
  print_table(list(mug.data.formatted.items()))
63
63
 
64
64
 
65
- def print_changes(changes: list[Change], metric: bool = True) -> None:
65
+ def print_changes(changes: list[Change], unit: TemperatureUnit | None) -> None:
66
66
  """Print changes."""
67
67
  formatters: dict[str, Callable] = {
68
- "current_temp": partial(format_temp, metric=metric),
69
- "target_temp": partial(format_temp, metric=metric),
68
+ "current_temp": partial(format_temp, unit=unit),
69
+ "target_temp": partial(format_temp, unit=unit),
70
70
  **base_formatters,
71
71
  }
72
72
  for attr, old_value, new_value in changes:
@@ -240,7 +240,6 @@ ATTR_LABELS = {
240
240
  "liquid_level": "Liquid Level",
241
241
  "current_temp": "Current Temp",
242
242
  "target_temp": "Target Temp",
243
- "use_metric": "Use Metric",
244
243
  "dsk": "DSK",
245
244
  "udsk": "UDSK",
246
245
  "date_time_zone": "Date Time + Time Zone",
@@ -211,7 +211,7 @@ class MugData(AsDict):
211
211
 
212
212
  # Options
213
213
  model_info: ModelInfo
214
- use_metric: bool = True
214
+ use_metric: bool | None = None
215
215
  debug: bool = False
216
216
 
217
217
  # Attributes
@@ -231,6 +231,15 @@ class MugData(AsDict):
231
231
  date_time_zone: datetime | None = None
232
232
  battery_voltage: int | None = None
233
233
 
234
+ @property
235
+ def user_unit(self) -> TemperatureUnit | None:
236
+ """Get the correct unit for the user."""
237
+ if self.use_metric is False:
238
+ return TemperatureUnit.FAHRENHEIT
239
+ if self.use_metric is True:
240
+ return TemperatureUnit.CELSIUS
241
+ return None
242
+
234
243
  @property
235
244
  def meta_display(self) -> str:
236
245
  """Return Meta infor based on preference."""
@@ -263,12 +272,12 @@ class MugData(AsDict):
263
272
  @property
264
273
  def current_temp_display(self) -> str:
265
274
  """Human-readable current temp with unit."""
266
- return format_temp(self.current_temp, self.use_metric)
275
+ return format_temp(self.current_temp, self.user_unit)
267
276
 
268
277
  @property
269
278
  def target_temp_display(self) -> str:
270
279
  """Human-readable target temp with unit."""
271
- return format_temp(self.target_temp, self.use_metric)
280
+ return format_temp(self.target_temp, self.user_unit)
272
281
 
273
282
  def update_info(self, **kwargs: Any) -> list[Change]:
274
283
  """Update attributes of the mug if they haven't changed."""
@@ -288,7 +297,7 @@ class MugData(AsDict):
288
297
  @property
289
298
  def formatted(self) -> dict[str, Any]:
290
299
  """Return human-readable names and values for all attributes for display."""
291
- all_attrs = self.model_info.device_attributes | {"use_metric"}
300
+ all_attrs = set(self.model_info.device_attributes)
292
301
  if not self.debug:
293
302
  all_attrs -= EXTRA_ATTRS
294
303
  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):
296
305
  def as_dict(self) -> dict[str, Any]:
297
306
  """Dump all attributes as dict for info/debugging."""
298
307
  data = asdict(self)
308
+ del data["use_metric"]
299
309
  all_attrs = self.model_info.device_attributes
300
310
  if not self.debug:
301
311
  all_attrs -= EXTRA_ATTRS
@@ -5,16 +5,17 @@ from __future__ import annotations
5
5
  from typing import TYPE_CHECKING
6
6
 
7
7
  if TYPE_CHECKING:
8
+ from .consts import TemperatureUnit
8
9
  from .data import Colour
9
10
 
10
11
 
11
- def format_temp(temp: float, metric: bool = True) -> str:
12
+ def format_temp(temp: float, unit: TemperatureUnit | None = None) -> str:
12
13
  """Format temperature with the correct unit."""
13
- unit = "C" if metric else "F"
14
- return f"{temp:.2f}°{unit}"
14
+ value = f"{temp:.2f}"
15
+ return f"{value}{unit.value}" if unit else value
15
16
 
16
17
 
17
- def format_capacity(capacity: int | None, metric: bool = True) -> str:
18
+ def format_capacity(capacity: int | None, metric: bool | None = None) -> str:
18
19
  """Format capacity for display."""
19
20
  if capacity is None:
20
21
  return "Unknown"
@@ -68,7 +68,7 @@ def require_attribute(
68
68
  """Inner decorator."""
69
69
 
70
70
  async def wrapper(self: EmberMug, *args: P.args, **kwargs: P.kwargs) -> T:
71
- if self.has_attribute(attr_name) is False:
71
+ if not self.has_attribute(attr_name):
72
72
  device_type = self.data.model_info.device_type.value
73
73
  raise NotImplementedError(
74
74
  f"The {device_type} does not have the {attr_name} attribute",
@@ -87,7 +87,7 @@ class EmberMug:
87
87
  self,
88
88
  ble_device: BLEDevice,
89
89
  model_info: ModelInfo,
90
- use_metric: bool = True,
90
+ use_metric: bool | None = None,
91
91
  debug: bool = False,
92
92
  **kwargs: Any,
93
93
  ) -> None:
@@ -136,17 +136,17 @@ class EmberMug:
136
136
 
137
137
  def _convert_to_device_unit(self, value: float) -> float:
138
138
  """Convert user value to the unit the device expects."""
139
- if self.data.use_metric and self.data.temperature_unit != TemperatureUnit.CELSIUS:
139
+ if self.data.user_unit == TemperatureUnit.CELSIUS and self.data.temperature_unit == TemperatureUnit.FAHRENHEIT:
140
140
  return convert_temp_to_fahrenheit(value)
141
- if not self.data.use_metric and self.data.temperature_unit != TemperatureUnit.FAHRENHEIT:
141
+ if self.data.user_unit == TemperatureUnit.FAHRENHEIT and self.data.temperature_unit == TemperatureUnit.CELSIUS:
142
142
  return convert_temp_to_celsius(value)
143
143
  return value
144
144
 
145
145
  def _convert_to_user_unit(self, value: float) -> float:
146
146
  """Convert device value to the unit the user expects."""
147
- if self.data.use_metric and self.data.temperature_unit != TemperatureUnit.CELSIUS:
147
+ if self.data.user_unit == TemperatureUnit.CELSIUS and self.data.temperature_unit == TemperatureUnit.FAHRENHEIT:
148
148
  return convert_temp_to_celsius(value)
149
- if not self.data.use_metric and self.data.temperature_unit != TemperatureUnit.FAHRENHEIT:
149
+ if self.data.user_unit == TemperatureUnit.FAHRENHEIT and self.data.temperature_unit == TemperatureUnit.CELSIUS:
150
150
  return convert_temp_to_fahrenheit(value)
151
151
  return value
152
152
 
@@ -314,11 +314,11 @@ class EmberMug:
314
314
 
315
315
  async def set_target_temp(self, target_temp: float) -> None:
316
316
  """Set new target temp for mug."""
317
- unit = TemperatureUnit.CELSIUS if self.data.use_metric else TemperatureUnit.FAHRENHEIT
318
- min_temp, max_temp = MIN_MAX_TEMPS[unit]
319
- if target_temp != 0 and not (min_temp <= target_temp <= max_temp):
320
- raise ValueError(f"Temperature should be between {min_temp} and {max_temp} or 0.")
321
-
317
+ if self.data.use_metric is not None:
318
+ unit = TemperatureUnit.FAHRENHEIT if self.data.use_metric is False else TemperatureUnit.CELSIUS
319
+ min_temp, max_temp = MIN_MAX_TEMPS[unit]
320
+ if target_temp != 0 and not (min_temp <= target_temp <= max_temp):
321
+ raise ValueError(f"Temperature should be between {min_temp} and {max_temp} or 0.")
322
322
  target_temp = self._convert_to_device_unit(target_temp)
323
323
  target = bytearray(round(target_temp / 0.01).to_bytes(2, "little"))
324
324
  await self._write(MugCharacteristic.TARGET_TEMPERATURE, target)
@@ -410,12 +410,6 @@ class EmberMug:
410
410
  await self._write(MugCharacteristic.TEMPERATURE_UNIT, unit_bytes)
411
411
  self.data.temperature_unit = TemperatureUnit(unit)
412
412
 
413
- async def ensure_correct_unit(self) -> None:
414
- """Set mug unit if it's not what we want."""
415
- desired = TemperatureUnit.CELSIUS if self.data.use_metric else TemperatureUnit.FAHRENHEIT
416
- if self.data.temperature_unit != desired:
417
- await self.set_temperature_unit(desired)
418
-
419
413
  async def get_battery_voltage(self) -> int:
420
414
  """Get voltage and charge time."""
421
415
  battery_voltage_bytes = await self._read(MugCharacteristic.CONTROL_REGISTER_DATA)
@@ -14,10 +14,11 @@ classifiers = [
14
14
  'Programming Language :: Python :: 3.11',
15
15
  'Programming Language :: Python :: 3.12',
16
16
  'Programming Language :: Python :: 3.13',
17
+ 'Programming Language :: Python :: 3.14',
17
18
  ]
18
19
  dependencies = [
19
20
  "bleak-retry-connector>=4.0.2",
20
- "bleak>=1.0.1",
21
+ "bleak>=1.0.1,<2.2.0",
21
22
  ]
22
23
 
23
24
  [project.optional-dependencies]
@@ -72,7 +73,8 @@ python = "3.13"
72
73
  features = ["test"]
73
74
 
74
75
  [[tool.hatch.envs.test.matrix]]
75
- python = ["3.11", "3.12", "3.13"]
76
+ python = ["3.11", "3.12", "3.13", "3.14"]
77
+ bleak = ["1.0.1", "2.0.0"]
76
78
 
77
79
  [tool.hatch.envs.test.scripts]
78
80
  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"
89
91
  [tool.black]
90
92
  line-length = 120
91
93
  skip-string-normalization = true
92
- target-version = ["py311", "py312", "py313"]
94
+ target-version = ["py311", "py312", "py313", "py314"]
93
95
  include = '\.pyi?$'
94
96
  exclude = '''
95
97
  /(