style: add _LatentStyle.priority getter

Steve Canny · Steve Canny · commit 15c1cfe15b73 · 2015-02-08T00:01:48.000-08:00
diff --git a/docx/oxml/styles.py b/docx/oxml/styles.py
@@ -79,6 +79,7 @@ class CT_LsdException(BaseOxmlElement):
     a named latent style.
     """
     name = RequiredAttribute('w:name', ST_String)
+    uiPriority = OptionalAttribute('w:uiPriority', ST_DecimalNumber)
 
 
 class CT_Style(BaseOxmlElement):
diff --git a/docx/styles/latent.py b/docx/styles/latent.py
@@ -132,3 +132,10 @@ def name(self):
         The name of the built-in style this exception applies to.
         """
         return self._element.name
+
+    @property
+    def priority(self):
+        """
+        The integer sort key for this latent style in the Word UI.
+        """
+        return self._element.uiPriority
diff --git a/features/sty-latent-props.feature b/features/sty-latent-props.feature
@@ -38,7 +38,6 @@ Feature: Get and set latent style properties
      Then latent_style.name is the known name
 
 
-  @wip
   Scenario Outline: Get latent style display sort order
     Given a latent style having priority of <setting>
      Then latent_style.priority is <value>
diff --git a/tests/styles/test_latent.py b/tests/styles/test_latent.py
@@ -21,6 +21,10 @@ def it_knows_its_name(self, name_get_fixture):
         latent_style, expected_value = name_get_fixture
         assert latent_style.name == expected_value
 
+    def it_knows_its_priority(self, priority_get_fixture):
+        latent_style, expected_value = priority_get_fixture
+        assert latent_style.priority == expected_value
+
     # fixtures -------------------------------------------------------
 
     @pytest.fixture(params=[
@@ -31,6 +35,15 @@ def name_get_fixture(self, request):
         latent_style = _LatentStyle(element(lsdException_cxml))
         return latent_style, expected_value
 
+    @pytest.fixture(params=[
+        ('w:lsdException',                  None),
+        ('w:lsdException{w:uiPriority=42}', 42),
+    ])
+    def priority_get_fixture(self, request):
+        lsdException_cxml, expected_value = request.param
+        latent_style = _LatentStyle(element(lsdException_cxml))
+        return latent_style, expected_value
+
 
 class DescribeLatentStyles(object):
 
