{
    "version": "https://jsonfeed.org/version/1",
    "title": "Home Assistant Developer Docs Blog",
    "home_page_url": "https://developers.home-assistant.io/blog",
    "description": "Home Assistant Developer Docs Blog",
    "items": [
        {
            "id": "https://developers.home-assistant.io/blog/2026/02/16/labs-async-listen-deprecation",
            "content_html": "<p>The <code>async_listen</code> helper in the <code>labs</code> integration has been deprecated in favor of <code>async_subscribe_preview_feature</code>.</p>\n<p>The new <code>async_subscribe_preview_feature</code> function provides a more consistent API, where the listener callback receives an <code>EventLabsUpdatedData</code> parameter containing the updated feature state. This eliminates the need to separately call <code>async_is_preview_feature_enabled</code> inside the listener to check the current value.</p>\n<h3 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"old-usage\">Old usage<a href=\"https://developers.home-assistant.io/blog/2026/02/16/labs-async-listen-deprecation#old-usage\" class=\"hash-link\" aria-label=\"Direct link to Old usage\" title=\"Direct link to Old usage\" translate=\"no\">​</a></h3>\n<div class=\"language-python codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#bfc7d5;--prism-background-color:#292d3e\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-python codeBlock_bY9V thin-scrollbar\" style=\"color:#bfc7d5;background-color:#292d3e\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token keyword\" style=\"font-style:italic\">from</span><span class=\"token plain\"> homeassistant</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">.</span><span class=\"token plain\">components</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">.</span><span class=\"token plain\">labs </span><span class=\"token keyword\" style=\"font-style:italic\">import</span><span class=\"token plain\"> async_is_preview_feature_enabled</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">,</span><span class=\"token plain\"> async_listen</span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\"></span><span class=\"token keyword\" style=\"font-style:italic\">def</span><span class=\"token plain\"> </span><span class=\"token function\" style=\"color:rgb(130, 170, 255)\">my_listener</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">(</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">)</span><span class=\"token plain\"> </span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">-</span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">&gt;</span><span class=\"token plain\"> </span><span class=\"token boolean\" style=\"color:rgb(255, 88, 116)\">None</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">    </span><span class=\"token keyword\" style=\"font-style:italic\">if</span><span class=\"token plain\"> async_is_preview_feature_enabled</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">(</span><span class=\"token plain\">hass</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">,</span><span class=\"token plain\"> DOMAIN</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">,</span><span class=\"token plain\"> </span><span class=\"token string\" style=\"color:rgb(195, 232, 141)\">\"my_feature\"</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">)</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">        </span><span class=\"token comment\" style=\"color:rgb(105, 112, 152);font-style:italic\"># feature enabled</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">        </span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">.</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">.</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">.</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">async_listen</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">(</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">    hass</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">,</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">    domain</span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">=</span><span class=\"token plain\">DOMAIN</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">,</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">    preview_feature</span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">=</span><span class=\"token string\" style=\"color:rgb(195, 232, 141)\">\"my_feature\"</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">,</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">    listener</span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">=</span><span class=\"token plain\">my_listener</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">,</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\"></span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">)</span><br></span></code></pre></div></div>\n<h3 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"new-usage\">New usage<a href=\"https://developers.home-assistant.io/blog/2026/02/16/labs-async-listen-deprecation#new-usage\" class=\"hash-link\" aria-label=\"Direct link to New usage\" title=\"Direct link to New usage\" translate=\"no\">​</a></h3>\n<div class=\"language-python codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#bfc7d5;--prism-background-color:#292d3e\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-python codeBlock_bY9V thin-scrollbar\" style=\"color:#bfc7d5;background-color:#292d3e\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token keyword\" style=\"font-style:italic\">from</span><span class=\"token plain\"> homeassistant</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">.</span><span class=\"token plain\">components</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">.</span><span class=\"token plain\">labs </span><span class=\"token keyword\" style=\"font-style:italic\">import</span><span class=\"token plain\"> EventLabsUpdatedData</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">,</span><span class=\"token plain\"> async_subscribe_preview_feature</span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\"></span><span class=\"token keyword\" style=\"font-style:italic\">async</span><span class=\"token plain\"> </span><span class=\"token keyword\" style=\"font-style:italic\">def</span><span class=\"token plain\"> </span><span class=\"token function\" style=\"color:rgb(130, 170, 255)\">my_listener</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">(</span><span class=\"token plain\">event_data</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">:</span><span class=\"token plain\"> EventLabsUpdatedData</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">)</span><span class=\"token plain\"> </span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">-</span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">&gt;</span><span class=\"token plain\"> </span><span class=\"token boolean\" style=\"color:rgb(255, 88, 116)\">None</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">    </span><span class=\"token keyword\" style=\"font-style:italic\">if</span><span class=\"token plain\"> event_data</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">[</span><span class=\"token string\" style=\"color:rgb(195, 232, 141)\">\"enabled\"</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">]</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">        </span><span class=\"token comment\" style=\"color:rgb(105, 112, 152);font-style:italic\"># feature enabled</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">        </span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">.</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">.</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">.</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">async_subscribe_preview_feature</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">(</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">    hass</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">,</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">    domain</span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">=</span><span class=\"token plain\">DOMAIN</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">,</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">    preview_feature</span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">=</span><span class=\"token string\" style=\"color:rgb(195, 232, 141)\">\"my_feature\"</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">,</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">    listener</span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">=</span><span class=\"token plain\">my_listener</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">,</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\"></span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">)</span><br></span></code></pre></div></div>\n<p>Note that the new listener is a coroutine function and receives <code>EventLabsUpdatedData</code> as a parameter.</p>\n<p><code>async_listen</code> will be removed in Home Assistant 2027.3.</p>\n<p>For more details, see <a href=\"https://github.com/home-assistant/core/pull/162648\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">core PR #162648</a>.</p>",
            "url": "https://developers.home-assistant.io/blog/2026/02/16/labs-async-listen-deprecation",
            "title": "async_listen in Labs is deprecated",
            "summary": "The asynclisten helper in the labs integration has been deprecated in favor of asyncsubscribepreviewfeature.",
            "date_modified": "2026-02-16T00:00:00.000Z",
            "author": {
                "name": "Artur Pragacz",
                "url": "https://github.com/arturpragacz"
            },
            "tags": []
        },
        {
            "id": "https://developers.home-assistant.io/blog/2026/01/13/replace-pre-commit-with-prek",
            "content_html": "<p>By replacing <code>pre-commit</code> with <a href=\"https://prek.j178.dev/\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\"><code>prek</code></a> we can increase the performance of our checks. Prek uses the same <code>.pre-commit-config.yaml</code> as <code>pre-commit</code> and is a complete replacement. Due to the fact that <code>prek</code> is written in Rust and allows the execution of different jobs in parallel, we can check our code even faster.</p>\n<p>New development environments will automatically install <code>prek</code> and for existing ones please just update the test requirements by running <code>uv pip install requirements_test.txt</code></p>",
            "url": "https://developers.home-assistant.io/blog/2026/01/13/replace-pre-commit-with-prek",
            "title": "Replacing pre-commit with prek",
            "summary": "By replacing pre-commit with prek we can increase the performance of our checks. Prek uses the same .pre-commit-config.yaml as pre-commit and is a complete replacement. Due to the fact that prek is written in Rust and allows the execution of different jobs in parallel, we can check our code even faster.",
            "date_modified": "2026-01-13T00:00:00.000Z",
            "author": {
                "name": "Robert Resch",
                "url": "https://github.com/edenhaus"
            },
            "tags": []
        },
        {
            "id": "https://developers.home-assistant.io/blog/2026/01/05/pyserial-asyncio-fast",
            "content_html": "<h3 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"summary-of-changes\">Summary of changes<a href=\"https://developers.home-assistant.io/blog/2026/01/05/pyserial-asyncio-fast#summary-of-changes\" class=\"hash-link\" aria-label=\"Direct link to Summary of changes\" title=\"Direct link to Summary of changes\" translate=\"no\">​</a></h3>\n<p>Starting in <code>2026.7</code>, installation of <code>pyserial-asyncio</code> will be blocked in Home Assistant.</p>\n<p>Library maintainers and custom integrations are advised to migrate to <code>pyserial-asyncio-fast</code>.</p>\n<h3 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"background\">Background<a href=\"https://developers.home-assistant.io/blog/2026/01/05/pyserial-asyncio-fast#background\" class=\"hash-link\" aria-label=\"Direct link to Background\" title=\"Direct link to Background\" translate=\"no\">​</a></h3>\n<p><code>pyserial-asyncio</code> blocks the event loop because it does a blocking <code>sleep</code>. The library is also not maintained so efforts to improve the situation haven't been released.</p>\n<p><code>pyserial-asyncio-fast</code> was created as a drop-in replacement (see <a href=\"https://github.com/home-assistant-libs/pyserial-asyncio-fast\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">the repository</a>), and all core integrations have now been migrated.</p>\n<h3 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"migration\">Migration<a href=\"https://developers.home-assistant.io/blog/2026/01/05/pyserial-asyncio-fast#migration\" class=\"hash-link\" aria-label=\"Direct link to Migration\" title=\"Direct link to Migration\" translate=\"no\">​</a></h3>\n<p><code>pyserial-asyncio-fast</code> was designed as a drop-in replacement of <code>pyserial-asyncio</code>, and the necessary changes are trivial.</p>\n<h4 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"requirements\">Requirements<a href=\"https://developers.home-assistant.io/blog/2026/01/05/pyserial-asyncio-fast#requirements\" class=\"hash-link\" aria-label=\"Direct link to Requirements\" title=\"Direct link to Requirements\" translate=\"no\">​</a></h4>\n<div class=\"language-python codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#bfc7d5;--prism-background-color:#292d3e\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-python codeBlock_bY9V thin-scrollbar\" style=\"color:#bfc7d5;background-color:#292d3e\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token comment\" style=\"color:rgb(105, 112, 152);font-style:italic\"># Old</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">  install_requires</span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">=</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">[</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">    </span><span class=\"token string\" style=\"color:rgb(195, 232, 141)\">\"pyserial-asyncio\"</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">  </span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">]</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\"></span><span class=\"token comment\" style=\"color:rgb(105, 112, 152);font-style:italic\"># New</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">  install_requires</span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">=</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">[</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">    </span><span class=\"token string\" style=\"color:rgb(195, 232, 141)\">\"pyserial-asyncio-fast\"</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">  </span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">]</span><br></span></code></pre></div></div>\n<h4 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"usage\">Usage<a href=\"https://developers.home-assistant.io/blog/2026/01/05/pyserial-asyncio-fast#usage\" class=\"hash-link\" aria-label=\"Direct link to Usage\" title=\"Direct link to Usage\" translate=\"no\">​</a></h4>\n<div class=\"language-python codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#bfc7d5;--prism-background-color:#292d3e\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-python codeBlock_bY9V thin-scrollbar\" style=\"color:#bfc7d5;background-color:#292d3e\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token comment\" style=\"color:rgb(105, 112, 152);font-style:italic\"># Old</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\"></span><span class=\"token keyword\" style=\"font-style:italic\">import</span><span class=\"token plain\"> serial_asyncio</span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\"></span><span class=\"token keyword\" style=\"font-style:italic\">async</span><span class=\"token plain\"> </span><span class=\"token keyword\" style=\"font-style:italic\">def</span><span class=\"token plain\"> </span><span class=\"token function\" style=\"color:rgb(130, 170, 255)\">connect</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">(</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">)</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">    conn </span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">=</span><span class=\"token plain\"> </span><span class=\"token keyword\" style=\"font-style:italic\">await</span><span class=\"token plain\"> serial_asyncio</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">.</span><span class=\"token plain\">open_serial_connection</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">(</span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">**</span><span class=\"token plain\">self</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">.</span><span class=\"token plain\">serial_settings</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">)</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\"></span><span class=\"token comment\" style=\"color:rgb(105, 112, 152);font-style:italic\"># New</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\"></span><span class=\"token keyword\" style=\"font-style:italic\">import</span><span class=\"token plain\"> serial_asyncio_fast</span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\"></span><span class=\"token keyword\" style=\"font-style:italic\">async</span><span class=\"token plain\"> </span><span class=\"token keyword\" style=\"font-style:italic\">def</span><span class=\"token plain\"> </span><span class=\"token function\" style=\"color:rgb(130, 170, 255)\">connect</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">(</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">)</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">    conn </span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">=</span><span class=\"token plain\"> </span><span class=\"token keyword\" style=\"font-style:italic\">await</span><span class=\"token plain\"> serial_asyncio_fast</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">.</span><span class=\"token plain\">open_serial_connection</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">(</span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">**</span><span class=\"token plain\">self</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">.</span><span class=\"token plain\">serial_settings</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">)</span><br></span></code></pre></div></div>\n<p>More examples are available in <a href=\"https://github.com/home-assistant/core/pull/116635\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">the tracking pull request</a>.</p>",
            "url": "https://developers.home-assistant.io/blog/2026/01/05/pyserial-asyncio-fast",
            "title": "Solving pyserial-asyncio blocking the event loop",
            "summary": "Summary of changes",
            "date_modified": "2026-01-05T00:00:00.000Z",
            "author": {
                "name": "epenet",
                "url": "https://github.com/epenet"
            },
            "tags": []
        },
        {
            "id": "https://developers.home-assistant.io/blog/2025/11/27/service-translation-placeholders",
            "content_html": "<p>It is now possible to use translation placeholders for (custom) service actions.</p>\n<p>The <a class=\"\" href=\"https://developers.home-assistant.io/docs/core/integration-quality-scale/rules/action-setup?_highlight=hass.services.async_register#example-implementation\">service action example</a> now shows how to supply the available description placeholders during the registration of the service action.</p>\n<p>Move URLs from service descriptions and translation strings into description placeholders.</p>",
            "url": "https://developers.home-assistant.io/blog/2025/11/27/service-translation-placeholders",
            "title": "Introducing description placeholders for service action translations",
            "summary": "It is now possible to use translation placeholders for (custom) service actions.",
            "date_modified": "2025-11-27T00:00:00.000Z",
            "author": {
                "name": "Jan Bouwhuis",
                "url": "https://github.com/jbouwh"
            },
            "tags": []
        },
        {
            "id": "https://developers.home-assistant.io/blog/2025/11/25/storage-helper-opt-in-serialize-in-executor",
            "content_html": "<p>The <code>Store</code> class from <code>homeassistant/helpers/storage.py</code> accepts a new constructor argument <code>serialize_in_event_loop</code></p>\n<p>If <code>serialize_in_event_loop</code> is <code>True</code> (the default):</p>\n<ul>\n<li class=\"\">The <code>data_func</code> passed to <code>Store.async_delay_save</code> is called from the event loop</li>\n<li class=\"\">Data produced by <code>data_func</code> passed to <code>Store.async_delay_save</code> is serialized to JSON in the event loop</li>\n<li class=\"\">Data passed to <code>Store.async_save</code> is serialized to JSON in the event loop</li>\n</ul>\n<p>If <code>serialize_in_event_loop</code> is <code>False</code>:</p>\n<ul>\n<li class=\"\">The <code>data_func</code> passed to <code>Store.async_delay_save</code> is called from a separate thread, which means it must be thread safe and must not access the hass object</li>\n<li class=\"\">Data produced by <code>data_func</code> passed to <code>Store.async_delay_save</code> is serialized to JSON in a separate thread, which means it must be thread safe</li>\n<li class=\"\">Data passed to <code>Store.async_save</code> is serialized to JSON in a separate thread, which means it must be thread safe</li>\n</ul>\n<p>The behavior has changed; <code>data_func</code> passed to <code>Store.async_delay_save</code> was previously always called from a separate thread and data produced by it or data passed to <code>Store.async_save</code> was previously always serialized by a separate thread.</p>\n<p>The reason for the change is that it was not documented that <code>data_func</code> would be called by a thread other than the event loop or that JSON serialization would happen in a thread other than the event loop, and the <code>data_func</code> and data produced by it or passed to <code>Store.async_save</code> was generally not thread safe.</p>\n<p>For more details, see <a href=\"https://github.com/home-assistant/core/pull/157158\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">core PR 157158</a> and <a href=\"https://github.com/home-assistant/core/pull/157263\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">core PR 157263</a>.</p>",
            "url": "https://developers.home-assistant.io/blog/2025/11/25/storage-helper-opt-in-serialize-in-executor",
            "title": "Serialization of Store data in worker thread is now opt-in",
            "summary": "The Store class from homeassistant/helpers/storage.py accepts a new constructor argument serializeinevent_loop",
            "date_modified": "2025-11-25T00:00:00.000Z",
            "author": {
                "name": "Erik Montnemery",
                "url": "https://github.com/emontnemery"
            },
            "tags": []
        },
        {
            "id": "https://developers.home-assistant.io/blog/2025/11/23/mqtt-subscribe-wait",
            "content_html": "<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"add-a-status-callback-for-mqtt-subscriptions\">Add a status callback for MQTT subscriptions<a href=\"https://developers.home-assistant.io/blog/2025/11/23/mqtt-subscribe-wait#add-a-status-callback-for-mqtt-subscriptions\" class=\"hash-link\" aria-label=\"Direct link to Add a status callback for MQTT subscriptions\" title=\"Direct link to Add a status callback for MQTT subscriptions\" translate=\"no\">​</a></h2>\n<p>Integrations that use MQTT might need to wait for a subscription to complete before they initiate actions. The default behavior is that a subscription is queued and debounced, so callers usually do not wait for broker confirmation. Some integrations must guarantee that the broker finished the subscription.</p>\n<p>The new <code>mqtt.async_on_subscribe_done</code> helper can be used to monitor MQTT subscriptions, to allow doing additional tasks.\nMake sure the same QoS is used as in the MQTT subscription.</p>\n<p>Example:</p>\n<div class=\"language-python codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#bfc7d5;--prism-background-color:#292d3e\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-python codeBlock_bY9V thin-scrollbar\" style=\"color:#bfc7d5;background-color:#292d3e\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token keyword\" style=\"font-style:italic\">from</span><span class=\"token plain\"> homeassistant</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">.</span><span class=\"token plain\">components </span><span class=\"token keyword\" style=\"font-style:italic\">import</span><span class=\"token plain\"> mqtt</span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\"></span><span class=\"token keyword\" style=\"font-style:italic\">async</span><span class=\"token plain\"> </span><span class=\"token keyword\" style=\"font-style:italic\">def</span><span class=\"token plain\"> </span><span class=\"token function\" style=\"color:rgb(130, 170, 255)\">async_setup_entry</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">(</span><span class=\"token plain\">hass</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">:</span><span class=\"token plain\"> HomeAssistant</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">,</span><span class=\"token plain\"> entry</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">:</span><span class=\"token plain\"> ConfigEntry</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">)</span><span class=\"token plain\"> </span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">-</span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">&gt;</span><span class=\"token plain\"> </span><span class=\"token builtin\" style=\"color:rgb(130, 170, 255)\">bool</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">    </span><span class=\"token triple-quoted-string string\" style=\"color:rgb(195, 232, 141)\">\"\"\"Setup integration MQTT subscription monitoring.\"\"\"</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">    </span><span class=\"token keyword\" style=\"font-style:italic\">def</span><span class=\"token plain\"> </span><span class=\"token function\" style=\"color:rgb(130, 170, 255)\">_on_subscribe_status</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">(</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">)</span><span class=\"token plain\"> </span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">-</span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">&gt;</span><span class=\"token plain\"> </span><span class=\"token boolean\" style=\"color:rgb(255, 88, 116)\">None</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">        </span><span class=\"token triple-quoted-string string\" style=\"color:rgb(195, 232, 141)\">\"\"\"Handle subscription ready signal.\"\"\"</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">        </span><span class=\"token comment\" style=\"color:rgb(105, 112, 152);font-style:italic\"># Do stuff</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">    </span><span class=\"token comment\" style=\"color:rgb(105, 112, 152);font-style:italic\"># Handle subscription ready status update</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">    </span><span class=\"token keyword\" style=\"font-style:italic\">await</span><span class=\"token plain\"> mqtt</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">.</span><span class=\"token plain\">async_on_subscribe_done</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">(</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">        hass</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">,</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">        </span><span class=\"token string\" style=\"color:rgb(195, 232, 141)\">\"myintegration/status\"</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">,</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">        qos</span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">=</span><span class=\"token number\" style=\"color:rgb(247, 140, 108)\">1</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">,</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">        on_subscribe_status</span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">=</span><span class=\"token plain\">_on_subscribe_status</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">,</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">    </span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">)</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">    </span><span class=\"token comment\" style=\"color:rgb(105, 112, 152);font-style:italic\"># Do stuff</span><br></span></code></pre></div></div>",
            "url": "https://developers.home-assistant.io/blog/2025/11/23/mqtt-subscribe-wait",
            "title": "Add a status callback for MQTT subscriptions",
            "summary": "Add a status callback for MQTT subscriptions",
            "date_modified": "2025-11-23T00:00:00.000Z",
            "author": {
                "name": "Jan Bouwhuis",
                "url": "https://github.com/jbouwh"
            },
            "tags": []
        },
        {
            "id": "https://developers.home-assistant.io/blog/2025/11/21/identify-buttons-diagnostic-category",
            "content_html": "<p>Button entities representing a device identification mechanism (using <code>IDENTIFY</code> device class) are now required to have their entity category set to <code>DIAGNOSTIC</code>.</p>\n<p>For more details on entity category, see <a class=\"\" href=\"https://developers.home-assistant.io/docs/core/entity/#registry-properties\">the documentation</a>.</p>",
            "url": "https://developers.home-assistant.io/blog/2025/11/21/identify-buttons-diagnostic-category",
            "title": "Device identification buttons are now classified as diagnostic",
            "summary": "Button entities representing a device identification mechanism (using IDENTIFY device class) are now required to have their entity category set to DIAGNOSTIC.",
            "date_modified": "2025-11-21T00:00:00.000Z",
            "author": {
                "name": "Artur Pragacz",
                "url": "https://github.com/arturpragacz"
            },
            "tags": []
        },
        {
            "id": "https://developers.home-assistant.io/blog/2025/11/20/labs-preview-features",
            "content_html": "<p>We're excited to announce a new system for shipping preview features in Home Assistant: <strong>Labs</strong>. Labs provides a standardized way for integrations to offer fully tested features that users can opt into before they become standard, allowing us to gather feedback and refine the design based on real-world usage.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"what-are-labs-preview-features\">What are Labs preview features?<a href=\"https://developers.home-assistant.io/blog/2025/11/20/labs-preview-features#what-are-labs-preview-features\" class=\"hash-link\" aria-label=\"Direct link to What are Labs preview features?\" title=\"Direct link to What are Labs preview features?\" translate=\"no\">​</a></h2>\n<p>Labs preview features are different from beta testing. While beta testing evaluates the stability of upcoming Home Assistant releases, Labs is about refining user interfaces and design. Labs features are fully tested and functional, but their design and behavior may still change as we gather real-world usage and feedback. This means they might have breaking changes, be extended with new functionality, or even be removed if they don't work out.</p>\n<p>Think of it this way:</p>\n<ul>\n<li class=\"\"><strong>Beta</strong>: Evaluates the stability of upcoming Home Assistant releases</li>\n<li class=\"\"><strong>Labs</strong>: Fully tested features with evolving design and user interface, refined through real-world usage and feedback</li>\n</ul>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"how-it-works\">How it works<a href=\"https://developers.home-assistant.io/blog/2025/11/20/labs-preview-features#how-it-works\" class=\"hash-link\" aria-label=\"Direct link to How it works\" title=\"Direct link to How it works\" translate=\"no\">​</a></h2>\n<p>Integrations declare preview features in their <code>manifest.json</code> with links for feedback, documentation, and issue reporting. Users can then enable these features in <strong>Settings</strong> → <strong>System</strong> → <strong>Labs</strong>, and they activate immediately without requiring a restart. The integration code checks whether a feature is enabled and responds accordingly.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"why-labs\">Why Labs?<a href=\"https://developers.home-assistant.io/blog/2025/11/20/labs-preview-features#why-labs\" class=\"hash-link\" aria-label=\"Direct link to Why Labs?\" title=\"Direct link to Why Labs?\" translate=\"no\">​</a></h2>\n<p>Many of our most significant improvements benefit from real-world testing before becoming standard. Labs provides:</p>\n<ol>\n<li class=\"\"><strong>Structured feedback channels</strong>: Each feature has dedicated URLs for feedback, documentation, and issue reporting</li>\n<li class=\"\"><strong>Runtime activation</strong>: Features enable and disable instantly, no configuration updates or restart required</li>\n<li class=\"\"><strong>Clear expectations</strong>: Users know they're trying fully tested features whose design may change based on feedback</li>\n<li class=\"\"><strong>Iterative development</strong>: Integrate user feedback directly into the development process</li>\n</ol>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"example-kitchen-sink-special-repair\">Example: Kitchen Sink special repair<a href=\"https://developers.home-assistant.io/blog/2025/11/20/labs-preview-features#example-kitchen-sink-special-repair\" class=\"hash-link\" aria-label=\"Direct link to Example: Kitchen Sink special repair\" title=\"Direct link to Example: Kitchen Sink special repair\" translate=\"no\">​</a></h2>\n<p>The <a href=\"https://www.home-assistant.io/integrations/kitchen_sink/\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">Kitchen Sink</a> demo integration includes a working example. When enabled, the \"special repair\" feature creates a repair issue to demonstrate how Labs features can interact with other Home Assistant integrations. See the <a class=\"\" href=\"https://developers.home-assistant.io/docs/development/labs#complete-example-kitchen-sink-special-repair\">developer documentation</a> for the complete implementation.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"getting-started\">Getting started<a href=\"https://developers.home-assistant.io/blog/2025/11/20/labs-preview-features#getting-started\" class=\"hash-link\" aria-label=\"Direct link to Getting started\" title=\"Direct link to Getting started\" translate=\"no\">​</a></h2>\n<p>Ready to add a Labs preview feature to your integration? Check out our <a class=\"\" href=\"https://developers.home-assistant.io/docs/development/labs\">comprehensive guide</a> which covers:</p>\n<ul>\n<li class=\"\">When to use Labs (and when not to)</li>\n<li class=\"\">How to define features in your manifest</li>\n<li class=\"\">Implementation patterns for backend and frontend features</li>\n<li class=\"\">Runtime activation requirements</li>\n<li class=\"\">Testing approaches</li>\n<li class=\"\">Feature lifecycle (preview → standard or removal)</li>\n</ul>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"whats-next\">What's next?<a href=\"https://developers.home-assistant.io/blog/2025/11/20/labs-preview-features#whats-next\" class=\"hash-link\" aria-label=\"Direct link to What's next?\" title=\"Direct link to What's next?\" translate=\"no\">​</a></h2>\n<p>We encourage integration developers to consider Labs for:</p>\n<ul>\n<li class=\"\">Major UI changes or redesigns</li>\n<li class=\"\">Significant architectural changes that benefit from real-world testing</li>\n<li class=\"\">Features where user feedback will shape the final design</li>\n</ul>\n<p>Labs is <strong>not</strong> for:</p>\n<ul>\n<li class=\"\">Permanent configuration options (use integration options instead)</li>\n<li class=\"\">Minor changes that can go directly into releases</li>\n<li class=\"\">Features with critical bugs or that are fundamentally incomplete</li>\n</ul>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"try-it-yourself\">Try it yourself<a href=\"https://developers.home-assistant.io/blog/2025/11/20/labs-preview-features#try-it-yourself\" class=\"hash-link\" aria-label=\"Direct link to Try it yourself\" title=\"Direct link to Try it yourself\" translate=\"no\">​</a></h2>\n<p>Want to see Labs in action? Install the Kitchen Sink demo integration and enable the \"Special repair\" feature in Settings → System → Labs. You'll see firsthand how preview features work.</p>",
            "url": "https://developers.home-assistant.io/blog/2025/11/20/labs-preview-features",
            "title": "Introducing Labs: Preview features before they become standard",
            "summary": "We're excited to announce a new system for shipping preview features in Home Assistant: Labs. Labs provides a standardized way for integrations to offer fully tested features that users can opt into before they become standard, allowing us to gather feedback and refine the design based on real-world usage.",
            "date_modified": "2025-11-20T00:00:00.000Z",
            "author": {
                "name": "Frenck",
                "url": "https://github.com/frenck"
            },
            "tags": []
        },
        {
            "id": "https://developers.home-assistant.io/blog/2025/11/17/retry-after-update-failed",
            "content_html": "<p>Integrations using the <a href=\"https://developers.home-assistant.io/docs/integration_fetching_data/#coordinated-single-api-poll-for-data-for-all-entities\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">Data Update Coordinator</a> can enhance the <code>UpdateFailed</code> exception with a new parameter <code>retry_after</code> to defer the next scheduled refresh by a specified number of seconds and then resume the normal cadence once the API has recovered.</p>\n<p>In situations where polling API's would return a sign of being overwhelmed, by throwing an HTTP 429 or providing a <code>Retry-After</code> in the response header, integrations can now honor these backoff signals.\nThe integration and API client must detect these backoff signals and sanitize the API's desired backoff period. The <code>UpdateFailed</code> exception accepts a <code>retry_after</code> parameter (a float in seconds) to delay the next scheduled refresh. Once the API recovers and <code>UpdateFailed</code> is no longer raised, the integration resumes its normal <code>update_interval</code>.</p>\n<p>Example of the usage:</p>\n<div class=\"language-python codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#bfc7d5;--prism-background-color:#292d3e\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-python codeBlock_bY9V thin-scrollbar\" style=\"color:#bfc7d5;background-color:#292d3e\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token keyword\" style=\"font-style:italic\">try</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">    request </span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">=</span><span class=\"token plain\"> </span><span class=\"token keyword\" style=\"font-style:italic\">await</span><span class=\"token plain\"> self</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">.</span><span class=\"token plain\">client</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">.</span><span class=\"token plain\">get_information</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">(</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">)</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\"></span><span class=\"token keyword\" style=\"font-style:italic\">except</span><span class=\"token plain\"> APIClientRateLimited </span><span class=\"token keyword\" style=\"font-style:italic\">as</span><span class=\"token plain\"> err</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">    </span><span class=\"token keyword\" style=\"font-style:italic\">raise</span><span class=\"token plain\"> UpdateFailed</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">(</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">        retry_after</span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">=</span><span class=\"token number\" style=\"color:rgb(247, 140, 108)\">60</span><span class=\"token plain\">  </span><span class=\"token comment\" style=\"color:rgb(105, 112, 152);font-style:italic\"># This can also be retrieved from the API response itself, or provide a default</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">    </span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">)</span><span class=\"token plain\"> </span><span class=\"token keyword\" style=\"font-style:italic\">from</span><span class=\"token plain\"> err</span><br></span></code></pre></div></div>\n<h4 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"configentrynotready\">ConfigEntryNotReady<a href=\"https://developers.home-assistant.io/blog/2025/11/17/retry-after-update-failed#configentrynotready\" class=\"hash-link\" aria-label=\"Direct link to ConfigEntryNotReady\" title=\"Direct link to ConfigEntryNotReady\" translate=\"no\">​</a></h4>\n<p>The <code>retry_after</code> parameter is ignored during the Update Coordinator setup phase (<code>async_config_entry_first_refresh</code>). If the first refresh fails, Home Assistant raises a <code>ConfigEntryNotReady</code> exception, allowing config entry setup to retry automatically using the built-in retry. Once the coordinator setup succeeds, <code>retry_after</code> applies to following refreshes.</p>",
            "url": "https://developers.home-assistant.io/blog/2025/11/17/retry-after-update-failed",
            "title": "Data Update Coordinator now supports Retry After",
            "summary": "Integrations using the Data Update Coordinator can enhance the UpdateFailed exception with a new parameter retry_after to defer the next scheduled refresh by a specified number of seconds and then resume the normal cadence once the API has recovered.",
            "date_modified": "2025-11-17T00:00:00.000Z",
            "author": {
                "name": "Erwin Douna",
                "url": "https://github.com/erwindouna"
            },
            "tags": []
        },
        {
            "id": "https://developers.home-assistant.io/blog/2025/11/10/calculated-state-capability-attributes-removed",
            "content_html": "<p>The <code>capability_attributes</code> field has been removed from <code>CalculatedState</code>. Capability attributes are still included in all attributes, which remain available in <code>CalculatedState</code>.</p>\n<p><code>CalculatedState</code> is the container with state and attributes returned by <code>Entity._async_calculate_state</code>.</p>\n<p>For details, see <a href=\"https://github.com/home-assistant/core/pull/151672\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">core PR 151672</a>.</p>",
            "url": "https://developers.home-assistant.io/blog/2025/11/10/calculated-state-capability-attributes-removed",
            "title": "The capability_attributes field removed from CalculatedState",
            "summary": "The capability_attributes field has been removed from CalculatedState. Capability attributes are still included in all attributes, which remain available in CalculatedState.",
            "date_modified": "2025-11-10T00:00:00.000Z",
            "author": {
                "name": "Artur Pragacz",
                "url": "https://github.com/arturpragacz"
            },
            "tags": []
        },
        {
            "id": "https://developers.home-assistant.io/blog/2025/11/05/config-entry-oauth2-error-handling",
            "content_html": "<p>Integrations using <a href=\"https://developers.home-assistant.io/docs/core/platform/application_credentials/\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">Application Credentials</a> and <a href=\"https://developers.home-assistant.io/docs/config_entries_config_flow_handler/#configuration-via-oauth2\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">Configuration via OAuth2</a> need to update their error handling to correctly handle configuration when the internet is down.</p>\n<p>Currently integrations using configuration via OAuth2 call <code>config_entry_oauth2_flow.async_get_config_entry_implementation</code> in <code>async_setup_entry</code> in their <code>__init__.py</code>. Previously when there was no network, this would raise <code>ValueError: Implementation not available</code>, which was a non-retryable error, resulting in the integration needing to be manually reconfigured after internet was restored (see Issues <a href=\"https://github.com/home-assistant/core/issues/153956\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">153956</a> and <a href=\"https://github.com/home-assistant/core/issues/144582\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">144582</a>). <a href=\"https://github.com/home-assistant/core/pull/154579\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">core PR 154579</a> added <code>config_entry_oauth2_flow.ImplementationUnavailableError</code> and raises it in <code>config_entry_oauth2_flow.async_get_config_entry_implementation</code> when OAuth2 configuration is unavailable because of missing internet. Integrations should catch this error and raise <code>ConfigEntryNotReady</code>.\nThe changed behavior with the new exception will be released in 2025.12.</p>\n<p>Here is an example of the migration,</p>\n<div class=\"language-diff codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#bfc7d5;--prism-background-color:#292d3e\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-diff codeBlock_bY9V thin-scrollbar\" style=\"color:#bfc7d5;background-color:#292d3e\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">-    implementation = await async_get_config_entry_implementation(hass, entry)</span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">+    try:</span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">+        implementation = await async_get_config_entry_implementation(hass, entry)</span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">+    except ImplementationUnavailableError as err:</span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">+        raise ConfigEntryNotReady(</span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">+            \"OAuth2 implementation temporarily unavailable, will retry\"</span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">+        ) from err</span><br></span></code></pre></div></div>\n<p>New integrations will find the correct <code>try</code> / <code>except</code> block generated by <code>python3 -m script.scaffold config_flow_oauth2</code>.</p>",
            "url": "https://developers.home-assistant.io/blog/2025/11/05/config-entry-oauth2-error-handling",
            "title": "Improved error handling for oauth2 configuration without internet",
            "summary": "Integrations using Application Credentials and Configuration via OAuth2 need to update their error handling to correctly handle configuration when the internet is down.",
            "date_modified": "2025-11-05T00:00:00.000Z",
            "author": {
                "name": "Will Moss",
                "url": "https://github.com/wmoss"
            },
            "tags": []
        },
        {
            "id": "https://developers.home-assistant.io/blog/2025/11/04/convert-interval-deprecation",
            "content_html": "<p>The method <code>convert_interval</code> in <code>TemperatureConverter</code> (allowing conversions between °F and °C intervals) has been deprecated in favor of <code>TemperatureDeltaConverter.convert</code>.\nThe new converter and device class are now the preferred way to deal with temperature intervals.</p>\n<p>For details, see <a href=\"https://github.com/home-assistant/core/pull/155689\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">core PR 155689</a> and <a href=\"https://github.com/home-assistant/core/pull/147358\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">core PR 147358</a>.</p>",
            "url": "https://developers.home-assistant.io/blog/2025/11/04/convert-interval-deprecation",
            "title": "TemperatureConverter.convert_interval deprecation",
            "summary": "The method convert_interval in TemperatureConverter (allowing conversions between °F and °C intervals) has been deprecated in favor of TemperatureDeltaConverter.convert.",
            "date_modified": "2025-11-04T00:00:00.000Z",
            "author": {
                "name": "Davide Perteghella",
                "url": "https://github.com/krahabb"
            },
            "tags": []
        },
        {
            "id": "https://developers.home-assistant.io/blog/2025/10/24/service-web-api-changes",
            "content_html": "<p>Action translations defined in <code>strings.json</code> are no longer included in responses from the WebSocket <code>get_services</code> command and the REST <code>/api/services</code> endpoint because they were incomplete and the Home Assistant frontend did not use them.</p>\n<p>Legacy, untranslated action names and descriptions from <code>services.yaml</code> remain in both the WebSocket and REST responses.</p>\n<p>Fetch complete action translations with the WebSocket command <code>frontend/get_translations</code>.</p>\n<p>For details, see <a href=\"https://github.com/home-assistant/core/pull/147120\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">core PR 147120</a>.</p>",
            "url": "https://developers.home-assistant.io/blog/2025/10/24/service-web-api-changes",
            "title": "Service translations removed from WebSocket get_services and REST /api/services",
            "summary": "Action translations defined in strings.json are no longer included in responses from the WebSocket get_services command and the REST /api/services endpoint because they were incomplete and the Home Assistant frontend did not use them.",
            "date_modified": "2025-10-24T00:00:00.000Z",
            "author": {
                "name": "Erik Montnemery",
                "url": "https://github.com/emontnemery"
            },
            "tags": []
        },
        {
            "id": "https://developers.home-assistant.io/blog/2025/10/16/recorder-statistics-api-changes",
            "content_html": "<p>The Python and WS APIs for injecting and modifying statistics have changed.</p>\n<p>The following changes have been made to the WS API:</p>\n<ul>\n<li class=\"\">The WS command <code>recorder/update_statistics_metadata</code> accepts a <code>unit_class</code> that points to the unit converter used for unit conversions. If there is no compatible unit converter, <code>unit_class</code> should be set to <code>null</code>. Not specifying the <code>unit_class</code> is deprecated and will stop working in Home Assistant Core 2026.11.</li>\n<li class=\"\">The <code>metadata</code> object included in the WS command <code>recorder/import_statistics</code> accepts a <code>unit_class</code> that points to the unit converter used for unit conversions. If there is no compatible unit converter, <code>unit_class</code> should be set to <code>null</code>. Not specifying the <code>unit_class</code> is deprecated and will stop working in Home Assistant Core 2026.11.</li>\n<li class=\"\">The <code>metadata</code> object included in the WS command <code>recorder/import_statistics</code> accepts a <code>mean_type</code> that specifies the type of mean (<code>0</code> for no mean, <code>1</code> for arithmetic mean, or <code>2</code> for circular mean). The <code>mean_type</code> replaces the bool flag <code>has_mean</code>. Not specifying the <code>mean_type</code> is deprecated and will stop working in Home Assistant Core 2026.11.</li>\n<li class=\"\">The items in the response to the WS commands <code>recorder/list_statistic_ids</code> and <code>recorder/get_statistics_metadata</code> have <code>mean_type</code> and <code>unit_class</code>.</li>\n<li class=\"\">The <code>has_mean</code> in the items in the response to the WS commands <code>recorder/list_statistic_ids</code> and <code>recorder/get_statistics_metadata</code> is deprecated and will be removed in Home Assistant Core 2026.11.</li>\n</ul>\n<p>The following changes have been made to the Python API:</p>\n<ul>\n<li class=\"\">The function <code>async_update_statistics_metadata</code> accepts a <code>new_unit_class</code> that points to the unit converter used for unit conversions. If there is no compatible unit converter, <code>new_unit_class</code> should be set to <code>None</code>. Not specifying the <code>new_unit_class</code> is deprecated and will stop working in Home Assistant Core 2025.11.</li>\n<li class=\"\">The metadata object passed to the functions <code>async_import_statistics</code> and <code>async_add_external_statistics</code> accepts a <code>unit_class</code> that points to the unit converter used for unit conversions. If there is no compatible unit converter, <code>unit_class</code> should be set to <code>None</code>. Not specifying the <code>unit_class</code> is deprecated and will stop working in Home Assistant Core 2025.11.</li>\n<li class=\"\">The metadata object passed to the functions <code>async_import_statistics</code> and <code>async_add_external_statistics</code> accepts a <code>mean_type</code> of type <code>StatisticMeanType</code> that specifies the type of mean (<code>NONE</code>, <code>ARITHMETIC</code>, or <code>CIRCULAR</code>). The <code>mean_type</code> replaces the bool flag <code>has_mean</code>. Not specifying the <code>mean_type</code> is deprecated and will stop working in Home Assistant Core 2026.11.</li>\n<li class=\"\">The items in the return value of the function <code>async_list_statistic_ids</code> have <code>mean_type</code> and <code>unit_class</code>.</li>\n<li class=\"\">The <code>has_mean</code> in the items in the return value of the function <code>async_list_statistic_ids</code> is deprecated and will be removed in Home Assistant Core 2026.11.</li>\n</ul>",
            "url": "https://developers.home-assistant.io/blog/2025/10/16/recorder-statistics-api-changes",
            "title": "Changes to the recorder statistics API",
            "summary": "The Python and WS APIs for injecting and modifying statistics have changed.",
            "date_modified": "2025-10-16T00:00:00.000Z",
            "author": {
                "name": "Erik Montnemery",
                "url": "https://github.com/emontnemery"
            },
            "tags": []
        },
        {
            "id": "https://developers.home-assistant.io/blog/2025/10/14/device-filter-removed-from-target-selector",
            "content_html": "<p>The device filter option is no longer supported by the target selector and has been removed from the <a href=\"https://www.home-assistant.io/docs/blueprint/selectors/#target-selector\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">target selector documentation</a>.</p>\n<p>Hassfest has been updated to <a href=\"https://github.com/home-assistant/core/pull/152794\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">fail on services with device filter on targets</a>.</p>\n<p>Validation of target selectors that specify a device filter will fail in Home Assistant Core 2026.11.</p>\n<h3 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"background\">Background<a href=\"https://developers.home-assistant.io/blog/2025/10/14/device-filter-removed-from-target-selector#background\" class=\"hash-link\" aria-label=\"Direct link to Background\" title=\"Direct link to Background\" translate=\"no\">​</a></h3>\n<p>Core helpers that extract entities from targets did not support the device filter. When the user picked a floor, area, label, or category, the filter was ignored. The frontend also ignored the device filter when selecting entities for a target.</p>\n<p>A review of all core integrations found no correct use of a device filter on target selectors. We removed the device filter from the target selector rather than implement support for it in Core and the frontend.</p>\n<h3 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"impact-on-custom-integrations-and-blueprints\">Impact on custom integrations and blueprints<a href=\"https://developers.home-assistant.io/blog/2025/10/14/device-filter-removed-from-target-selector#impact-on-custom-integrations-and-blueprints\" class=\"hash-link\" aria-label=\"Direct link to Impact on custom integrations and blueprints\" title=\"Direct link to Impact on custom integrations and blueprints\" translate=\"no\">​</a></h3>\n<p>Update custom integrations and blueprints to remove device filters from target selectors.</p>\n<p>If you have a valid use case for device filters on target selectors, reach out on Discord.</p>",
            "url": "https://developers.home-assistant.io/blog/2025/10/14/device-filter-removed-from-target-selector",
            "title": "Device filter has been removed from target selector",
            "summary": "The device filter option is no longer supported by the target selector and has been removed from the target selector documentation.",
            "date_modified": "2025-10-14T00:00:00.000Z",
            "author": {
                "name": "Erik Montnemery",
                "url": "https://github.com/emontnemery"
            },
            "tags": []
        },
        {
            "id": "https://developers.home-assistant.io/blog/2025/10/05/coordinator-retrigger",
            "content_html": "<p>The update coordinator with debouncer active will now accept a request for an update\nwhile an update is currently in progress. The request will be queued up to be performed\nafter the current update finishes.</p>\n<p>Consider the following case:</p>\n<div class=\"language-python codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#bfc7d5;--prism-background-color:#292d3e\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-python codeBlock_bY9V thin-scrollbar\" style=\"color:#bfc7d5;background-color:#292d3e\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token keyword\" style=\"font-style:italic\">async</span><span class=\"token plain\"> </span><span class=\"token keyword\" style=\"font-style:italic\">def</span><span class=\"token plain\"> </span><span class=\"token function\" style=\"color:rgb(130, 170, 255)\">_update</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">(</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">)</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">    a </span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">=</span><span class=\"token plain\"> </span><span class=\"token keyword\" style=\"font-style:italic\">await</span><span class=\"token plain\"> get_a</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">(</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">)</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">    </span><span class=\"token comment\" style=\"color:rgb(105, 112, 152);font-style:italic\"># A: User or other logic request a new update here through async_schedule_update()</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">    b </span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">=</span><span class=\"token plain\"> </span><span class=\"token keyword\" style=\"font-style:italic\">await</span><span class=\"token plain\"> get_b</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">(</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">)</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">    </span><span class=\"token keyword\" style=\"font-style:italic\">return</span><span class=\"token plain\"> </span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">(</span><span class=\"token plain\">a</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">,</span><span class=\"token plain\">b</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">)</span><br></span></code></pre></div></div>\n<p>A user or code that request an updates at timestamp <code>A</code> expects that the entities linked will\nall get new data from that time. However, since we previously ignored that request, entities\nwould have data for the value of <code>a</code> that is from a time before the update request that was ignored.</p>\n<p>To make sure we avoid this case, the update coordinator will now schedule an additional\nupdate, if a request is received while currently executing an update.</p>\n<p>A side effect of this is that it is now possible to schedule an update from inside an update\nfunction of the coordinator. That is useful if for example a connection is lost mid update,\nand we want all entities to indicate directly as unavailable, yet we want to attempt a\nre-connect as quick as possible but do that in the next update cycle.</p>",
            "url": "https://developers.home-assistant.io/blog/2025/10/05/coordinator-retrigger",
            "title": "Update coordinator now allows retriggering",
            "summary": "The update coordinator with debouncer active will now accept a request for an update",
            "date_modified": "2025-10-05T00:00:00.000Z",
            "author": {
                "name": "Joakim Plate",
                "url": "https://github.com/elupus"
            },
            "tags": []
        },
        {
            "id": "https://developers.home-assistant.io/blog/2025/09/25/entity-services-api-changes",
            "content_html": "<p>Platform entity services should be registered by calling the helper <a class=\"\" href=\"https://developers.home-assistant.io/docs/dev_101_services?_highlight=async_register_platform_entity_service#entity-service-actions\"><code>service.async_register_platform_entity_service</code></a> from the integration's <code>async_setup</code> instead of calling <code>platform.async_register_entity_service</code> during platform set up.</p>\n<p>Existing integrations should be migrated to the new API to ensure loading the services does not depend on platform setup.</p>\n<p>For examples of migrating, see <a href=\"https://github.com/home-assistant/core/pull/152172\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">core PR 152172</a> and <a href=\"https://github.com/home-assistant/core/pull/152047\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">core PR 152047</a>.</p>",
            "url": "https://developers.home-assistant.io/blog/2025/09/25/entity-services-api-changes",
            "title": "Improved API for registering platform entity services",
            "summary": "Platform entity services should be registered by calling the helper service.asyncregisterplatformentityservice from the integration's asyncsetup instead of calling platform.asyncregisterentity_service during platform set up.",
            "date_modified": "2025-09-25T00:00:00.000Z",
            "author": {
                "name": "Erik Montnemery",
                "url": "https://github.com/emontnemery"
            },
            "tags": []
        },
        {
            "id": "https://developers.home-assistant.io/blog/2025/09/22/deprecate-hass-argument-service-helpers",
            "content_html": "<h3 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"summary-of-changes\">Summary of changes<a href=\"https://developers.home-assistant.io/blog/2025/09/22/deprecate-hass-argument-service-helpers#summary-of-changes\" class=\"hash-link\" aria-label=\"Direct link to Summary of changes\" title=\"Direct link to Summary of changes\" translate=\"no\">​</a></h3>\n<p>Providing <code>hass</code> argument to the following service helpers is deprecated:\n<code>verify_domain_control</code>, <code>extract_entity_ids</code>, <code>async_extract_entities</code>,\n<code>async_extract_entity_ids</code>, and <code>async_extract_config_entry_ids</code>.</p>\n<p>Since release <code>2025.1</code> (via core PR <a href=\"https://github.com/home-assistant/core/pull/133062\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">#133062</a>),\na reference to <code>HomeAssistant</code> is available as a property of the <code>ServiceCall</code> object,\nand it became redundant to pass the <code>hass</code> object to the above helpers.</p>\n<p>To update your integration, just remove the <code>hass</code> argument.</p>\n<p>Support for the <code>hass</code> argument will be removed in Home Assistant 2026.10.</p>\n<h3 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"examples\">Examples<a href=\"https://developers.home-assistant.io/blog/2025/09/22/deprecate-hass-argument-service-helpers#examples\" class=\"hash-link\" aria-label=\"Direct link to Examples\" title=\"Direct link to Examples\" translate=\"no\">​</a></h3>\n<h4 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"id-extraction-helpers\">ID extraction helpers<a href=\"https://developers.home-assistant.io/blog/2025/09/22/deprecate-hass-argument-service-helpers#id-extraction-helpers\" class=\"hash-link\" aria-label=\"Direct link to ID extraction helpers\" title=\"Direct link to ID extraction helpers\" translate=\"no\">​</a></h4>\n<div class=\"language-python codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#bfc7d5;--prism-background-color:#292d3e\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-python codeBlock_bY9V thin-scrollbar\" style=\"color:#bfc7d5;background-color:#292d3e\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token comment\" style=\"color:rgb(105, 112, 152);font-style:italic\"># Old</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\"></span><span class=\"token comment\" style=\"color:rgb(105, 112, 152);font-style:italic\"># target_entry_ids = await async_extract_config_entry_ids(hass, service_call)</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\"></span><span class=\"token comment\" style=\"color:rgb(105, 112, 152);font-style:italic\"># entity_ids = await async_extract_entity_ids(hass, service_call)</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\"></span><span class=\"token comment\" style=\"color:rgb(105, 112, 152);font-style:italic\"># entities = await service.async_extract_entities(hass, platform_entities.values(), service_call)</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\"></span><span class=\"token comment\" style=\"color:rgb(105, 112, 152);font-style:italic\"># New</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">target_entry_ids </span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">=</span><span class=\"token plain\"> </span><span class=\"token keyword\" style=\"font-style:italic\">await</span><span class=\"token plain\"> async_extract_config_entry_ids</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">(</span><span class=\"token plain\">service_call</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">)</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">entity_ids </span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">=</span><span class=\"token plain\"> </span><span class=\"token keyword\" style=\"font-style:italic\">await</span><span class=\"token plain\"> async_extract_entity_ids</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">(</span><span class=\"token plain\">service_call</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">)</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">entities </span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">=</span><span class=\"token plain\"> </span><span class=\"token keyword\" style=\"font-style:italic\">await</span><span class=\"token plain\"> service</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">.</span><span class=\"token plain\">async_extract_entities</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">(</span><span class=\"token plain\">platform_entities</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">.</span><span class=\"token plain\">values</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">(</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">)</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">,</span><span class=\"token plain\"> service_call</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">)</span><br></span></code></pre></div></div>\n<h4 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"decorator-helper\">Decorator helper<a href=\"https://developers.home-assistant.io/blog/2025/09/22/deprecate-hass-argument-service-helpers#decorator-helper\" class=\"hash-link\" aria-label=\"Direct link to Decorator helper\" title=\"Direct link to Decorator helper\" translate=\"no\">​</a></h4>\n<div class=\"language-python codeBlockContainer_Ckt0 theme-code-block\" style=\"--prism-color:#bfc7d5;--prism-background-color:#292d3e\"><div class=\"codeBlockContent_QJqH\"><pre tabindex=\"0\" class=\"prism-code language-python codeBlock_bY9V thin-scrollbar\" style=\"color:#bfc7d5;background-color:#292d3e\"><code class=\"codeBlockLines_e6Vv\"><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token comment\" style=\"color:rgb(105, 112, 152);font-style:italic\"># Old</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\"></span><span class=\"token comment\" style=\"color:rgb(105, 112, 152);font-style:italic\"># @verify_domain_control(hass, DOMAIN)</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\"></span><span class=\"token comment\" style=\"color:rgb(105, 112, 152);font-style:italic\"># async def do_action(call: ServiceCall) -&gt; None:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\"></span><span class=\"token comment\" style=\"color:rgb(105, 112, 152);font-style:italic\">#     ...</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\" style=\"display:inline-block\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\"></span><span class=\"token comment\" style=\"color:rgb(105, 112, 152);font-style:italic\"># New</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\"></span><span class=\"token decorator annotation punctuation\" style=\"color:rgb(199, 146, 234)\">@verify_domain_control</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">(</span><span class=\"token plain\">DOMAIN</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">)</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\"></span><span class=\"token keyword\" style=\"font-style:italic\">async</span><span class=\"token plain\"> </span><span class=\"token keyword\" style=\"font-style:italic\">def</span><span class=\"token plain\"> </span><span class=\"token function\" style=\"color:rgb(130, 170, 255)\">do_action</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">(</span><span class=\"token plain\">call</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">:</span><span class=\"token plain\"> ServiceCall</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">)</span><span class=\"token plain\"> </span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">-</span><span class=\"token operator\" style=\"color:rgb(137, 221, 255)\">&gt;</span><span class=\"token plain\"> </span><span class=\"token boolean\" style=\"color:rgb(255, 88, 116)\">None</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">:</span><span class=\"token plain\"></span><br></span><span class=\"token-line\" style=\"color:#bfc7d5\"><span class=\"token plain\">    </span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">.</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">.</span><span class=\"token punctuation\" style=\"color:rgb(199, 146, 234)\">.</span><br></span></code></pre></div></div>",
            "url": "https://developers.home-assistant.io/blog/2025/09/22/deprecate-hass-argument-service-helpers",
            "title": "Deprecate hass argument in service helpers",
            "summary": "Summary of changes",
            "date_modified": "2025-09-22T00:00:00.000Z",
            "author": {
                "name": "epenet",
                "url": "https://github.com/epenet"
            },
            "tags": []
        },
        {
            "id": "https://developers.home-assistant.io/blog/2025/08/20/micro-sign-encoding",
            "content_html": "<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"one-preferred-encoding-to-represent-μ-in-units-of-measurement\">One preferred encoding to represent μ in units of measurement<a href=\"https://developers.home-assistant.io/blog/2025/08/20/micro-sign-encoding#one-preferred-encoding-to-represent-%CE%BC-in-units-of-measurement\" class=\"hash-link\" aria-label=\"Direct link to One preferred encoding to represent μ in units of measurement\" title=\"Direct link to One preferred encoding to represent μ in units of measurement\" translate=\"no\">​</a></h2>\n<p>The unit prefix μ is used by unit of measurement constants like μV and μS.\nThere are however two different Unicode encodings of μ:</p>\n<ol>\n<li class=\"\">The <a href=\"https://www.compart.com/en/unicode/U+00B5\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">MICRO SIGN</a></li>\n<li class=\"\">The <a href=\"https://www.compart.com/en/unicode/U+03BC\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">Greek Small Letter Mu</a></li>\n</ol>\n<p>Home Assistant previously mixed the two encodings, which caused issues because string comparisons between the two encodings would fail causing unit of measurement validations to fail.</p>\n<p>We chose the \"Greek Small Letter Mu\" because the \"MICRO SIGN\" encoding is there for compatibility with old 8-bit western European character sets, and the unicode consortium recommends against using it.</p>\n<p>With <a href=\"https://github.com/home-assistant/core/pull/144853\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">#144853</a> we have fixed this in the core of Home Assistant by consequently using the Greek Small Letter Mu version to encode μ. In Python literal strings this variant is encoded as <code>\"\\u03bc\"</code>.</p>\n<p>Developers should check if their code and libraries have a dependency with the ambiguous MICRO SIGN (μ) <code>\"\\u00b5\"</code>, and migrate their code to use the Greek Small Letter Mu <code>\"\\u03bc\"</code> instead to avoid issues.</p>\n<p>The <code>sensor</code> and <code>number</code> entity platforms now include a built-in feature to automatically convert units that use the ambiguous MICRO SIGN (μ) encoding.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"find-instances-in-visual-studio-code\">Find instances in Visual Studio Code<a href=\"https://developers.home-assistant.io/blog/2025/08/20/micro-sign-encoding#find-instances-in-visual-studio-code\" class=\"hash-link\" aria-label=\"Direct link to Find instances in Visual Studio Code\" title=\"Direct link to Find instances in Visual Studio Code\" translate=\"no\">​</a></h2>\n<p>In Visual Studio Code, enable <strong>Match Case</strong> in the <strong>Search</strong> (files) panel to find only the chosen encoding. Copy the exact μ character from above and paste it into the search box. The editor’s page search matches all variants; use the global search instead.</p>\n<h2 class=\"anchor anchorTargetStickyNavbar_Vzrq\" id=\"new-linter\">New linter<a href=\"https://developers.home-assistant.io/blog/2025/08/20/micro-sign-encoding#new-linter\" class=\"hash-link\" aria-label=\"Direct link to New linter\" title=\"Direct link to New linter\" translate=\"no\">​</a></h2>\n<p>To avoid issues with new or changed code, <a href=\"https://github.com/home-assistant/core/pull/144853\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">#144853</a> adds a linter that warns about incorrect literal assignments using the non-preferred encoding of μ.</p>",
            "url": "https://developers.home-assistant.io/blog/2025/08/20/micro-sign-encoding",
            "title": "Standardize encoding of μ in units of measurement",
            "summary": "One preferred encoding to represent μ in units of measurement",
            "date_modified": "2025-08-20T00:00:00.000Z",
            "author": {
                "name": "Jan Bouwhuis",
                "url": "https://github.com/jbouwh"
            },
            "tags": []
        },
        {
            "id": "https://developers.home-assistant.io/blog/2025/08/01/suggested-area-removed-from-deviceentry",
            "content_html": "<p>The <code>DeviceEntry.suggested_area</code> attribute is deprecated and will be removed in HA Core 2026.9. Also, <code>suggested_area</code> will no longer be present in <code>EVENT_DEVICE_REGISTRY_UPDATED</code> events when HA Core 2026.9 is released.</p>\n<p>Note:\nSetting <code>suggested_area</code> in <code>DeviceInfo</code>, and passing <code>suggested_area</code> to <code>DeviceRegistry.async_get_or_create</code> is still supported and influences the area of created devices, although that may change in the future.</p>\n<p>Use <code>DeviceEntry.area_id</code> to determine a device’s area in custom integrations. Don’t access <code>DeviceEntry.suggested_area</code>.</p>\n<p>During the deprecation period, accessing <code>DeviceEntry.suggested_area</code> will log a warning.</p>\n<p>For more details, refer to the <a class=\"\" href=\"https://developers.home-assistant.io/docs/device_registry_index#device-properties\">DeviceEntry documentation</a> and core <a href=\"https://github.com/home-assistant/core/pull/149730\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">PR 149730</a> which deprecated <code>DeviceEntry.suggested_area</code>.</p>",
            "url": "https://developers.home-assistant.io/blog/2025/08/01/suggested-area-removed-from-deviceentry",
            "title": "The DeviceEntry.suggested_area attribute is deprecated and will be removed",
            "summary": "The DeviceEntry.suggestedarea attribute is deprecated and will be removed in HA Core 2026.9. Also, suggestedarea will no longer be present in EVENTDEVICEREGISTRY_UPDATED events when HA Core 2026.9 is released.",
            "date_modified": "2025-08-01T00:00:00.000Z",
            "author": {
                "name": "Erik Montnemery",
                "url": "https://github.com/emontnemery"
            },
            "tags": []
        }
    ]
}