[python] Add CollectionBase.members (#2795) (#2849)

Co-authored-by: nguyenv <[email protected]>

apis/python/src/tiledbsoma/_collection.py

@@ -529,6 +529,11 @@ def set(
         )
         return self
 
+    def members(self) -> Dict[str, Tuple[str, str]]:
+        """Get a mapping of {member_name: (uri, soma_object_type)}"""
+        handle = cast(_tdb_handles.SOMAGroupWrapper[Any], self._handle)
+        return handle.members()
+
     def __setitem__(self, key: str, value: CollectionElementType) -> None:
         """Default collection __setattr__"""
         self.set(key, value, use_relative_uri=None)

apis/python/src/tiledbsoma/_tdb_handles.py

@@ -23,6 +23,7 @@
     Type,
     TypeVar,
     Union,
+    cast,
 )
 
 import attrs
@@ -296,6 +297,9 @@ def _do_initial_reads(self, group: clib.SOMAGroup) -> None:
     def meta(self) -> "MetadataWrapper":
         return self.metadata
 
+    def members(self) -> Dict[str, Tuple[str, str]]:
+        return cast(Dict[str, Tuple[str, str]], self._handle.members())
+
 
 class CollectionWrapper(SOMAGroupWrapper[clib.SOMACollection]):
     """Wrapper around a Pybind11 CollectionWrapper handle."""

apis/python/tests/test_collection.py

@@ -144,6 +144,7 @@ def test_collection_mapping(soma_object, tmp_path):
     assert list(k for k in c) == list(c.keys())
     assert len(c) == 1
     assert [k for k in c] == ["mumble"]
+    assert c.members() == {"mumble": (soma_object.uri, "SOMACollection")}
 
     # TEMPORARY: This should no longer raise an error once TileDB supports
     # replacing an existing group member.