doc: add Document.paragraphs

Steve Canny · Steve Canny · commit 4188ffda3c87 · 2015-02-15T01:40:30.000-08:00
diff --git a/docx/document.py b/docx/document.py
@@ -116,6 +116,15 @@ def inline_shapes(self):
         """
         return self._part.inline_shapes
 
+    @property
+    def paragraphs(self):
+        """
+        A list of |Paragraph| instances corresponding to the paragraphs in
+        the document, in document order. Note that paragraphs within revision
+        marks such as ``<w:ins>`` or ``<w:del>`` do not appear in this list.
+        """
+        return self._body.paragraphs
+
     @property
     def part(self):
         """
diff --git a/tests/test_document.py b/tests/test_document.py
@@ -89,6 +89,11 @@ def it_provides_access_to_its_inline_shapes(self, inline_shapes_fixture):
         inline_shapes = document.inline_shapes
         assert inline_shapes is inline_shapes_
 
+    def it_provides_access_to_its_paragraphs(self, paragraphs_fixture):
+        document, paragraphs_ = paragraphs_fixture
+        paragraphs = document.paragraphs
+        assert paragraphs is paragraphs_
+
     def it_provides_access_to_the_document_part(self, part_fixture):
         document, part_ = part_fixture
         assert document.part is part_
@@ -185,6 +190,12 @@ def inline_shapes_fixture(self, document_part_, inline_shapes_):
         document_part_.inline_shapes = inline_shapes_
         return document, inline_shapes_
 
+    @pytest.fixture
+    def paragraphs_fixture(self, body_prop_, paragraphs_):
+        document = Document(None, None)
+        body_prop_.return_value.paragraphs = paragraphs_
+        return document, paragraphs_
+
     @pytest.fixture
     def part_fixture(self, document_part_):
         document = Document(None, document_part_)
@@ -224,6 +235,10 @@ def inline_shapes_(self, request):
     def paragraph_(self, request):
         return instance_mock(request, Paragraph)
 
+    @pytest.fixture
+    def paragraphs_(self, request):
+        return instance_mock(request, list)
+
     @pytest.fixture
     def picture_(self, request):
         return instance_mock(request, InlineShape)
