style: add _ParagraphStyle.paragraph_format

Steve Canny · Steve Canny · commit 37788b04151a · 2015-02-08T00:01:42.000-08:00
diff --git a/docx/styles/style.py b/docx/styles/style.py
@@ -10,6 +10,7 @@
 
 from ..enum.style import WD_STYLE_TYPE
 from ..shared import ElementProxy
+from ..text.paragraph import ParagraphFormat
 from ..text.run import Font
 
 
@@ -151,6 +152,14 @@ class _ParagraphStyle(_CharacterStyle):
 
     __slots__ = ()
 
+    @property
+    def paragraph_format(self):
+        """
+        The |ParagraphFormat| object providing access to the paragraph
+        properties for this style.
+        """
+        return ParagraphFormat(self._element)
+
 
 class _TableStyle(_ParagraphStyle):
     """
diff --git a/features/sty-access-parfmt.feature b/features/sty-access-parfmt.feature
@@ -4,7 +4,6 @@ Feature: Access style paragraph format
   I need access to the paragraph format of a style
 
 
-  @wip
   Scenario Outline: Get style paragraph format
     Given a style of type <style-type>
      Then style.paragraph_format is the ParagraphFormat object for the style
diff --git a/tests/styles/test_style.py b/tests/styles/test_style.py
@@ -15,6 +15,7 @@
     BaseStyle, _CharacterStyle, _ParagraphStyle, _NumberingStyle,
     StyleFactory, _TableStyle
 )
+from docx.text.paragraph import ParagraphFormat
 from docx.text.run import Font
 
 from ..unitutil.cxml import element, xml
@@ -286,3 +287,32 @@ def style_(self, request):
     @pytest.fixture
     def StyleFactory_(self, request):
         return function_mock(request, 'docx.styles.style.StyleFactory')
+
+
+class Describe_ParagraphStyle(object):
+
+    def it_provides_access_to_its_paragraph_format(self, parfmt_fixture):
+        style, ParagraphFormat_, paragraph_format_ = parfmt_fixture
+        paragraph_format = style.paragraph_format
+        ParagraphFormat_.assert_called_once_with(style._element)
+        assert paragraph_format is paragraph_format_
+
+    # fixtures -------------------------------------------------------
+
+    @pytest.fixture
+    def parfmt_fixture(self, ParagraphFormat_, paragraph_format_):
+        style = _ParagraphStyle(element('w:style'))
+        return style, ParagraphFormat_, paragraph_format_
+
+    # fixture components ---------------------------------------------
+
+    @pytest.fixture
+    def ParagraphFormat_(self, request, paragraph_format_):
+        return class_mock(
+            request, 'docx.styles.style.ParagraphFormat',
+            return_value=paragraph_format_
+        )
+
+    @pytest.fixture
+    def paragraph_format_(self, request):
+        return instance_mock(request, ParagraphFormat)
