style: add LatentStyles.default_priority getter

Steve Canny · Steve Canny · commit c6ee527cb412 · 2015-02-08T00:01:47.000-08:00
diff --git a/docx/oxml/styles.py b/docx/oxml/styles.py
@@ -5,7 +5,7 @@
 """
 
 from ..enum.style import WD_STYLE_TYPE
-from .simpletypes import ST_OnOff, ST_String
+from .simpletypes import ST_DecimalNumber, ST_OnOff, ST_String
 from .xmlchemy import (
     BaseOxmlElement, OptionalAttribute, ZeroOrMore, ZeroOrOne
 )
@@ -38,6 +38,8 @@ class CT_LatentStyles(BaseOxmlElement):
     """
     lsdException = ZeroOrMore('w:lsdException', successors=())
 
+    defUIPriority = OptionalAttribute('w:defUIPriority', ST_DecimalNumber)
+
     def get_by_name(self, name):
         """
         Return the `w:lsdException` child having *name*, or |None| if not
diff --git a/docx/styles/latent.py b/docx/styles/latent.py
@@ -35,6 +35,15 @@ def __iter__(self):
     def __len__(self):
         return len(self._element.lsdException_lst)
 
+    @property
+    def default_priority(self):
+        """
+        Integer between 0 and 99 inclusive specifying the default sort order
+        for latent styles in style lists and the style gallery. |None| if no
+        value is assigned, which causes Word to use the default value 99.
+        """
+        return self._element.defUIPriority
+
 
 class _LatentStyle(ElementProxy):
     """
diff --git a/tests/styles/test_latent.py b/tests/styles/test_latent.py
@@ -39,6 +39,10 @@ def it_raises_on_latent_style_not_found(self, getitem_raises_fixture):
         with pytest.raises(KeyError):
             latent_styles[name]
 
+    def it_knows_its_default_priority(self, priority_get_fixture):
+        latent_styles, expected_value = priority_get_fixture
+        assert latent_styles.default_priority == expected_value
+
     # fixture --------------------------------------------------------
 
     @pytest.fixture(params=[
@@ -78,3 +82,12 @@ def len_fixture(self, request):
         latentStyles_cxml, count = request.param
         latent_styles = LatentStyles(element(latentStyles_cxml))
         return latent_styles, count
+
+    @pytest.fixture(params=[
+        ('w:latentStyles',                     None),
+        ('w:latentStyles{w:defUIPriority=42}', 42),
+    ])
+    def priority_get_fixture(self, request):
+        latentStyles_cxml, expected_value = request.param
+        latent_styles = LatentStyles(element(latentStyles_cxml))
+        return latent_styles, expected_value
