From cde17fc0ca3d95a81f7c9675d98eda7aba565e66 Mon Sep 17 00:00:00 2001
From: Paulus Schoutsen <balloob@gmail.com>
Date: Fri, 4 Jul 2025 16:21:11 +0200
Subject: [PATCH] add extra tests for media source URI parsing (#148114)

---
 .../components/media_source/models.py         | 10 +++
 tests/components/media_source/test_const.py   | 80 +++++++++++++++++++
 tests/components/media_source/test_models.py  | 16 ++++
 3 files changed, 106 insertions(+)
 create mode 100644 tests/components/media_source/test_const.py

diff --git a/homeassistant/components/media_source/models.py b/homeassistant/components/media_source/models.py
index 5e64dc867f2..8588c5bcacc 100644
--- a/homeassistant/components/media_source/models.py
+++ b/homeassistant/components/media_source/models.py
@@ -45,6 +45,16 @@ class MediaSourceItem:
     identifier: str
     target_media_player: str | None
 
+    @property
+    def media_source_id(self) -> str:
+        """Return the media source ID."""
+        uri = URI_SCHEME
+        if self.domain:
+            uri += self.domain
+            if self.identifier:
+                uri += f"/{self.identifier}"
+        return uri
+
     async def async_browse(self) -> BrowseMediaSource:
         """Browse this item."""
         if self.domain is None:
diff --git a/tests/components/media_source/test_const.py b/tests/components/media_source/test_const.py
new file mode 100644
index 00000000000..115c98a2c09
--- /dev/null
+++ b/tests/components/media_source/test_const.py
@@ -0,0 +1,80 @@
+"""Test constants for the media source component."""
+
+import pytest
+
+from homeassistant.components.media_source.const import URI_SCHEME_REGEX
+
+
+@pytest.mark.parametrize(
+    ("uri", "expected_domain", "expected_identifier"),
+    [
+        ("media-source://", None, None),
+        ("media-source://local_media", "local_media", None),
+        (
+            "media-source://local_media/some/path/file.mp3",
+            "local_media",
+            "some/path/file.mp3",
+        ),
+        ("media-source://a/b", "a", "b"),
+        (
+            "media-source://domain/file with spaces.mp4",
+            "domain",
+            "file with spaces.mp4",
+        ),
+        (
+            "media-source://domain/file-with-dashes.mp3",
+            "domain",
+            "file-with-dashes.mp3",
+        ),
+        ("media-source://domain/file.with.dots.mp3", "domain", "file.with.dots.mp3"),
+        (
+            "media-source://domain/special!@#$%^&*()chars",
+            "domain",
+            "special!@#$%^&*()chars",
+        ),
+    ],
+)
+def test_valid_uri_patterns(
+    uri: str, expected_domain: str | None, expected_identifier: str | None
+) -> None:
+    """Test various valid URI patterns."""
+    match = URI_SCHEME_REGEX.match(uri)
+    assert match is not None
+    assert match.group("domain") == expected_domain
+    assert match.group("identifier") == expected_identifier
+
+
+@pytest.mark.parametrize(
+    "uri",
+    [
+        "media-source:",  # missing //
+        "media-source:/",  # missing second /
+        "media-source:///",  # extra /
+        "media-source://domain/",  # trailing slash after domain
+        "invalid-scheme://domain",  # wrong scheme
+        "media-source//domain",  # missing :
+        "MEDIA-SOURCE://domain",  # uppercase scheme
+        "media_source://domain",  # underscore in scheme
+        "",  # empty string
+        "media-source",  # scheme only
+        "media-source://domain extra",  # extra content
+        "prefix media-source://domain",  # prefix content
+        "media-source://domain suffix",  # suffix content
+        # Invalid domain names
+        "media-source://_test",  # starts with underscore
+        "media-source://test_",  # ends with underscore
+        "media-source://_test_",  # starts and ends with underscore
+        "media-source://_",  # single underscore
+        "media-source://test-123",  # contains hyphen
+        "media-source://test.123",  # contains dot
+        "media-source://test 123",  # contains space
+        "media-source://TEST",  # uppercase letters
+        "media-source://Test",  # mixed case
+        # Identifier cannot start with slash
+        "media-source://domain//invalid",  # identifier starts with slash
+    ],
+)
+def test_invalid_uris(uri: str) -> None:
+    """Test invalid URI formats."""
+    match = URI_SCHEME_REGEX.match(uri)
+    assert match is None, f"URI '{uri}' should be invalid"
diff --git a/tests/components/media_source/test_models.py b/tests/components/media_source/test_models.py
index 12685e28d69..1ed03a83961 100644
--- a/tests/components/media_source/test_models.py
+++ b/tests/components/media_source/test_models.py
@@ -2,6 +2,7 @@
 
 from homeassistant.components.media_player import MediaClass, MediaType
 from homeassistant.components.media_source import const, models
+from homeassistant.core import HomeAssistant
 
 
 async def test_browse_media_as_dict() -> None:
@@ -68,3 +69,18 @@ async def test_media_source_default_name() -> None:
     """Test MediaSource uses domain as default name."""
     source = models.MediaSource(const.DOMAIN)
     assert source.name == const.DOMAIN
+
+
+async def test_media_source_item_media_source_id(hass: HomeAssistant) -> None:
+    """Test MediaSourceItem media_source_id property."""
+    # Test with domain and identifier
+    item = models.MediaSourceItem(hass, "test_domain", "test/identifier", None)
+    assert item.media_source_id == "media-source://test_domain/test/identifier"
+
+    # Test with domain only
+    item = models.MediaSourceItem(hass, "test_domain", "", None)
+    assert item.media_source_id == "media-source://test_domain"
+
+    # Test with no domain (root)
+    item = models.MediaSourceItem(hass, None, "", None)
+    assert item.media_source_id == "media-source://"