para: add Paragraph.rendered_page_breaks

Author: scanny

features/par-access-inner-content.feature

@@ -32,7 +32,6 @@ Feature: Access paragraph inner-content including hyperlinks
      Then paragraph.iter_inner_content() generates the paragraph runs and hyperlinks
 
 
-  @wip
   Scenario Outline: Paragraph.rendered_page_breaks contains paragraph RenderedPageBreaks
     Given a paragraph having <zero-or-more> rendered page breaks
      Then paragraph.rendered_page_breaks has length <value>

src/docx/text/paragraph.py

@@ -14,6 +14,7 @@
 from docx.shared import Parented
 from docx.styles.style import CharacterStyle, ParagraphStyle
 from docx.text.hyperlink import Hyperlink
+from docx.text.pagebreak import RenderedPageBreak
 from docx.text.parfmt import ParagraphFormat
 from docx.text.run import Run
 
@@ -112,6 +113,17 @@ def paragraph_format(self):
         for this paragraph, such as line spacing and indentation."""
         return ParagraphFormat(self._element)
 
+    @property
+    def rendered_page_breaks(self) -> List[RenderedPageBreak]:
+        """All rendered page-breaks in this paragraph.
+
+        Most often an empty list, sometimes contains one page-break, but can contain
+        more than one is rare or contrived cases.
+        """
+        return [
+            RenderedPageBreak(lrpb, self) for lrpb in self._p.lastRenderedPageBreaks
+        ]
+
     @property
     def runs(self) -> List[Run]:
         """Sequence of |Run| instances corresponding to the <w:r> elements in this

tests/text/test_paragraph.py

@@ -100,6 +100,37 @@ def it_can_change_its_paragraph_style(self, style_set_fixture):
         )
         assert paragraph._p.xml == expected_xml
 
+    @pytest.mark.parametrize(
+        ("p_cxml", "count"),
+        [
+            ("w:p", 0),
+            ("w:p/w:r", 0),
+            ("w:p/w:r/w:lastRenderedPageBreak", 1),
+            ("w:p/w:hyperlink/w:r/w:lastRenderedPageBreak", 1),
+            (
+                "w:p/(w:r/w:lastRenderedPageBreak,"
+                "w:hyperlink/w:r/w:lastRenderedPageBreak)",
+                2,
+            ),
+            (
+                "w:p/(w:hyperlink/w:r/w:lastRenderedPageBreak,w:r,"
+                "w:r/w:lastRenderedPageBreak,w:r,w:hyperlink)",
+                2,
+            ),
+        ],
+    )
+    def it_provides_access_to_the_rendered_page_breaks_it_contains(
+        self, p_cxml: str, count: int, fake_parent: t.StoryChild
+    ):
+        p = cast(CT_P, element(p_cxml))
+        paragraph = Paragraph(p, fake_parent)
+
+        rendered_page_breaks = paragraph.rendered_page_breaks
+
+        actual = [type(item).__name__ for item in rendered_page_breaks]
+        expected = ["RenderedPageBreak" for _ in range(count)]
+        assert actual == expected, f"expected: {expected}, got: {actual}"
+
     @pytest.mark.parametrize(
         ("p_cxml", "expected_value"),
         [