Add deprecation warning for lock supported features when using magic numbers (#106620)

homeassistant/components/lock/__init__.py

@@ -278,7 +278,12 @@ class LockEntity(Entity, cached_properties=CACHED_PROPERTIES_WITH_ATTR_):
     @cached_property
     def supported_features(self) -> LockEntityFeature:
         """Return the list of supported features."""
-        return self._attr_supported_features
+        features = self._attr_supported_features
+        if type(features) is int:  # noqa: E721
+            new_features = LockEntityFeature(features)
+            self._report_deprecated_supported_features_values(new_features)
+            return new_features
+        return features
 
     async def async_internal_added_to_hass(self) -> None:
         """Call when the sensor entity is added to hass."""

tests/components/lock/test_init.py

@@ -378,3 +378,20 @@ def test_deprecated_constants(
 ) -> None:
     """Test deprecated constants."""
     import_and_test_deprecated_constant_enum(caplog, lock, enum, "SUPPORT_", "2025.1")
+
+
+def test_deprecated_supported_features_ints(caplog: pytest.LogCaptureFixture) -> None:
+    """Test deprecated supported features ints."""
+
+    class MockLockEntity(lock.LockEntity):
+        _attr_supported_features = 1
+
+    entity = MockLockEntity()
+    assert entity.supported_features is lock.LockEntityFeature(1)
+    assert "MockLockEntity" in caplog.text
+    assert "is using deprecated supported features values" in caplog.text
+    assert "Instead it should use" in caplog.text
+    assert "LockEntityFeature.OPEN" in caplog.text
+    caplog.clear()
+    assert entity.supported_features is lock.LockEntityFeature(1)
+    assert "is using deprecated supported features values" not in caplog.text