parfmt: add ParagraphFormat.left_indent getter

Steve Canny · Steve Canny · commit 0c2681037713 · 2015-02-08T00:01:44.000-08:00
diff --git a/docx/oxml/text/paragraph.py b/docx/oxml/text/paragraph.py
@@ -18,6 +18,7 @@ class CT_Ind(BaseOxmlElement):
     """
     ``<w:ind>`` element, specifying paragraph indentation.
     """
+    left = OptionalAttribute('w:left', ST_SignedTwipsMeasure)
     firstLine = OptionalAttribute('w:firstLine', ST_TwipsMeasure)
     hanging = OptionalAttribute('w:hanging', ST_TwipsMeasure)
 
@@ -140,6 +141,16 @@ def first_line_indent(self):
             return None
         return firstLine
 
+    @property
+    def ind_left(self):
+        """
+        The value of `w:ind/@w:left` or |None| if not present.
+        """
+        ind = self.ind
+        if ind is None:
+            return None
+        return ind.left
+
     @property
     def jc_val(self):
         """
diff --git a/docx/text/paragraph.py b/docx/text/paragraph.py
@@ -172,6 +172,19 @@ def first_line_indent(self):
             return None
         return pPr.first_line_indent
 
+    @property
+    def left_indent(self):
+        """
+        |Length| value specifying the space between the left margin and the
+        left side of the paragraph. |None| indicates the left indent value is
+        inherited from the style hierarchy. Use an |Inches| value object as
+        a convenient way to apply indentation in units of inches.
+        """
+        pPr = self._element.pPr
+        if pPr is None:
+            return None
+        return pPr.ind_left
+
     @property
     def line_spacing(self):
         """
diff --git a/tests/text/test_paragraph.py b/tests/text/test_paragraph.py
@@ -338,6 +338,10 @@ 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_knows_its_left_indent(self, left_indent_get_fixture):
+        paragraph_format, expected_value = left_indent_get_fixture
+        assert paragraph_format.left_indent == expected_value
+
     # fixtures -------------------------------------------------------
 
     @pytest.fixture(params=[
@@ -380,6 +384,18 @@ def first_indent_get_fixture(self, request):
         paragraph_format = ParagraphFormat(element(p_cxml))
         return paragraph_format, expected_value
 
+    @pytest.fixture(params=[
+        ('w:p',                             None),
+        ('w:p/w:pPr',                       None),
+        ('w:p/w:pPr/w:ind',                 None),
+        ('w:p/w:pPr/w:ind{w:left=120}',     Pt(6)),
+        ('w:p/w:pPr/w:ind{w:left=-06.3pt}', Pt(-6.3)),
+    ])
+    def left_indent_get_fixture(self, request):
+        p_cxml, expected_value = request.param
+        paragraph_format = ParagraphFormat(element(p_cxml))
+        return paragraph_format, expected_value
+
     @pytest.fixture(params=[
         ('w:p',                                                None),
         ('w:p/w:pPr',                                          None),
