parfmt: add ParaFormat.first_line_indent.setter

Steve Canny · Steve Canny · commit 4321d9eb3265 · 2015-02-08T00:01:44.000-08:00
diff --git a/docx/oxml/text/paragraph.py b/docx/oxml/text/paragraph.py
@@ -142,6 +142,19 @@ def first_line_indent(self):
             return None
         return firstLine
 
+    @first_line_indent.setter
+    def first_line_indent(self, value):
+        if self.ind is None and value is None:
+            return
+        ind = self.get_or_add_ind()
+        ind.firstLine = ind.hanging = None
+        if value is None:
+            return
+        elif value < 0:
+            ind.hanging = -value
+        else:
+            ind.firstLine = value
+
     @property
     def ind_left(self):
         """
diff --git a/docx/text/paragraph.py b/docx/text/paragraph.py
@@ -172,6 +172,11 @@ def first_line_indent(self):
             return None
         return pPr.first_line_indent
 
+    @first_line_indent.setter
+    def first_line_indent(self, value):
+        pPr = self._element.get_or_add_pPr()
+        pPr.first_line_indent = value
+
     @property
     def left_indent(self):
         """
diff --git a/tests/text/test_paragraph.py b/tests/text/test_paragraph.py
@@ -338,6 +338,11 @@ def it_knows_its_first_line_indent(self, first_indent_get_fixture):
         paragraph_format, expected_value = first_indent_get_fixture
         assert paragraph_format.first_line_indent == expected_value
 
+    def it_can_change_its_first_line_indent(self, first_indent_set_fixture):
+        paragraph_format, value, expected_xml = first_indent_set_fixture
+        paragraph_format.first_line_indent = value
+        assert paragraph_format._element.xml == expected_xml
+
     def it_knows_its_left_indent(self, left_indent_get_fixture):
         paragraph_format, expected_value = left_indent_get_fixture
         assert paragraph_format.left_indent == expected_value
@@ -388,6 +393,24 @@ def first_indent_get_fixture(self, request):
         paragraph_format = ParagraphFormat(element(p_cxml))
         return paragraph_format, expected_value
 
+    @pytest.fixture(params=[
+        ('w:p', Pt(36),  'w:p/w:pPr/w:ind{w:firstLine=720}'),
+        ('w:p', Pt(-36), 'w:p/w:pPr/w:ind{w:hanging=720}'),
+        ('w:p', 0,       'w:p/w:pPr/w:ind{w:firstLine=0}'),
+        ('w:p', None,    'w:p/w:pPr'),
+        ('w:p/w:pPr/w:ind{w:firstLine=240}', None,
+         'w:p/w:pPr/w:ind'),
+        ('w:p/w:pPr/w:ind{w:firstLine=240}', Pt(-18),
+         'w:p/w:pPr/w:ind{w:hanging=360}'),
+        ('w:p/w:pPr/w:ind{w:hanging=240}',   Pt(18),
+         'w:p/w:pPr/w:ind{w:firstLine=360}'),
+    ])
+    def first_indent_set_fixture(self, request):
+        p_cxml, value, expected_p_cxml = request.param
+        paragraph_format = ParagraphFormat(element(p_cxml))
+        expected_xml = xml(expected_p_cxml)
+        return paragraph_format, value, expected_xml
+
     @pytest.fixture(params=[
         ('w:p',                             None),
         ('w:p/w:pPr',                       None),
