hdr: add _Footer._has_definition

Author: scanny

docx/oxml/section.py

@@ -124,6 +124,14 @@ def footer(self, value):
         pgMar = self.get_or_add_pgMar()
         pgMar.footer = value
 
+    def get_footerReference(self, type_):
+        """Return footerReference element of *type_* or None if not present."""
+        path = "./w:footerReference[@w:type='%s']" % WD_HEADER_FOOTER.to_xml(type_)
+        footerReferences = self.xpath(path)
+        if not footerReferences:
+            return None
+        return footerReferences[0]
+
     def get_headerReference(self, type_):
         """Return headerReference element of *type_* or None if not present."""
         matching_headerReferences = self.xpath(

docx/section.py

@@ -241,6 +241,12 @@ def _has_definition(self):
 class _Footer(_BaseHeaderFooter):
     """Page footer."""
 
+    @property
+    def _has_definition(self):
+        """True if a footer is defined for this section."""
+        footerReference = self._sectPr.get_footerReference(WD_HEADER_FOOTER.PRIMARY)
+        return False if footerReference is None else True
+
 
 class _Header(_BaseHeaderFooter):
     """Page header."""

features/hdr-header-footer.feature

@@ -34,7 +34,6 @@ Feature: Header and footer behaviors
       And header_2.is_linked_to_previous is True
 
 
-  @wip
   Scenario Outline: _Footer.is_linked_to_previous getter
     Given a _Footer object <with-or-no> footer definition as footer
      Then footer.is_linked_to_previous is <value>

tests/test_section.py

@@ -385,6 +385,29 @@ def _has_definition_prop_(self, request):
         return property_mock(request, _BaseHeaderFooter, "_has_definition")
 
 
+class Describe_Footer(object):
+
+    def it_knows_when_it_has_a_definition_to_help(self, has_definition_fixture):
+        sectPr, expected_value = has_definition_fixture
+        footer = _Footer(sectPr, None)
+
+        has_definition = footer._has_definition
+
+        assert has_definition is expected_value
+
+    # fixtures -------------------------------------------------------
+
+    @pytest.fixture(
+        params=[
+            ("w:sectPr", False), ("w:sectPr/w:footerReference{w:type=default}", True)
+        ]
+    )
+    def has_definition_fixture(self, request):
+        sectPr_cxml, expected_value = request.param
+        sectPr = element(sectPr_cxml)
+        return sectPr, expected_value
+
+
 class Describe_Header(object):
 
     def it_knows_when_its_linked_to_the_previous_header(