ucapi-framework 1.8.4__tar.gz → 1.9.0__tar.gz

{ucapi_framework-1.8.4 → ucapi_framework-1.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ucapi-framework
-Version: 1.8.4
+Version: 1.9.0
 Summary: ucapi framework that provides core functionality for building integrations.
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -10,7 +10,7 @@ Requires-Dist: aiohttp>=3.9.0
 
 [![Tests](https://github.com/jackjpowell/ucapi-framework/actions/workflows/test.yml/badge.svg)](https://github.com/jackjpowell/ucapi-framework/actions/workflows/test.yml)
 [![Discord](https://badgen.net/discord/online-members/zGVYf58)](https://discord.gg/zGVYf58)
-[![Buy Me A Coffee](https://img.shields.io/badge/Buy_Me_A_Coffee ☕-FFDD00?logo=buy-me-a-coffee&logoColor=white&labelColor=grey)](https://buymeacoffee.com/jackpowell)
+[![Buy Me A Coffee](https://img.shields.io/badge/Buy_Me_A_Coffee-FFDD00?logo=buy-me-a-coffee&logoColor=white&labelColor=grey)](https://buymeacoffee.com/jackpowell)
 
 # UCAPI Framework
 
@@ -86,12 +86,12 @@ The driver coordinates everything - device lifecycle, entity management, and Rem
 
 The framework provides sensible defaults for:
 
-- **`create_entities()`** - Creates one entity per entity type automatically
-- **`map_device_state()`** - Maps common state strings (ON, OFF, PLAYING, etc.)
-- **`device_from_entity_id()`** - Parses standard entity ID format
+- **`create_entities()`** - Instantiates entities from the `entity_classes` list passed to the constructor; each item can be a class or a factory lambda `(config, device) -> Entity | list[Entity]`
+- **`map_device_state()`** - Maps common state strings (ON, OFF, PLAYING, etc.) to `media_player.States`
+- **`device_from_entity_id()`** - Parses the standard `entity_type.device_id` format
 - **`get_entity_ids_for_device()`** - Queries and filters entities by device
 
-**Override only what you need**: Custom state enums? Override `map_device_state()`. Conditional entity creation? Override `create_entities()`. Custom entity ID format? Override `device_from_entity_id()` too.
+**Override only what you need**: Custom state enums? Override `map_device_state()`. Logic that can't fit in a lambda? Override `create_entities()`. Custom entity ID format? Override `device_from_entity_id()`.
 
 Everything else is automatic. The framework handles Remote connection events (connect, disconnect, standby), entity subscriptions, device lifecycle management, and state synchronization.
 
@@ -119,13 +119,13 @@ All discovery classes handle the protocol details, timeouts, and error handling.
 
 The driver base class automatically wires up Remote events (connect, disconnect, standby, subscribe/unsubscribe) with sensible defaults. You can override any of them, but the defaults handle most cases.
 
-Device events (state changes, errors) automatically propagate to entity state updates. You just emit events from your device and the framework keeps the Remote in sync.
+State flows from device to Remote via the coordinator pattern: the device stores raw state properties and calls `push_update()` when anything changes. Every entity subscribed via `subscribe_to_device()` has its `sync_state()` method called automatically, which reads from the device and calls `self.update({...})` with a fresh dict. The framework diffs against the last-pushed state and sends only changed attributes to the Remote.
 
 ## How It Works
 
 You inherit from base classes and override only what you need:
 
-**Driver** - Usually works with defaults! Override only if you need custom state mapping or conditional entity creation.
+**Driver** - Usually works with defaults. Pass `entity_classes` to the constructor. Override only if you need custom state mapping or conditional entity creation.
 
 **Device** - Implement your connection pattern (verify, poll, handle messages, etc.).
 
@@ -176,34 +176,22 @@ Optional discovery implementations for common protocols:
 
 Lazy imports mean you only need the dependencies if you use them.
 
-## Real-World Example
-
-See the PSN integration in this repository:
-
-- `intg-psn/driver.py` - 90 lines (was 300)
-- `intg-psn/psn.py` - 140 lines (was 240)
-- `intg-psn/setup_flow.py` - 50 lines (was 250)
-- `intg-psn/config.py` - 15 lines (was 95)
-
-Total: ~295 lines of integration code vs ~885 lines previously. And the new code is type-safe, testable, and maintainable.
 
 ## Migration
 
-If you have an existing integration, see [MIGRATION_GUIDE.md](MIGRATION_GUIDE.md) for step-by-step instructions with before/after examples.
-
-For upgrading from a previous version of ucapi-framework:
-- **[Upgrading to 1.6.0](https://jackjpowell.github.io/ucapi-framework/upgrade-to-1.6.0/)** - New dynamic entity management features
+If you have an existing integration, see [MIGRATION_GUIDE.md](MIGRATION_GUIDE.md) for step-by-step instructions with before/after examples covering the coordinator pattern, `subscribe_to_device`, `sync_state`, and `push_update`.
 
 ## Requirements
 
 - Python 3.11+
 - ucapi
 - pyee
+- aiohttp (required; used by HTTP and WebSocket device base classes)
+
+Optional (only if you use the corresponding discovery classes):
 
-Optional (only if you use them):
-- aiohttp (for HTTP devices)
-- websockets (for WebSocket devices)
 - ssdpy (for SSDP discovery)
+- sddp-discovery-protocol (for SDDP discovery)
 - zeroconf (for mDNS discovery)
 
 ## Documentation
@@ -231,9 +219,14 @@ Visit <http://127.0.0.1:8000> to view the docs.
 uv sync --group dev
 ```
 
-Git hooks are automatically active from the `git-hooks/` directory:
+A `pre-commit` hook is available in the `git-hooks/` directory. To activate it:
+
+```bash
+cp git-hooks/pre-commit .git/hooks/pre-commit
+chmod +x .git/hooks/pre-commit
+```
 
-- **pre-commit**: Runs `ruff check --fix` and `ruff format` via `uv run`
+The hook runs `ruff check --fix` and `ruff format` before every commit.
 
 All development tools run through `uv` and are configured in `pyproject.toml`.
 

{ucapi_framework-1.8.4 → ucapi_framework-1.9.0}/README.md

@@ -1,6 +1,6 @@
 [![Tests](https://github.com/jackjpowell/ucapi-framework/actions/workflows/test.yml/badge.svg)](https://github.com/jackjpowell/ucapi-framework/actions/workflows/test.yml)
 [![Discord](https://badgen.net/discord/online-members/zGVYf58)](https://discord.gg/zGVYf58)
-[![Buy Me A Coffee](https://img.shields.io/badge/Buy_Me_A_Coffee ☕-FFDD00?logo=buy-me-a-coffee&logoColor=white&labelColor=grey)](https://buymeacoffee.com/jackpowell)
+[![Buy Me A Coffee](https://img.shields.io/badge/Buy_Me_A_Coffee-FFDD00?logo=buy-me-a-coffee&logoColor=white&labelColor=grey)](https://buymeacoffee.com/jackpowell)
 
 # UCAPI Framework
 
@@ -76,12 +76,12 @@ The driver coordinates everything - device lifecycle, entity management, and Rem
 
 The framework provides sensible defaults for:
 
-- **`create_entities()`** - Creates one entity per entity type automatically
-- **`map_device_state()`** - Maps common state strings (ON, OFF, PLAYING, etc.)
-- **`device_from_entity_id()`** - Parses standard entity ID format
+- **`create_entities()`** - Instantiates entities from the `entity_classes` list passed to the constructor; each item can be a class or a factory lambda `(config, device) -> Entity | list[Entity]`
+- **`map_device_state()`** - Maps common state strings (ON, OFF, PLAYING, etc.) to `media_player.States`
+- **`device_from_entity_id()`** - Parses the standard `entity_type.device_id` format
 - **`get_entity_ids_for_device()`** - Queries and filters entities by device
 
-**Override only what you need**: Custom state enums? Override `map_device_state()`. Conditional entity creation? Override `create_entities()`. Custom entity ID format? Override `device_from_entity_id()` too.
+**Override only what you need**: Custom state enums? Override `map_device_state()`. Logic that can't fit in a lambda? Override `create_entities()`. Custom entity ID format? Override `device_from_entity_id()`.
 
 Everything else is automatic. The framework handles Remote connection events (connect, disconnect, standby), entity subscriptions, device lifecycle management, and state synchronization.
 
@@ -109,13 +109,13 @@ All discovery classes handle the protocol details, timeouts, and error handling.
 
 The driver base class automatically wires up Remote events (connect, disconnect, standby, subscribe/unsubscribe) with sensible defaults. You can override any of them, but the defaults handle most cases.
 
-Device events (state changes, errors) automatically propagate to entity state updates. You just emit events from your device and the framework keeps the Remote in sync.
+State flows from device to Remote via the coordinator pattern: the device stores raw state properties and calls `push_update()` when anything changes. Every entity subscribed via `subscribe_to_device()` has its `sync_state()` method called automatically, which reads from the device and calls `self.update({...})` with a fresh dict. The framework diffs against the last-pushed state and sends only changed attributes to the Remote.
 
 ## How It Works
 
 You inherit from base classes and override only what you need:
 
-**Driver** - Usually works with defaults! Override only if you need custom state mapping or conditional entity creation.
+**Driver** - Usually works with defaults. Pass `entity_classes` to the constructor. Override only if you need custom state mapping or conditional entity creation.
 
 **Device** - Implement your connection pattern (verify, poll, handle messages, etc.).
 
@@ -166,34 +166,22 @@ Optional discovery implementations for common protocols:
 
 Lazy imports mean you only need the dependencies if you use them.
 
-## Real-World Example
-
-See the PSN integration in this repository:
-
-- `intg-psn/driver.py` - 90 lines (was 300)
-- `intg-psn/psn.py` - 140 lines (was 240)
-- `intg-psn/setup_flow.py` - 50 lines (was 250)
-- `intg-psn/config.py` - 15 lines (was 95)
-
-Total: ~295 lines of integration code vs ~885 lines previously. And the new code is type-safe, testable, and maintainable.
 
 ## Migration
 
-If you have an existing integration, see [MIGRATION_GUIDE.md](MIGRATION_GUIDE.md) for step-by-step instructions with before/after examples.
-
-For upgrading from a previous version of ucapi-framework:
-- **[Upgrading to 1.6.0](https://jackjpowell.github.io/ucapi-framework/upgrade-to-1.6.0/)** - New dynamic entity management features
+If you have an existing integration, see [MIGRATION_GUIDE.md](MIGRATION_GUIDE.md) for step-by-step instructions with before/after examples covering the coordinator pattern, `subscribe_to_device`, `sync_state`, and `push_update`.
 
 ## Requirements
 
 - Python 3.11+
 - ucapi
 - pyee
+- aiohttp (required; used by HTTP and WebSocket device base classes)
+
+Optional (only if you use the corresponding discovery classes):
 
-Optional (only if you use them):
-- aiohttp (for HTTP devices)
-- websockets (for WebSocket devices)
 - ssdpy (for SSDP discovery)
+- sddp-discovery-protocol (for SDDP discovery)
 - zeroconf (for mDNS discovery)
 
 ## Documentation
@@ -221,9 +209,14 @@ Visit <http://127.0.0.1:8000> to view the docs.
 uv sync --group dev
 ```
 
-Git hooks are automatically active from the `git-hooks/` directory:
+A `pre-commit` hook is available in the `git-hooks/` directory. To activate it:
+
+```bash
+cp git-hooks/pre-commit .git/hooks/pre-commit
+chmod +x .git/hooks/pre-commit
+```
 
-- **pre-commit**: Runs `ruff check --fix` and `ruff format` via `uv run`
+The hook runs `ruff check --fix` and `ruff format` before every commit.
 
 All development tools run through `uv` and are configured in `pyproject.toml`.
 

{ucapi_framework-1.8.4 → ucapi_framework-1.9.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ucapi-framework"
-version = "1.8.4"
+version = "1.9.0"
 description = "ucapi framework that provides core functionality for building integrations."
 readme = "README.md"
 requires-python = ">=3.11"

ucapi_framework-1.9.0/tests/test_button_entity.py

@@ -0,0 +1,154 @@
+"""Tests for ButtonEntity with built-in state management."""
+
+import pytest
+from unittest.mock import MagicMock
+from ucapi import button
+from ucapi_framework import ButtonEntity
+
+
+class TestButtonEntity:
+    """Test ButtonEntity state management."""
+
+    @pytest.fixture
+    def mock_api(self):
+        """Create a mock API for testing."""
+        api = MagicMock()
+        api.configured_entities.get.return_value = MagicMock(
+            attributes={button.Attributes.STATE: button.States.AVAILABLE}
+        )
+        return api
+
+    @pytest.fixture
+    def entity(self, mock_api):
+        """Create a ButtonEntity for testing."""
+        entity = ButtonEntity(
+            "button.test",
+            "Test Button",
+        )
+        entity._api = mock_api  # noqa: SLF001
+        return entity
+
+    def test_initial_state(self, entity):
+        """Test initial state from constructor attributes."""
+        assert entity.state == button.States.AVAILABLE
+
+    def test_initial_state_always_available(self, mock_api):
+        """Test that button always initializes STATE to AVAILABLE (ucapi hardcodes this)."""
+        entity = ButtonEntity(
+            "button.unset",
+            "Unset Button",
+        )
+        entity._api = mock_api  # noqa: SLF001
+        # ucapi.button.Button hardcodes {Attributes.STATE: States.AVAILABLE} in __init__
+        assert entity.state == button.States.AVAILABLE
+
+    def test_set_state_with_update(self, entity, mock_api):
+        """Test set_state() calls entity.update() by default."""
+        entity.set_state(button.States.UNAVAILABLE, update=True)
+
+        # Verify internal state was updated
+        assert entity.state == button.States.UNAVAILABLE
+
+        # Verify update was called
+        assert mock_api.configured_entities.update_attributes.called
+        call_args = mock_api.configured_entities.update_attributes.call_args
+        entity_id, attributes = call_args[0]
+        assert entity_id == "button.test"
+        assert button.Attributes.STATE in attributes
+        assert attributes[button.Attributes.STATE] == button.States.UNAVAILABLE
+
+    def test_set_state_without_update(self, entity, mock_api):
+        """Test set_state(update=False) does not call entity.update()."""
+        entity.set_state(button.States.UNAVAILABLE, update=False)
+
+        # Verify internal state was updated
+        assert entity.state == button.States.UNAVAILABLE
+
+        # Verify update was NOT called
+        assert not mock_api.configured_entities.update_attributes.called
+
+    def test_set_state_available(self, entity, mock_api):
+        """Test transitioning back to AVAILABLE."""
+        entity.set_state(button.States.UNAVAILABLE, update=False)
+        assert entity.state == button.States.UNAVAILABLE
+
+        entity.set_state(button.States.AVAILABLE, update=False)
+        assert entity.state == button.States.AVAILABLE
+
+    def test_set_state_none_does_not_update_remote(self, entity, mock_api):
+        """Test set_state(None) stores None but update filter strips it."""
+        # set_state(None) writes None into attributes dict
+        entity.set_state(None, update=True)
+
+        # Internal state stores None
+        assert entity.state is None
+
+        # The update should have been called but the None filter in
+        # update_attributes strips the None value — so update_attributes
+        # is called with an empty dict (or not called if filter removes all)
+        # Either way, the Remote should not receive a None value
+        if mock_api.configured_entities.update_attributes.called:
+            call_args = mock_api.configured_entities.update_attributes.call_args
+            _, attributes = call_args[0]
+            assert button.Attributes.STATE not in attributes
+
+    def test_property_getter_is_read_only(self, entity):
+        """Test that the state property cannot be set directly."""
+        with pytest.raises(AttributeError):
+            entity.state = button.States.AVAILABLE  # type: ignore[misc]
+
+    def test_only_one_attribute(self, entity, mock_api):
+        """Test that Button only has the STATE attribute."""
+        entity.set_state(button.States.UNAVAILABLE, update=True)
+
+        call_args = mock_api.configured_entities.update_attributes.call_args
+        _, attributes = call_args[0]
+        # Should only contain STATE
+        assert list(attributes.keys()) == [button.Attributes.STATE]
+
+
+class TestButtonEntityInheritance:
+    """Test that ButtonEntity can be subclassed and overridden."""
+
+    def test_custom_set_state(self):
+        """Test that set_state can be overridden."""
+
+        class CustomButton(ButtonEntity):
+            def __init__(self):
+                super().__init__(
+                    "button.custom",
+                    "Custom Button",
+                )
+                self.custom_set_state_called = False
+
+            def set_state(self, value, *, update=True):
+                """Override set_state to add custom logic."""
+                self.custom_set_state_called = True
+                super().set_state(value, update=update)
+
+        entity = CustomButton()
+        entity._api = MagicMock()  # noqa: SLF001
+        entity._api.configured_entities.get.return_value = entity  # noqa: SLF001
+
+        entity.set_state(button.States.AVAILABLE, update=False)
+        assert entity.custom_set_state_called is True
+        assert entity.state == button.States.AVAILABLE
+
+    def test_custom_property_getter(self):
+        """Test that the state property getter can be overridden."""
+
+        class CustomButton(ButtonEntity):
+            def __init__(self):
+                super().__init__(
+                    "button.custom",
+                    "Custom Button",
+                )
+
+            @property
+            def state(self):
+                """Override state getter to always return AVAILABLE."""
+                return button.States.AVAILABLE
+
+        entity = CustomButton()
+        # Property override always returns AVAILABLE
+        assert entity.state == button.States.AVAILABLE

ucapi_framework-1.9.0/tests/test_climate_entity.py

@@ -0,0 +1,230 @@
+"""Tests for ClimateEntity with built-in state management."""
+
+import pytest
+from unittest.mock import MagicMock
+from ucapi import climate
+from ucapi_framework import ClimateEntity
+
+
+class TestClimateEntity:
+    """Test ClimateEntity state management."""
+
+    @pytest.fixture
+    def mock_api(self):
+        """Create a mock API for testing."""
+        api = MagicMock()
+        api.configured_entities.get.return_value = MagicMock(
+            attributes={climate.Attributes.STATE: climate.States.OFF}
+        )
+        return api
+
+    @pytest.fixture
+    def entity(self, mock_api):
+        """Create a ClimateEntity for testing."""
+        entity = ClimateEntity(
+            "climate.test",
+            "Test Thermostat",
+            features=[climate.Features.ON_OFF, climate.Features.HEAT],
+            attributes={climate.Attributes.STATE: climate.States.OFF},
+        )
+        entity._api = mock_api  # noqa: SLF001
+        return entity
+
+    def test_initial_state(self, entity):
+        """Test initial state from constructor attributes."""
+        assert entity.state == climate.States.OFF
+        assert entity.current_temperature is None
+        assert entity.target_temperature is None
+        assert entity.target_temperature_high is None
+        assert entity.target_temperature_low is None
+        assert entity.fan_mode is None
+
+    def test_set_state_with_update(self, entity, mock_api):
+        """Test set_state() calls entity.update() by default."""
+        entity.set_state(climate.States.HEAT, update=True)
+
+        assert entity.state == climate.States.HEAT
+
+        assert mock_api.configured_entities.update_attributes.called
+        call_args = mock_api.configured_entities.update_attributes.call_args
+        entity_id, attributes = call_args[0]
+        assert entity_id == "climate.test"
+        assert climate.Attributes.STATE in attributes
+        assert attributes[climate.Attributes.STATE] == climate.States.HEAT
+
+    def test_set_state_without_update(self, entity, mock_api):
+        """Test set_state(update=False) does not call entity.update()."""
+        entity.set_state(climate.States.COOL, update=False)
+
+        assert entity.state == climate.States.COOL
+        assert not mock_api.configured_entities.update_attributes.called
+
+    def test_set_current_temperature(self, entity, mock_api):
+        """Test set_current_temperature() updates state and calls update."""
+        entity.set_current_temperature(22.5, update=True)
+
+        assert entity.current_temperature == 22.5
+        assert mock_api.configured_entities.update_attributes.called
+
+    def test_set_current_temperature_without_update(self, entity, mock_api):
+        """Test set_current_temperature(update=False) does not call update."""
+        entity.set_current_temperature(22.5, update=False)
+
+        assert entity.current_temperature == 22.5
+        assert not mock_api.configured_entities.update_attributes.called
+
+    def test_set_target_temperature(self, entity, mock_api):
+        """Test set_target_temperature() updates state and calls update."""
+        entity.set_target_temperature(21.0, update=True)
+
+        assert entity.target_temperature == 21.0
+        assert mock_api.configured_entities.update_attributes.called
+
+    def test_set_target_temperature_without_update(self, entity, mock_api):
+        """Test set_target_temperature(update=False) does not call update."""
+        entity.set_target_temperature(21.0, update=False)
+
+        assert entity.target_temperature == 21.0
+        assert not mock_api.configured_entities.update_attributes.called
+
+    def test_set_target_temperature_high(self, entity, mock_api):
+        """Test set_target_temperature_high() updates state and calls update."""
+        entity.set_target_temperature_high(25.0, update=True)
+
+        assert entity.target_temperature_high == 25.0
+        assert mock_api.configured_entities.update_attributes.called
+
+    def test_set_target_temperature_low(self, entity, mock_api):
+        """Test set_target_temperature_low() updates state and calls update."""
+        entity.set_target_temperature_low(18.0, update=True)
+
+        assert entity.target_temperature_low == 18.0
+        assert mock_api.configured_entities.update_attributes.called
+
+    def test_set_fan_mode(self, entity, mock_api):
+        """Test set_fan_mode() updates state and calls update."""
+        entity.set_fan_mode("AUTO", update=True)
+
+        assert entity.fan_mode == "AUTO"
+        assert mock_api.configured_entities.update_attributes.called
+
+    def test_set_fan_mode_without_update(self, entity, mock_api):
+        """Test set_fan_mode(update=False) does not call update."""
+        entity.set_fan_mode("HIGH", update=False)
+
+        assert entity.fan_mode == "HIGH"
+        assert not mock_api.configured_entities.update_attributes.called
+
+    def test_set_attributes_bulk_update(self, entity, mock_api):
+        """Test set_attributes() updates multiple attributes with single update call."""
+        entity.set_attributes(
+            state=climate.States.HEAT,
+            current_temperature=20.5,
+            target_temperature=22.0,
+            fan_mode="AUTO",
+            update=True,
+        )
+
+        assert entity.state == climate.States.HEAT
+        assert entity.current_temperature == 20.5
+        assert entity.target_temperature == 22.0
+        assert entity.fan_mode == "AUTO"
+
+        # Verify update was called only once
+        assert mock_api.configured_entities.update_attributes.call_count == 1
+
+        call_args = mock_api.configured_entities.update_attributes.call_args
+        entity_id, attributes = call_args[0]
+        assert entity_id == "climate.test"
+        assert len(attributes) == 4
+        assert attributes[climate.Attributes.STATE] == climate.States.HEAT
+        assert attributes[climate.Attributes.CURRENT_TEMPERATURE] == 20.5
+        assert attributes[climate.Attributes.TARGET_TEMPERATURE] == 22.0
+        assert attributes[climate.Attributes.FAN_MODE] == "AUTO"
+
+    def test_set_attributes_without_update(self, entity, mock_api):
+        """Test set_attributes(update=False) does not call entity.update()."""
+        entity.set_attributes(
+            state=climate.States.COOL,
+            target_temperature=19.0,
+            update=False,
+        )
+
+        assert entity.state == climate.States.COOL
+        assert entity.target_temperature == 19.0
+        assert not mock_api.configured_entities.update_attributes.called
+
+    def test_set_attributes_ignores_none_values(self, entity, mock_api):
+        """Test set_attributes() ignores None values."""
+        entity.set_attributes(
+            state=climate.States.HEAT, current_temperature=None, update=True
+        )
+
+        assert entity.state == climate.States.HEAT
+        assert entity.current_temperature is None
+
+        call_args = mock_api.configured_entities.update_attributes.call_args
+        entity_id, attributes = call_args[0]
+        assert len(attributes) == 1
+        assert climate.Attributes.STATE in attributes
+
+    def test_set_attributes_all_six(self, entity, mock_api):
+        """Test setting all six climate attributes at once."""
+        entity.set_attributes(
+            state=climate.States.HEAT_COOL,
+            current_temperature=21.0,
+            target_temperature=22.0,
+            target_temperature_high=25.0,
+            target_temperature_low=18.0,
+            fan_mode="AUTO",
+            update=True,
+        )
+
+        assert entity.state == climate.States.HEAT_COOL
+        assert entity.current_temperature == 21.0
+        assert entity.target_temperature == 22.0
+        assert entity.target_temperature_high == 25.0
+        assert entity.target_temperature_low == 18.0
+        assert entity.fan_mode == "AUTO"
+
+        assert mock_api.configured_entities.update_attributes.call_count == 1
+
+    def test_property_getters_are_read_only(self, entity):
+        """Test that property getters cannot be set directly."""
+        with pytest.raises(AttributeError):
+            entity.state = climate.States.HEAT  # type: ignore[misc]
+
+        with pytest.raises(AttributeError):
+            entity.current_temperature = 20.0  # type: ignore[misc]
+
+        with pytest.raises(AttributeError):
+            entity.target_temperature = 21.0  # type: ignore[misc]
+
+
+class TestClimateEntityInheritance:
+    """Test that ClimateEntity can be subclassed and overridden."""
+
+    def test_custom_set_state(self):
+        """Test that set_state can be overridden."""
+
+        class CustomClimate(ClimateEntity):
+            def __init__(self):
+                super().__init__(
+                    "climate.custom",
+                    "Custom Thermostat",
+                    features=[],
+                    attributes={},
+                )
+                self.custom_called = False
+
+            def set_state(self, value, *, update=True):
+                self.custom_called = True
+                super().set_state(value, update=update)
+
+        entity = CustomClimate()
+        entity._api = MagicMock()  # noqa: SLF001
+        entity._api.configured_entities.get.return_value = entity  # noqa: SLF001
+
+        entity.set_state(climate.States.COOL, update=False)
+        assert entity.custom_called is True
+        assert entity.state == climate.States.COOL