para: add Paragraph.paragraph_format

Steve Canny · Steve Canny · commit bddd27a895ee · 2015-02-08T00:01:45.000-08:00
diff --git a/docx/text/paragraph.py b/docx/text/paragraph.py
@@ -20,7 +20,7 @@ class Paragraph(Parented):
     """
     def __init__(self, p, parent):
         super(Paragraph, self).__init__(parent)
-        self._p = p
+        self._p = self._element = p
 
     def add_run(self, text=None, style=None):
         """
@@ -76,6 +76,14 @@ def insert_paragraph_before(self, text=None, style=None):
             paragraph.style = style
         return paragraph
 
+    @property
+    def paragraph_format(self):
+        """
+        The |ParagraphFormat| object providing access to the formatting
+        properties for this paragraph, such as line spacing and indentation.
+        """
+        return ParagraphFormat(self._element)
+
     @property
     def runs(self):
         """
diff --git a/features/par-access-parfmt.feature b/features/par-access-parfmt.feature
@@ -4,7 +4,6 @@ Feature: Access paragraph format
   I need access to the paragraph format of a paragraph
 
 
-  @wip
   Scenario: Get paragraph format object
     Given a paragraph
      Then paragraph.paragraph_format is its ParagraphFormat object
diff --git a/features/steps/paragraph.py b/features/steps/paragraph.py
@@ -96,7 +96,7 @@ def then_paragraph_paragraph_format_is_its_parfmt_object(context):
     paragraph = context.paragraph
     paragraph_format = paragraph.paragraph_format
     assert isinstance(paragraph_format, ParagraphFormat)
-    assert paragraph_format.element is paragraph.element
+    assert paragraph_format.element is paragraph._element
 
 
 @then('paragraph.style is {value_key}')
diff --git a/tests/text/test_paragraph.py b/tests/text/test_paragraph.py
@@ -63,6 +63,12 @@ def it_can_change_its_alignment_value(self, alignment_set_fixture):
         paragraph.alignment = value
         assert paragraph._p.xml == expected_xml
 
+    def it_provides_access_to_its_paragraph_format(self, parfmt_fixture):
+        paragraph, ParagraphFormat_, paragraph_format_ = parfmt_fixture
+        paragraph_format = paragraph.paragraph_format
+        ParagraphFormat_.assert_called_once_with(paragraph._element)
+        assert paragraph_format is paragraph_format_
+
     def it_provides_access_to_the_runs_it_contains(self, runs_fixture):
         paragraph, Run_, r_, r_2_, run_, run_2_ = runs_fixture
         runs = paragraph.runs
@@ -183,6 +189,11 @@ def _insert_before_fixture(self, request):
         expected_xml = xml(expected_cxml)
         return paragraph, body, expected_xml
 
+    @pytest.fixture
+    def parfmt_fixture(self, ParagraphFormat_, paragraph_format_):
+        paragraph = Paragraph(element('w:p'), None)
+        return paragraph, ParagraphFormat_, paragraph_format_
+
     @pytest.fixture
     def runs_fixture(self, p_, Run_, r_, r_2_, runs_):
         paragraph = Paragraph(p_, None)
@@ -258,6 +269,17 @@ def _insert_paragraph_before_(self, request):
     def p_(self, request, r_, r_2_):
         return instance_mock(request, CT_P, r_lst=(r_, r_2_))
 
+    @pytest.fixture
+    def ParagraphFormat_(self, request, paragraph_format_):
+        return class_mock(
+            request, 'docx.text.paragraph.ParagraphFormat',
+            return_value=paragraph_format_
+        )
+
+    @pytest.fixture
+    def paragraph_format_(self, request):
+        return instance_mock(request, ParagraphFormat)
+
     @pytest.fixture
     def part_prop_(self, request, document_part_):
         return property_mock(
