From 8fb542917bc8f2f4fe3b0fe30a347b7faf06b107 Mon Sep 17 00:00:00 2001
From: Erik Montnemery <erik@montnemery.com>
Date: Tue, 27 Feb 2024 13:45:12 +0100
Subject: [PATCH] Deprecate the Ambiclimate integration (#111627)

Deprecate Ambiclimate integration
---
 .../components/ambiclimate/__init__.py        | 15 ++++++-
 .../components/ambiclimate/strings.json       |  6 +++
 tests/components/ambiclimate/test_init.py     | 44 +++++++++++++++++++
 3 files changed, 64 insertions(+), 1 deletion(-)
 create mode 100644 tests/components/ambiclimate/test_init.py

diff --git a/homeassistant/components/ambiclimate/__init__.py b/homeassistant/components/ambiclimate/__init__.py
index 240c9780cee..7ed9deec898 100644
--- a/homeassistant/components/ambiclimate/__init__.py
+++ b/homeassistant/components/ambiclimate/__init__.py
@@ -4,7 +4,7 @@ import voluptuous as vol
 from homeassistant.config_entries import ConfigEntry
 from homeassistant.const import CONF_CLIENT_ID, CONF_CLIENT_SECRET, Platform
 from homeassistant.core import HomeAssistant
-from homeassistant.helpers import config_validation as cv
+from homeassistant.helpers import config_validation as cv, issue_registry as ir
 from homeassistant.helpers.typing import ConfigType
 
 from . import config_flow
@@ -41,5 +41,18 @@ async def async_setup(hass: HomeAssistant, config: ConfigType) -> bool:
 
 async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool:
     """Set up Ambiclimate from a config entry."""
+    ir.async_create_issue(
+        hass,
+        DOMAIN,
+        DOMAIN,
+        breaks_in_ha_version="2024.4.0",
+        is_fixable=False,
+        severity=ir.IssueSeverity.WARNING,
+        translation_key="integration_removed",
+        translation_placeholders={
+            "entries": "/config/integrations/integration/ambiclimate",
+        },
+    )
+
     await hass.config_entries.async_forward_entry_setups(entry, PLATFORMS)
     return True
diff --git a/homeassistant/components/ambiclimate/strings.json b/homeassistant/components/ambiclimate/strings.json
index bb008388c53..15a1a4e1f35 100644
--- a/homeassistant/components/ambiclimate/strings.json
+++ b/homeassistant/components/ambiclimate/strings.json
@@ -19,6 +19,12 @@
       "access_token": "Unknown error generating an access token."
     }
   },
+  "issues": {
+    "integration_removed": {
+      "title": "The Ambiclimate integration has been deprecated and will be removed",
+      "description": "All Ambiclimate services will be terminated, effective March 31, 2024, as Ambi Labs winds down business operations, and the Ambiclimate integration will be removed from Home Assistant.\n\nTo resolve this issue, please remove the integration entries from your Home Assistant setup. [Click here to see your existing Logi Circle integration entries]({entries})."
+    }
+  },
   "services": {
     "set_comfort_mode": {
       "name": "Set comfort mode",
diff --git a/tests/components/ambiclimate/test_init.py b/tests/components/ambiclimate/test_init.py
new file mode 100644
index 00000000000..aaf806dba5b
--- /dev/null
+++ b/tests/components/ambiclimate/test_init.py
@@ -0,0 +1,44 @@
+"""Tests for the Ambiclimate integration."""
+
+from unittest.mock import patch
+
+import pytest
+
+from homeassistant.components.ambiclimate import DOMAIN
+from homeassistant.config_entries import ConfigEntryState
+from homeassistant.core import HomeAssistant
+from homeassistant.helpers import issue_registry as ir
+
+from tests.common import MockConfigEntry
+
+
+@pytest.fixture(name="disable_platforms")
+async def disable_platforms_fixture(hass):
+    """Disable ambiclimate platforms."""
+    with patch("homeassistant.components.ambiclimate.PLATFORMS", []):
+        yield
+
+
+async def test_repair_issue(
+    hass: HomeAssistant,
+    issue_registry: ir.IssueRegistry,
+    disable_platforms,
+) -> None:
+    """Test the Ambiclimate configuration entry loading handles the repair."""
+    config_entry = MockConfigEntry(
+        title="Example 1",
+        domain=DOMAIN,
+    )
+    config_entry.add_to_hass(hass)
+    await hass.config_entries.async_setup(config_entry.entry_id)
+    await hass.async_block_till_done()
+    assert config_entry.state is ConfigEntryState.LOADED
+    assert issue_registry.async_get_issue(DOMAIN, DOMAIN)
+
+    # Remove the entry
+    await hass.config_entries.async_remove(config_entry.entry_id)
+    await hass.async_block_till_done()
+
+    # Ambiclimate does not implement unload
+    assert config_entry.state is ConfigEntryState.FAILED_UNLOAD
+    assert issue_registry.async_get_issue(DOMAIN, DOMAIN)