para: add Paragraph.text setter

Steve Canny · Steve Canny · commit 1a8e23220de3 · 2014-06-26T22:01:43.000-07:00
diff --git a/docx/text.py b/docx/text.py
@@ -121,14 +121,27 @@ def style(self, style):
     @property
     def text(self):
         """
-        A string formed by concatenating the text of each run in the
-        paragraph.
+        String formed by concatenating the text of each run in the paragraph.
+        Tabs and line breaks in the XML are mapped to ``\\t`` and ``\\n``
+        characters respectively.
+
+        Assigning text to this property causes all existing paragraph content
+        to be replaced with a single run containing the assigned text.
+        A ``\\t`` character in the text is mapped to a ``<w:tab/>`` element
+        and each ``\\n`` or ``\\r`` character is mapped to a line break.
+        Paragraph-level formatting, such as style, is preserved. All
+        run-level formatting, such as bold or italic, is removed.
         """
         text = ''
         for run in self.runs:
             text += run.text
         return text
 
+    @text.setter
+    def text(self, text):
+        self.clear()
+        self.add_run(text)
+
 
 class Run(object):
     """
diff --git a/features/par-set-text.feature b/features/par-set-text.feature
@@ -4,7 +4,6 @@ Feature: Replace paragraph text
   I need a writable text property on paragraph
 
 
-  @wip
   Scenario: Set paragraph text
     Given a paragraph with content and formatting
      When I set the paragraph text
diff --git a/tests/test_text.py b/tests/test_text.py
@@ -65,6 +65,11 @@ def it_knows_the_text_it_contains(self, text_get_fixture):
         paragraph, expected_text = text_get_fixture
         assert paragraph.text == expected_text
 
+    def it_can_replace_the_text_it_contains(self, text_set_fixture):
+        paragraph, text, expected_text = text_set_fixture
+        paragraph.text = text
+        assert paragraph.text == expected_text
+
     def it_can_insert_a_paragraph_before_itself(self, insert_before_fixture):
         paragraph, text, style, body, expected_xml = insert_before_fixture
         new_paragraph = paragraph.insert_paragraph_before(text, style)
@@ -153,6 +158,13 @@ def text_get_fixture(self):
         paragraph = Paragraph(p)
         return paragraph, 'foo de bar'
 
+    @pytest.fixture
+    def text_set_fixture(self):
+        p = a_p().with_nsdecls().element
+        paragraph = Paragraph(p)
+        paragraph.add_run('barfoo')
+        return paragraph, 'foo\tbar\rbaz\n', 'foo\tbar\nbaz\n'
+
     # fixture components ---------------------------------------------
 
     @pytest.fixture
