Add SimpleFin sensor to show age of data (home-assistant#122550)

homeassistant/components/simplefin/manifest.json

@@ -7,5 +7,5 @@
   "integration_type": "service",
   "iot_class": "cloud_polling",
   "loggers": ["simplefin"],
-  "requirements": ["simplefin4py==0.0.16"]
+  "requirements": ["simplefin4py==0.0.18"]
 }

homeassistant/components/simplefin/sensor.py

@@ -4,6 +4,7 @@
 
 from collections.abc import Callable
 from dataclasses import dataclass
+from datetime import datetime
 
 from simplefin4py import Account
 
@@ -13,6 +14,7 @@
     SensorEntityDescription,
     SensorStateClass,
 )
+from homeassistant.const import EntityCategory
 from homeassistant.core import HomeAssistant
 from homeassistant.helpers.entity_platform import AddEntitiesCallback
 from homeassistant.helpers.typing import StateType
@@ -25,7 +27,7 @@
 class SimpleFinSensorEntityDescription(SensorEntityDescription):
     """Describes a sensor entity."""
 
-    value_fn: Callable[[Account], StateType]
+    value_fn: Callable[[Account], StateType | datetime]
     icon_fn: Callable[[Account], str] | None = None
     unit_fn: Callable[[Account], str] | None = None
 
@@ -40,6 +42,13 @@ class SimpleFinSensorEntityDescription(SensorEntityDescription):
         unit_fn=lambda account: account.currency,
         icon_fn=lambda account: account.inferred_account_type,
     ),
+    SimpleFinSensorEntityDescription(
+        key="age",
+        translation_key="age",
+        device_class=SensorDeviceClass.TIMESTAMP,
+        entity_category=EntityCategory.DIAGNOSTIC,
+        value_fn=lambda account: account.balance_date,
+    ),
 )
 
 
@@ -70,7 +79,7 @@ class SimpleFinSensor(SimpleFinEntity, SensorEntity):
     entity_description: SimpleFinSensorEntityDescription
 
     @property
-    def native_value(self) -> StateType:
+    def native_value(self) -> StateType | datetime | None:
         """Return the state."""
         return self.entity_description.value_fn(self.account_data)
 

homeassistant/components/simplefin/strings.json

@@ -24,6 +24,9 @@
     "sensor": {
       "balance": {
         "name": "Balance"
+      },
+      "age": {
+        "name": "Data age"
       }
     }
   }

requirements_all.txt

@@ -2580,7 +2580,7 @@ sharp_aquos_rc==0.3.2
 shodan==1.28.0
 
 # homeassistant.components.simplefin
-simplefin4py==0.0.16
+simplefin4py==0.0.18
 
 # homeassistant.components.sighthound
 simplehound==0.3

requirements_test_all.txt

@@ -2032,7 +2032,7 @@ sfrbox-api==0.0.8
 sharkiq==1.0.2
 
 # homeassistant.components.simplefin
-simplefin4py==0.0.16
+simplefin4py==0.0.18
 
 # homeassistant.components.sighthound
 simplehound==0.3