python-kasa
diff --git a/‎kasa/feature.py
Lines changed: 8 additions & 1 deletion b/‎kasa/feature.py
Lines changed: 8 additions & 1 deletion
diff --git a/‎kasa/iot/modules/emeter.py
Lines changed: 6 additions & 0 deletions b/‎kasa/iot/modules/emeter.py
Lines changed: 6 additions & 0 deletions
diff --git a/‎kasa/smart/modules/energymodule.py
Lines changed: 3 additions & 0 deletions b/‎kasa/smart/modules/energymodule.py
Lines changed: 3 additions & 0 deletions
diff --git a/‎kasa/tests/test_feature.py
Lines changed: 12 additions & 0 deletions b/‎kasa/tests/test_feature.py
Lines changed: 12 additions & 0 deletions
@@ -79,6 +79,10 @@ class Category(Enum):
     #: Type of the feature
     type: Feature.Type = Type.Sensor
 
+    # Display hints offer a way suggest how the value should be shown to users
+    #: Hint to help rounding the sensor values to given after-comma digits
+    precision_hint: int | None = None
+
     # Number-specific attributes
     #: Minimum value
     minimum_value: int = 0
@@ -151,7 +155,10 @@ async def set_value(self, value):
         return await getattr(container, self.attribute_setter)(value)
 
     def __repr__(self):
-        s = f"{self.name} ({self.id}): {self.value}"
+        value = self.value
+        if self.precision_hint is not None and value is not None:
+            value = round(self.value, self.precision_hint)
+        s = f"{self.name} ({self.id}): {value}"
         if self.unit is not None:
             s += f" {self.unit}"
 
 
@@ -23,6 +23,7 @@ def __init__(self, device: Device, module: str):
                 container=self,
                 unit="W",
                 id="current_power_w",  # for homeassistant backwards compat
+                precision_hint=1,
             )
         )
         self._add_feature(
@@ -33,6 +34,7 @@ def __init__(self, device: Device, module: str):
                 container=self,
                 unit="kWh",
                 id="today_energy_kwh",  # for homeassistant backwards compat
+                precision_hint=3,
             )
         )
         self._add_feature(
@@ -42,6 +44,7 @@ def __init__(self, device: Device, module: str):
                 attribute_getter="emeter_this_month",
                 container=self,
                 unit="kWh",
+                precision_hint=3,
             )
         )
         self._add_feature(
@@ -52,6 +55,7 @@ def __init__(self, device: Device, module: str):
                 container=self,
                 unit="kWh",
                 id="total_energy_kwh",  # for homeassistant backwards compat
+                precision_hint=3,
             )
         )
         self._add_feature(
@@ -62,6 +66,7 @@ def __init__(self, device: Device, module: str):
                 container=self,
                 unit="V",
                 id="voltage",  # for homeassistant backwards compat
+                precision_hint=1,
             )
         )
         self._add_feature(
@@ -72,6 +77,7 @@ def __init__(self, device: Device, module: str):
                 container=self,
                 unit="A",
                 id="current_a",  # for homeassistant backwards compat
+                precision_hint=2,
             )
         )
 
 
@@ -26,6 +26,7 @@ def __init__(self, device: SmartDevice, module: str):
                 attribute_getter="current_power",
                 container=self,
                 unit="W",
+                precision_hint=1,
             )
         )
         self._add_feature(
@@ -35,6 +36,7 @@ def __init__(self, device: SmartDevice, module: str):
                 attribute_getter="emeter_today",
                 container=self,
                 unit="Wh",
+                precision_hint=2,
             )
         )
         self._add_feature(
@@ -44,6 +46,7 @@ def __init__(self, device: SmartDevice, module: str):
                 attribute_getter="emeter_this_month",
                 container=self,
                 unit="Wh",
+                precision_hint=2,
             )
         )
 
 
@@ -108,3 +108,15 @@ async def test_feature_action(mocker):
     assert feat.value == "<Action>"
     await feat.set_value(1234)
     mock_call_action.assert_called()
+
+
+@pytest.mark.parametrize("precision_hint", [1, 2, 3])
+async def test_precision_hint(dummy_feature, precision_hint):
+    """Test that precision hint works as expected."""
+    dummy_value = 3.141593
+    dummy_feature.type = Feature.Type.Sensor
+    dummy_feature.precision_hint = precision_hint
+
+    dummy_feature.attribute_getter = lambda x: dummy_value
+    assert dummy_feature.value == dummy_value
+    assert f"{round(dummy_value, precision_hint)} dummyunit" in repr(dummy_feature)
Original file line number	Diff line number	Diff line change
`@@ -23,6 +23,7 @@ def __init__(self, device: Device, module: str):`
`23`	`23`	`container=self,`
`24`	`24`	`unit="W",`
`25`	`25`	`id="current_power_w", # for homeassistant backwards compat`
	`26`	`+ precision_hint=1,`
`26`	`27`	`)`
`27`	`28`	`)`
28	`29`	`self._add_feature(`
`@@ -33,6 +34,7 @@ def __init__(self, device: Device, module: str):`
`33`	`34`	`container=self,`
`34`	`35`	`unit="kWh",`
`35`	`36`	`id="today_energy_kwh", # for homeassistant backwards compat`
	`37`	`+ precision_hint=3,`
`36`	`38`	`)`
`37`	`39`	`)`
`38`	`40`	`self._add_feature(`
`@@ -42,6 +44,7 @@ def __init__(self, device: Device, module: str):`
`42`	`44`	`attribute_getter="emeter_this_month",`
`43`	`45`	`container=self,`
`44`	`46`	`unit="kWh",`
	`47`	`+ precision_hint=3,`
`45`	`48`	`)`
`46`	`49`	`)`
`47`	`50`	`self._add_feature(`
`@@ -52,6 +55,7 @@ def __init__(self, device: Device, module: str):`
`52`	`55`	`container=self,`
`53`	`56`	`unit="kWh",`
`54`	`57`	`id="total_energy_kwh", # for homeassistant backwards compat`
	`58`	`+ precision_hint=3,`
`55`	`59`	`)`
`56`	`60`	`)`
`57`	`61`	`self._add_feature(`
`@@ -62,6 +66,7 @@ def __init__(self, device: Device, module: str):`
`62`	`66`	`container=self,`
`63`	`67`	`unit="V",`
`64`	`68`	`id="voltage", # for homeassistant backwards compat`
	`69`	`+ precision_hint=1,`
`65`	`70`	`)`
`66`	`71`	`)`
`67`	`72`	`self._add_feature(`
`@@ -72,6 +77,7 @@ def __init__(self, device: Device, module: str):`
`72`	`77`	`container=self,`
`73`	`78`	`unit="A",`
`74`	`79`	`id="current_a", # for homeassistant backwards compat`
	`80`	`+ precision_hint=2,`
`75`	`81`	`)`
`76`	`82`	`)`
`77`	`83`
Original file line number	Diff line number	Diff line change
`@@ -26,6 +26,7 @@ def __init__(self, device: SmartDevice, module: str):`
`26`	`26`	`attribute_getter="current_power",`
`27`	`27`	`container=self,`
`28`	`28`	`unit="W",`
	`29`	`+ precision_hint=1,`
`29`	`30`	`)`
`30`	`31`	`)`
`31`	`32`	`self._add_feature(`
`@@ -35,6 +36,7 @@ def __init__(self, device: SmartDevice, module: str):`
`35`	`36`	`attribute_getter="emeter_today",`
`36`	`37`	`container=self,`
`37`	`38`	`unit="Wh",`
	`39`	`+ precision_hint=2,`
`38`	`40`	`)`
`39`	`41`	`)`
`40`	`42`	`self._add_feature(`
`@@ -44,6 +46,7 @@ def __init__(self, device: SmartDevice, module: str):`
`44`	`46`	`attribute_getter="emeter_this_month",`
`45`	`47`	`container=self,`
`46`	`48`	`unit="Wh",`
	`49`	`+ precision_hint=2,`
`47`	`50`	`)`
`48`	`51`	`)`
`49`	`52`