body: add _Body.clear_content()

Steve Canny · Steve Canny · commit c293458200b7 · 2013-12-20T21:05:20.000-08:00
diff --git a/docx/parts.py b/docx/parts.py
@@ -57,6 +57,15 @@ def add_paragraph(self):
         p = self._body.add_p()
         return Paragraph(p)
 
+    def clear_content(self):
+        """
+        Return this |_Body| instance after clearing it of all content.
+        Section properties for the main document story, if present, are
+        preserved.
+        """
+        self._body.clear_content()
+        return self
+
     @property
     def paragraphs(self):
         if not hasattr(self._body, 'p'):
diff --git a/tests/test_parts.py b/tests/test_parts.py
@@ -109,3 +109,13 @@ def it_provides_access_to_its_paragraphs_as_a_sequence(self, Paragraph_):
     def it_returns_an_empty_sequence_when_it_contains_no_paragraphs(self):
         body = _Body(a_body().element)
         assert body.paragraphs == ()
+
+    def it_can_clear_itself_of_all_content_it_holds(self):
+        # mockery ----------------------
+        body_elm = Mock(name='body_elm')
+        body = _Body(body_elm)
+        # exercise ---------------------
+        retval = body.clear_content()
+        # verify -----------------------
+        body_elm.clear_content.assert_called_once_with()
+        assert retval is body
