🐛 fix(macos): yield individual site dirs in iter_*_dirs (#429)

On macOS, `iter_data_dirs()` and `iter_config_dirs()` were falling back
to the base class implementation which yields `site_data_dir` as a
single string. When `XDG_DATA_DIRS` is set with multiple paths (common
on NixOS and similar setups) or under Homebrew where multiple site
directories exist, this produced a colon-joined string like
`/path1:/path2` instead of yielding each directory individually. 🐛

The Unix platform already overrides both methods to `yield from
self._site_data_dirs` / `self._site_config_dirs`, correctly producing
individual paths. macOS has the same `_site_data_dirs` and
`_site_config_dirs` properties (Homebrew-aware + XDG mixin) but was
missing the matching overrides. This adds the identical overrides to
`_MacOSDefaults`, consistent with the existing Unix approach.

Windows is unaffected since it only has single-value site directories
with no `_site_data_dirs` property.

Fixes #377

Author: gaborbernat

src/platformdirs/macos.py

@@ -6,6 +6,9 @@
 import sys
 from typing import TYPE_CHECKING
 
+if TYPE_CHECKING:
+    from collections.abc import Iterator
+
 from ._xdg import XDGMixin
 from .api import PlatformDirsABC
 
@@ -137,6 +140,16 @@ def site_runtime_dir(self) -> str:
         """:return: runtime directory shared by users, same as `user_runtime_dir`"""
         return self.user_runtime_dir
 
+    def iter_config_dirs(self) -> Iterator[str]:
+        """:yield: all user and site configuration directories."""
+        yield self.user_config_dir
+        yield from self._site_config_dirs
+
+    def iter_data_dirs(self) -> Iterator[str]:
+        """:yield: all user and site data directories."""
+        yield self.user_data_dir
+        yield from self._site_data_dirs
+
 
 class MacOS(XDGMixin, _MacOSDefaults):
     """

tests/test_macos.py

@@ -268,3 +268,46 @@ def test_macos_xdg_empty_falls_back(
         "user_desktop_dir": f"{home}/Desktop",
     }
     assert getattr(MacOS(), prop) == expected_map[prop]
+
+
+def test_iter_data_dirs_xdg(monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.setenv("XDG_DATA_HOME", "/xdg/data")
+    monkeypatch.setenv("XDG_DATA_DIRS", "/xdg/share1:/xdg/share2")
+    dirs = list(MacOS().iter_data_dirs())
+    assert dirs == ["/xdg/data", "/xdg/share1", "/xdg/share2"]
+
+
+def test_iter_config_dirs_xdg(monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.setenv("XDG_CONFIG_HOME", "/xdg/config")
+    monkeypatch.setenv("XDG_CONFIG_DIRS", "/xdg/etc1:/xdg/etc2")
+    dirs = list(MacOS().iter_config_dirs())
+    assert dirs == ["/xdg/config", "/xdg/etc1", "/xdg/etc2"]
+
+
+@pytest.mark.usefixtures("_clear_xdg_env")
+def test_iter_data_dirs_homebrew(mocker: MockerFixture) -> None:
+    mocker.patch("sys.prefix", "/opt/homebrew/opt/python@3.13/Frameworks/Python.framework/Versions/3.13")
+    dirs = list(MacOS().iter_data_dirs())
+    home = str(Path("~").expanduser())
+    assert dirs == [f"{home}/Library/Application Support", "/opt/homebrew/share", "/Library/Application Support"]
+
+
+@pytest.mark.usefixtures("_clear_xdg_env")
+def test_iter_config_dirs_homebrew(mocker: MockerFixture) -> None:
+    mocker.patch("sys.prefix", "/opt/homebrew/opt/python@3.13/Frameworks/Python.framework/Versions/3.13")
+    dirs = list(MacOS().iter_config_dirs())
+    home = str(Path("~").expanduser())
+    assert dirs == [f"{home}/Library/Application Support", "/opt/homebrew/share", "/Library/Application Support"]
+
+
+@pytest.mark.usefixtures("_clear_xdg_env")
+def test_iter_data_dirs_no_homebrew(mocker: MockerFixture) -> None:
+    py_version = sys.version_info
+    builtin_py_prefix = (
+        "/Applications/Xcode.app/Contents/Developer/Library/Frameworks/Python3.framework"
+        f"/Versions/{py_version.major}.{py_version.minor}"
+    )
+    mocker.patch("sys.prefix", builtin_py_prefix)
+    dirs = list(MacOS().iter_data_dirs())
+    home = str(Path("~").expanduser())
+    assert dirs == [f"{home}/Library/Application Support", "/Library/Application Support"]