Add content_items to child / descendant tags

Author: schloerke

src/posit/connect/tags.py

@@ -146,6 +146,28 @@ def __init__(self, ctx: Context, path: str, /, *, parent_tag: Tag) -> None:
         self._path = path
         self._parent_tag = parent_tag
 
+    def content_items(self) -> ChildTagContentItems:
+        """
+        Find all content items from the child tags.
+
+        Returns
+        -------
+        ChildTagContentItems
+            Helper class that can `.find()` all content items that are tagged with a child tag.
+
+        Examples
+        --------
+        ```python
+        import posit
+
+        client = posit.connect.Client(...)
+
+        mytag = client.tags.find(id="TAG_ID_HERE")
+        tagged_content_items = mytag.child_tags.content_items.find()
+        ```
+        """
+        return ChildTagContentItems(self._ctx, self._path, parent_tag=self._parent_tag)
+
     def find(self) -> list[Tag]:
         """
         Find all child tags that are direct children of a single tag.
@@ -166,13 +188,56 @@ def find(self) -> list[Tag]:
         return child_tags
 
 
+class ChildTagContentItems(ContextManager):
+    def __init__(self, ctx: Context, path: str, /, *, parent_tag: Tag) -> None:
+        super().__init__()
+        self._ctx = ctx
+        self._path = path
+        self._parent_tag = parent_tag
+
+    def find(self) -> list[ContentItem]:
+        """
+        Find all content items that are tagged with a child tag.
+
+        Returns
+        -------
+        list[ContentItem]
+            List of content items that are tagged with a child tag.
+        """
+        child_tags = self._parent_tag.child_tags.find()
+        content_items = DescendantTagContentItems._unique_content_items(child_tags)
+        return content_items
+
+
 class DescendantTags(ContextManager):
     def __init__(self, ctx: Context, /, *, parent_tag: Tag) -> None:
         super().__init__()
         self._ctx = ctx
         self._path = "v1/tags"
         self._parent_tag = parent_tag
 
+    def content_items(self) -> DescendantTagContentItems:
+        """
+        Find all content items from the descendant tags.
+
+        Returns
+        -------
+        DescendantTagContentItems
+            Helper class that can `.find()` all content items that are tagged with a descendant tag.
+
+        Examples
+        --------
+        ```python
+        import posit
+
+        client = posit.connect.Client(...)
+
+        mytag = client.tags.find(id="TAG_ID_HERE")
+        tagged_content_items = mytag.descendant_tags.content_items.find()
+        ```
+        """
+        return DescendantTagContentItems(self._ctx, self._path, parent_tag=self._parent_tag)
+
     def find(self) -> list[Tag]:
         """
         Find all child tags that descend from a single tag.
@@ -218,6 +283,44 @@ def find(self) -> list[Tag]:
         return child_tags
 
 
+class DescendantTagContentItems(ContextManager):
+    def __init__(self, ctx: Context, path: str, /, *, parent_tag: Tag) -> None:
+        super().__init__()
+        self._ctx = ctx
+        self._path = path
+        self._parent_tag = parent_tag
+
+    @staticmethod
+    def _unique_content_items(tags: list[Tag]) -> list[ContentItem]:
+        content_items: list[ContentItem] = []
+        content_items_seen: set[str] = set()
+
+        for tag in tags:
+            tag_content_items = tag.content_items.find()
+
+            for content_item in tag_content_items:
+                content_item_guid = content_item["guid"]
+
+                if content_item_guid not in content_items_seen:
+                    content_items.append(content_item)
+                    content_items_seen.add(content_item_guid)
+
+        return content_items
+
+    def find(self) -> list[ContentItem]:
+        """
+        Find all content items that are tagged with a descendant tag.
+
+        Returns
+        -------
+        list[ContentItem]
+            List of content items that are tagged with a descendant tag.
+        """
+        descendant_tags = self._parent_tag.descendant_tags.find()
+        content_items = self._unique_content_items(descendant_tags)
+        return content_items
+
+
 class Tags(ContextManager):
     """Content item tags resource."""