style: add _LatentStyle.name getter

Author: Steve Canny

docx/oxml/__init__.py

@@ -113,10 +113,11 @@ def OxmlElement(nsptag_str, attrs=None, nsdecls=None):
 register_element_cls('wp:extent',     CT_PositiveSize2D)
 register_element_cls('wp:inline',     CT_Inline)
 
-from .styles import CT_LatentStyles, CT_Style, CT_Styles
+from .styles import CT_LatentStyles, CT_LsdException, CT_Style, CT_Styles
 register_element_cls('w:basedOn',        CT_String)
 register_element_cls('w:latentStyles',   CT_LatentStyles)
 register_element_cls('w:locked',         CT_OnOff)
+register_element_cls('w:lsdException',   CT_LsdException)
 register_element_cls('w:name',           CT_String)
 register_element_cls('w:qFormat',        CT_OnOff)
 register_element_cls('w:semiHidden',     CT_OnOff)

docx/oxml/styles.py

@@ -7,7 +7,8 @@
 from ..enum.style import WD_STYLE_TYPE
 from .simpletypes import ST_DecimalNumber, ST_OnOff, ST_String
 from .xmlchemy import (
-    BaseOxmlElement, OptionalAttribute, ZeroOrMore, ZeroOrOne
+    BaseOxmlElement, OptionalAttribute, RequiredAttribute, ZeroOrMore,
+    ZeroOrOne
 )
 
 
@@ -72,6 +73,14 @@ def set_bool_prop(self, attr_name, value):
         setattr(self, attr_name, bool(value))
 
 
+class CT_LsdException(BaseOxmlElement):
+    """
+    ``<w:lsdException>`` element, defining override visibility behaviors for
+    a named latent style.
+    """
+    name = RequiredAttribute('w:name', ST_String)
+
+
 class CT_Style(BaseOxmlElement):
     """
     A ``<w:style>`` element, representing a style definition

docx/styles/latent.py

@@ -125,3 +125,10 @@ class _LatentStyle(ElementProxy):
     """
 
     __slots__ = ()
+
+    @property
+    def name(self):
+        """
+        The name of the built-in style this exception applies to.
+        """
+        return self._element.name

features/sty-latent-props.feature

@@ -33,7 +33,6 @@ Feature: Get and set latent style properties
       | default_to_unhide_when_used |   False   | False |
 
 
-  @wip
   Scenario: Get latent style name
     Given a latent style having a known name
      Then latent_style.name is the known name

tests/styles/test_latent.py

@@ -15,6 +15,23 @@
 from ..unitutil.cxml import element, xml
 
 
+class DescribeLatentStyle(object):
+
+    def it_knows_its_name(self, name_get_fixture):
+        latent_style, expected_value = name_get_fixture
+        assert latent_style.name == expected_value
+
+    # fixtures -------------------------------------------------------
+
+    @pytest.fixture(params=[
+        ('w:lsdException{w:name=Foobar}', 'Foobar'),
+    ])
+    def name_get_fixture(self, request):
+        lsdException_cxml, expected_value = request.param
+        latent_style = _LatentStyle(element(lsdException_cxml))
+        return latent_style, expected_value
+
+
 class DescribeLatentStyles(object):
 
     def it_knows_how_many_latent_styles_it_contains(self, len_fixture):
@@ -67,7 +84,7 @@ def it_can_change_its_boolean_properties(self, bool_prop_set_fixture):
         setattr(latent_styles, prop_name, value)
         assert latent_styles.element.xml == expected_xml
 
-    # fixture --------------------------------------------------------
+    # fixtures -------------------------------------------------------
 
     @pytest.fixture(params=[
         ('w:latentStyles', 'default_to_hidden',           False),