feat: add support to control led brightness (#389)

* feat: add support to control led brightness

* formatting

* remove return value

* linting

* formatting

* update tests

* formatting

Author: firstof9

openevsehttp/__main__.py

@@ -827,6 +827,28 @@ async def list_claims(self) -> Any:
         response = await self.process_request(url=url, method="get")  # noqa: E501
         return response
 
+    async def set_led_brightness(self, level: int) -> None:
+        """Set LED brightness level."""
+        if not self._version_check("4.1.0"):
+            _LOGGER.debug("Feature not supported for older firmware.")
+            raise UnsupportedFeature
+
+        url = f"{self.url}config"
+        data: dict[str, Any] = {}
+
+        data["led_brightness"] = level
+        _LOGGER.debug("Setting LED brightness to %s", level)
+        await self.process_request(url=url, method="post", data=data)  # noqa: E501
+
+    @property
+    def led_brightness(self) -> str:
+        """Return charger led_brightness."""
+        if not self._version_check("4.1.0"):
+            _LOGGER.debug("Feature not supported for older firmware.")
+            raise UnsupportedFeature
+        assert self._config is not None
+        return self._config["led_brightness"]
+
     @property
     def hostname(self) -> str:
         """Return charger hostname."""

tests/test_main.py

@@ -1834,3 +1834,38 @@ async def test_checks_count(fixture, expected, request):
     await charger.update()
     status = charger.checks_count
     assert status == expected
+
+
+async def test_led_brightness(test_charger_new, test_charger_v2, caplog):
+    """Test led_brightness reply."""
+    await test_charger_new.update()
+    status = test_charger_new.led_brightness
+    assert status == 125
+
+    await test_charger_v2.update()
+    with pytest.raises(UnsupportedFeature):
+        with caplog.at_level(logging.DEBUG):
+            status = await test_charger_v2.led_brightness
+    assert "Feature not supported for older firmware." in caplog.text
+
+
+async def test_set_led_brightness(
+    test_charger_new, test_charger_v2, mock_aioclient, caplog
+):
+    """Test set_led_brightness reply."""
+    await test_charger_new.update()
+    value = '{"msg": "OK"}'
+    mock_aioclient.post(
+        TEST_URL_CONFIG,
+        status=200,
+        body=value,
+    )
+    with caplog.at_level(logging.DEBUG):
+        await test_charger_new.set_led_brightness(255)
+    assert "Setting LED brightness to 255" in caplog.text
+
+    await test_charger_v2.update()
+    with pytest.raises(UnsupportedFeature):
+        with caplog.at_level(logging.DEBUG):
+            await test_charger_v2.set_led_brightness(255)
+    assert "Feature not supported for older firmware." in caplog.text