Add support for for to binary_sensor, light and switch device conditions (#27153)

* Add support for `for` to binary_sensor, light and switch device conditions

* Fix typing

* Fixup

* Fixup

tests/components/binary_sensor/test_device_condition.py

@@ -1,5 +1,7 @@
 """The test for binary_sensor device automation."""
+from datetime import timedelta
 import pytest
+from unittest.mock import patch
 
 from homeassistant.components.binary_sensor import DOMAIN, DEVICE_CLASSES
 from homeassistant.components.binary_sensor.device_condition import ENTITY_CONDITIONS
@@ -7,6 +9,7 @@ from homeassistant.const import STATE_ON, STATE_OFF, CONF_PLATFORM
 from homeassistant.setup import async_setup_component
 import homeassistant.components.automation as automation
 from homeassistant.helpers import device_registry
+import homeassistant.util.dt as dt_util
 
 from tests.common import (
     MockConfigEntry,
@@ -14,6 +17,7 @@ from tests.common import (
     mock_device_registry,
     mock_registry,
     async_get_device_automations,
+    async_get_device_automation_capabilities,
 )
 
 
@@ -71,6 +75,28 @@ async def test_get_conditions(hass, device_reg, entity_reg):
     assert conditions == expected_conditions
 
 
+async def test_get_condition_capabilities(hass, device_reg, entity_reg):
+    """Test we get the expected capabilities from a binary_sensor condition."""
+    config_entry = MockConfigEntry(domain="test", data={})
+    config_entry.add_to_hass(hass)
+    device_entry = device_reg.async_get_or_create(
+        config_entry_id=config_entry.entry_id,
+        connections={(device_registry.CONNECTION_NETWORK_MAC, "12:34:56:AB:CD:EF")},
+    )
+    entity_reg.async_get_or_create(DOMAIN, "test", "5678", device_id=device_entry.id)
+    expected_capabilities = {
+        "extra_fields": [
+            {"name": "for", "optional": True, "type": "positive_time_period_dict"}
+        ]
+    }
+    conditions = await async_get_device_automations(hass, "condition", device_entry.id)
+    for condition in conditions:
+        capabilities = await async_get_device_automation_capabilities(
+            hass, "condition", condition
+        )
+        assert capabilities == expected_capabilities
+
+
 async def test_if_state(hass, calls):
     """Test for turn_on and turn_off conditions."""
     platform = getattr(hass.components, f"test.{DOMAIN}")
@@ -131,7 +157,6 @@ async def test_if_state(hass, calls):
     assert len(calls) == 0
 
     hass.bus.async_fire("test_event1")
-    hass.bus.async_fire("test_event2")
     await hass.async_block_till_done()
     assert len(calls) == 1
     assert calls[0].data["some"] == "is_on event - test_event1"
@@ -142,3 +167,73 @@ async def test_if_state(hass, calls):
     await hass.async_block_till_done()
     assert len(calls) == 2
     assert calls[1].data["some"] == "is_off event - test_event2"
+
+
+async def test_if_fires_on_for_condition(hass, calls):
+    """Test for firing if condition is on with delay."""
+    point1 = dt_util.utcnow()
+    point2 = point1 + timedelta(seconds=10)
+    point3 = point2 + timedelta(seconds=10)
+
+    platform = getattr(hass.components, f"test.{DOMAIN}")
+
+    platform.init()
+    assert await async_setup_component(hass, DOMAIN, {DOMAIN: {CONF_PLATFORM: "test"}})
+
+    sensor1 = platform.ENTITIES["battery"]
+
+    with patch("homeassistant.core.dt_util.utcnow") as mock_utcnow:
+        mock_utcnow.return_value = point1
+        assert await async_setup_component(
+            hass,
+            automation.DOMAIN,
+            {
+                automation.DOMAIN: [
+                    {
+                        "trigger": {"platform": "event", "event_type": "test_event1"},
+                        "condition": {
+                            "condition": "device",
+                            "domain": DOMAIN,
+                            "device_id": "",
+                            "entity_id": sensor1.entity_id,
+                            "type": "is_not_bat_low",
+                            "for": {"seconds": 5},
+                        },
+                        "action": {
+                            "service": "test.automation",
+                            "data_template": {
+                                "some": "is_off {{ trigger.%s }}"
+                                % "}} - {{ trigger.".join(
+                                    ("platform", "event.event_type")
+                                )
+                            },
+                        },
+                    }
+                ]
+            },
+        )
+        await hass.async_block_till_done()
+        assert hass.states.get(sensor1.entity_id).state == STATE_ON
+        assert len(calls) == 0
+
+        hass.bus.async_fire("test_event1")
+        await hass.async_block_till_done()
+        assert len(calls) == 0
+
+        # Time travel 10 secs into the future
+        mock_utcnow.return_value = point2
+        hass.bus.async_fire("test_event1")
+        await hass.async_block_till_done()
+        assert len(calls) == 0
+
+        hass.states.async_set(sensor1.entity_id, STATE_OFF)
+        hass.bus.async_fire("test_event1")
+        await hass.async_block_till_done()
+        assert len(calls) == 0
+
+        # Time travel 20 secs into the future
+        mock_utcnow.return_value = point3
+        hass.bus.async_fire("test_event1")
+        await hass.async_block_till_done()
+        assert len(calls) == 1
+        assert calls[0].data["some"] == "is_off event - test_event1"