acpt: add scenario for default header access

eupharis · Steve Canny · commit bbbc287372fc · 2016-04-20T21:59:56.000-07:00
diff --git a/docx/header.py b/docx/header.py
@@ -0,0 +1,19 @@
+# encoding: utf-8
+
+"""
+Page headers and footers.
+"""
+
+from __future__ import (
+    absolute_import, division, print_function, unicode_literals
+)
+
+from .shared import ElementProxy
+
+
+class Header(ElementProxy):
+    """
+    The default page header of a section.
+    """
+
+    __slots__ = ()
diff --git a/features/sct-access-header.feature b/features/sct-access-header.feature
@@ -0,0 +1,9 @@
+Feature: Access section headers and footers
+  In order to operate on the headers or footers of a section
+  As a developer using python-docx
+  I need access to the section headers and footers
+
+  @wip
+  Scenario: Access default header of section
+    Given a section
+     Then section.header is a Header object
diff --git a/features/steps/section.py b/features/steps/section.py
@@ -10,6 +10,7 @@
 
 from docx import Document
 from docx.enum.section import WD_ORIENT, WD_SECTION
+from docx.header import Header
 from docx.section import Section
 from docx.shared import Inches
 
@@ -18,6 +19,12 @@
 
 # given ====================================================
 
+@given('a section')
+def given_a_section(context):
+    document = Document(test_docx('sct-section-props'))
+    context.section = document.sections[0]
+
+
 @given('a section collection containing 3 sections')
 def given_a_section_collection_containing_3_sections(context):
     document = Document(test_docx('doc-access-sections'))
@@ -137,6 +144,12 @@ def then_len_sections_is_3(context):
     )
 
 
+@then('section.header is a Header object')
+def then_section_header_is_a_Header_object(context):
+    section = context.section
+    assert isinstance(section.header, Header)
+
+
 @then('the reported {margin_side} margin is {inches} inches')
 def then_the_reported_margin_is_inches(context, margin_side, inches):
     prop_name = {
