Add get_child_pages and get_descendant_pages to Confluence (#1630)

* Add get_child_pages and get_descendant_pages to Confluence Cloud and Server (closes #1613)

Adds dedicated methods to retrieve child and descendant pages for a
given content ID, using the /child/page and /descendant/page REST API
endpoints. These filter to pages only, unlike the existing
get_content_children/get_content_descendants which return all content
types including comments and attachments.

* Fix black formatting and flake8 lint errors

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: star7js

atlassian/confluence/__init__.py

@@ -25,9 +25,12 @@ def __init__(self, url, *args, **kwargs):
         if is_cloud is None:
             hostname = urlparse(url).hostname or ""
             is_cloud = (
-                hostname == "atlassian.net" or hostname.endswith(".atlassian.net")
-                or hostname == "jira.com" or hostname.endswith(".jira.com")
-                or hostname == "api.atlassian.com" or hostname.endswith(".api.atlassian.com")
+                hostname == "atlassian.net"
+                or hostname.endswith(".atlassian.net")
+                or hostname == "jira.com"
+                or hostname.endswith(".jira.com")
+                or hostname == "api.atlassian.com"
+                or hostname.endswith(".api.atlassian.com")
             )
         if is_cloud:
             impl = ConfluenceCloud(url, *args, **kwargs)

atlassian/confluence/cloud/__init__.py

@@ -56,6 +56,14 @@ def get_content_descendants(self, content_id, **kwargs):
         """Get descendant content."""
         return self.get(f"content/{content_id}/descendants", **kwargs)
 
+    def get_child_pages(self, content_id, **kwargs):
+        """Get child pages of a content item."""
+        return self.get(f"content/{content_id}/child/page", **kwargs)
+
+    def get_descendant_pages(self, content_id, **kwargs):
+        """Get all descendant pages of a content item."""
+        return self.get(f"content/{content_id}/descendant/page", **kwargs)
+
     def get_content_ancestors(self, content_id, **kwargs):
         """Get ancestor content."""
         return self.get(f"content/{content_id}/ancestors", **kwargs)

atlassian/confluence/cloud/base.py

@@ -23,5 +23,3 @@ def __init__(self, url, *args, **kwargs):
         :return: nothing
         """
         super(ConfluenceCloudBase, self).__init__(url, *args, **kwargs)
-
-

atlassian/confluence/server/__init__.py

@@ -48,6 +48,14 @@ def get_content_descendants(self, content_id, **kwargs):
         """Get descendant content."""
         return self.get(f"content/{content_id}/descendant", **kwargs)
 
+    def get_child_pages(self, content_id, **kwargs):
+        """Get child pages of a content item."""
+        return self.get(f"content/{content_id}/child/page", **kwargs)
+
+    def get_descendant_pages(self, content_id, **kwargs):
+        """Get all descendant pages of a content item."""
+        return self.get(f"content/{content_id}/descendant/page", **kwargs)
+
     def get_content_ancestors(self, content_id, **kwargs):
         """Get ancestor content."""
         return self.get(f"content/{content_id}/ancestor", **kwargs)
@@ -297,7 +305,9 @@ def get_all_draft_pages_from_space(self, space_key, **kwargs):
 
     def get_all_draft_blog_posts_from_space(self, space_key, **kwargs):
         """Get all draft blog posts from space."""
-        return self._get_paged("content", params={"spaceKey": space_key, "type": "blogpost", "status": "draft", **kwargs})
+        return self._get_paged(
+            "content", params={"spaceKey": space_key, "type": "blogpost", "status": "draft", **kwargs}
+        )
 
     # Trash Management
     def get_trash_content(self, space_key, **kwargs):
@@ -310,7 +320,9 @@ def get_all_pages_from_space_trash(self, space_key, **kwargs):
 
     def get_all_blog_posts_from_space_trash(self, space_key, **kwargs):
         """Get all blog posts from space trash."""
-        return self._get_paged("content", params={"spaceKey": space_key, "type": "blogpost", "status": "trashed", **kwargs})
+        return self._get_paged(
+            "content", params={"spaceKey": space_key, "type": "blogpost", "status": "trashed", **kwargs}
+        )
 
     # Export
     def export_content(self, content_id, **kwargs):

atlassian/confluence/server/base.py

@@ -23,5 +23,3 @@ def __init__(self, url, *args, **kwargs):
         :return: nothing
         """
         super(ConfluenceServerBase, self).__init__(url, *args, **kwargs)
-
-

tests/confluence/test_confluence_cloud.py

@@ -579,7 +579,7 @@ def test_pagination_with_relative_next_link_and_base(self, mock_get, confluence_
         assert result == [{"id": "1", "title": "Page 1"}, {"id": "2", "title": "Page 2"}]
 
         assert mock_get.call_count == 2
-        
+
         # Verify the second call used scheme+host from self.url (preserving API gateway routing)
         args, kwargs = mock_get.call_args_list[1]
         assert args[0] == "https://test.atlassian.net/rest/api/content?cursor=1"

tests/confluence/test_confluence_routing.py

@@ -1,9 +1,7 @@
 # coding=utf-8
 """Tests for legacy Confluence class URL routing."""
 
-from unittest.mock import patch, MagicMock
-
-import pytest
+from unittest.mock import patch
 
 from atlassian.confluence import Confluence, ConfluenceCloud, ConfluenceServer