From bb520589200a1fbc1675eb4d6f807099084e4bd0 Mon Sep 17 00:00:00 2001
From: Robert Resch <robert@resch.dev>
Date: Wed, 28 May 2025 11:16:08 +0200
Subject: [PATCH] Deprecate GStreamer integration (#145768)

---
 .../components/gstreamer/__init__.py          |  2 ++
 .../components/gstreamer/media_player.py      | 20 +++++++++--
 requirements_test_all.txt                     |  3 ++
 tests/components/gstreamer/__init__.py        |  1 +
 .../components/gstreamer/test_media_player.py | 34 +++++++++++++++++++
 5 files changed, 58 insertions(+), 2 deletions(-)
 create mode 100644 tests/components/gstreamer/__init__.py
 create mode 100644 tests/components/gstreamer/test_media_player.py

diff --git a/homeassistant/components/gstreamer/__init__.py b/homeassistant/components/gstreamer/__init__.py
index 9fb97d25744..d24ac28f25f 100644
--- a/homeassistant/components/gstreamer/__init__.py
+++ b/homeassistant/components/gstreamer/__init__.py
@@ -1 +1,3 @@
 """The gstreamer component."""
+
+DOMAIN = "gstreamer"
diff --git a/homeassistant/components/gstreamer/media_player.py b/homeassistant/components/gstreamer/media_player.py
index bb78aff8faf..7d830377f1b 100644
--- a/homeassistant/components/gstreamer/media_player.py
+++ b/homeassistant/components/gstreamer/media_player.py
@@ -19,16 +19,18 @@ from homeassistant.components.media_player import (
     async_process_play_media_url,
 )
 from homeassistant.const import CONF_NAME, EVENT_HOMEASSISTANT_STOP
-from homeassistant.core import HomeAssistant
+from homeassistant.core import DOMAIN as HOMEASSISTANT_DOMAIN, HomeAssistant
 from homeassistant.helpers import config_validation as cv
 from homeassistant.helpers.entity_platform import AddEntitiesCallback
+from homeassistant.helpers.issue_registry import IssueSeverity, create_issue
 from homeassistant.helpers.typing import ConfigType, DiscoveryInfoType
 
+from . import DOMAIN
+
 _LOGGER = logging.getLogger(__name__)
 
 CONF_PIPELINE = "pipeline"
 
-DOMAIN = "gstreamer"
 
 PLATFORM_SCHEMA = MEDIA_PLAYER_PLATFORM_SCHEMA.extend(
     {vol.Optional(CONF_NAME): cv.string, vol.Optional(CONF_PIPELINE): cv.string}
@@ -48,6 +50,20 @@ def setup_platform(
     discovery_info: DiscoveryInfoType | None = None,
 ) -> None:
     """Set up the Gstreamer platform."""
+    create_issue(
+        hass,
+        HOMEASSISTANT_DOMAIN,
+        f"deprecated_system_packages_yaml_integration_{DOMAIN}",
+        breaks_in_ha_version="2025.12.0",
+        is_fixable=False,
+        issue_domain=DOMAIN,
+        severity=IssueSeverity.WARNING,
+        translation_key="deprecated_system_packages_yaml_integration",
+        translation_placeholders={
+            "domain": DOMAIN,
+            "integration_title": "GStreamer",
+        },
+    )
 
     name = config.get(CONF_NAME)
     pipeline = config.get(CONF_PIPELINE)
diff --git a/requirements_test_all.txt b/requirements_test_all.txt
index 24bb23a331a..e14b9109ab7 100644
--- a/requirements_test_all.txt
+++ b/requirements_test_all.txt
@@ -945,6 +945,9 @@ growattServer==1.6.0
 # homeassistant.components.google_sheets
 gspread==5.5.0
 
+# homeassistant.components.gstreamer
+gstreamer-player==1.1.2
+
 # homeassistant.components.profiler
 guppy3==3.1.5
 
diff --git a/tests/components/gstreamer/__init__.py b/tests/components/gstreamer/__init__.py
new file mode 100644
index 00000000000..56369257098
--- /dev/null
+++ b/tests/components/gstreamer/__init__.py
@@ -0,0 +1 @@
+"""Gstreamer tests."""
diff --git a/tests/components/gstreamer/test_media_player.py b/tests/components/gstreamer/test_media_player.py
new file mode 100644
index 00000000000..9fcf8eb7cfc
--- /dev/null
+++ b/tests/components/gstreamer/test_media_player.py
@@ -0,0 +1,34 @@
+"""Tests for the Gstreamer platform."""
+
+from unittest.mock import Mock, patch
+
+from homeassistant.components.gstreamer import DOMAIN as GSTREAMER_DOMAIN
+from homeassistant.components.media_player import DOMAIN as PLATFORM_DOMAIN
+from homeassistant.const import CONF_PLATFORM
+from homeassistant.core import DOMAIN as HOMEASSISTANT_DOMAIN, HomeAssistant
+from homeassistant.helpers import issue_registry as ir
+from homeassistant.setup import async_setup_component
+
+
+@patch.dict("sys.modules", gsp=Mock())
+async def test_repair_issue_is_created(
+    hass: HomeAssistant,
+    issue_registry: ir.IssueRegistry,
+) -> None:
+    """Test repair issue is created."""
+    assert await async_setup_component(
+        hass,
+        PLATFORM_DOMAIN,
+        {
+            PLATFORM_DOMAIN: [
+                {
+                    CONF_PLATFORM: GSTREAMER_DOMAIN,
+                }
+            ],
+        },
+    )
+    await hass.async_block_till_done()
+    assert (
+        HOMEASSISTANT_DOMAIN,
+        f"deprecated_system_packages_yaml_integration_{GSTREAMER_DOMAIN}",
+    ) in issue_registry.issues