hdr: add HeaderPart._default_header_xml()

Author: scanny

docx/parts/hdrftr.py

@@ -4,6 +4,8 @@
 
 from __future__ import absolute_import, division, print_function, unicode_literals
 
+import os
+
 from docx.opc.constants import CONTENT_TYPE as CT
 from docx.opc.part import XmlPart
 from docx.oxml import parse_xml
@@ -23,4 +25,9 @@ def new(cls, package):
     @classmethod
     def _default_header_xml(cls):
         """Return bytes containing XML for a default header part."""
-        raise NotImplementedError
+        path = os.path.join(
+            os.path.split(__file__)[0], '..', 'templates', 'default-header.xml'
+        )
+        with open(path, 'rb') as f:
+            xml_bytes = f.read()
+        return xml_bytes

docx/templates/default-header.xml

@@ -0,0 +1,27 @@
+<?xml version='1.0' encoding='UTF-8' standalone='yes'?>
+<w:hdr
+    xmlns:m="http://schemas.openxmlformats.org/officeDocument/2006/math"
+    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
+    xmlns:mo="http://schemas.microsoft.com/office/mac/office/2008/main"
+    xmlns:mv="urn:schemas-microsoft-com:mac:vml"
+    xmlns:o="urn:schemas-microsoft-com:office:office"
+    xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"
+    xmlns:v="urn:schemas-microsoft-com:vml"
+    xmlns:w10="urn:schemas-microsoft-com:office:word"
+    xmlns:w14="http://schemas.microsoft.com/office/word/2010/wordml"
+    xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main"
+    xmlns:wne="http://schemas.microsoft.com/office/word/2006/wordml"
+    xmlns:wp14="http://schemas.microsoft.com/office/word/2010/wordprocessingDrawing"
+    xmlns:wp="http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing"
+    xmlns:wpc="http://schemas.microsoft.com/office/word/2010/wordprocessingCanvas"
+    xmlns:wpg="http://schemas.microsoft.com/office/word/2010/wordprocessingGroup"
+    xmlns:wpi="http://schemas.microsoft.com/office/word/2010/wordprocessingInk"
+    xmlns:wps="http://schemas.microsoft.com/office/word/2010/wordprocessingShape"
+    mc:Ignorable="w14 wp14"
+    >
+  <w:p>
+    <w:pPr>
+      <w:pStyle w:val="Header"/>
+    </w:pPr>
+  </w:p>
+</w:hdr>

features/hdr-header-footer.feature

@@ -14,7 +14,6 @@ Feature: Header and footer behaviors
       | with no    | True  |
 
 
-  @wip
   Scenario Outline: _Header.is_linked_to_previous setter
     Given a _Header object <with-or-no> header definition as header
      When I assign <value> to header.is_linked_to_previous

tests/parts/test_hdrftr.py

@@ -33,6 +33,15 @@ def it_can_create_a_new_header_part(
             header_part, "/word/header42.xml", CT.WML_HEADER, hdr, package_
         )
 
+    def it_loads_default_header_XML_from_a_template_to_help(self):
+        # ---tests integration with OS---
+        xml_bytes = HeaderPart._default_header_xml()
+
+        assert xml_bytes.startswith(
+            b"<?xml version='1.0' encoding='UTF-8' standalone='yes'?>\n<w:hdr\n"
+        )
+        assert len(xml_bytes) == 1395
+
     # fixture components ---------------------------------------------
 
     @pytest.fixture