acpt: add act-section-props.feature

Steve Canny · Steve Canny · commit f5e4d3ee450d · 2014-06-20T00:39:24.000-07:00
diff --git a/docs/dev/analysis/features/sections.rst b/docs/dev/analysis/features/sections.rst
@@ -38,7 +38,7 @@ working with sections::
 
     >>> sections = document.sections
     >>> sections
-    <docx.section.Sections object at 0x1deadbeef>
+    <docx.parts.document.Sections object at 0x1deadbeef>
     >>> len(sections)
     3
     >>> section = sections[-1]  # the sentinel section
@@ -119,27 +119,6 @@ LANDSCAPE (1)
 PORTRAIT (0)
     Portrait orientation.
 
-::
-
-    @alias(WD_SECTION)
-    class WD_SECTION_START(Enumeration):
-
-CONTINUOUS (0)
-    Continuous section break.
-
-EVENPAGE (3)
-    Even pages section break.
-
-NEWCOLUMN (1)
-    New column section break.
-
-NEWPAGE (2)
-    New page section break.
-
-ODDPAGE (4)
-    Odd pages section break.
-
-
 
 Specimen XML
 ------------
diff --git a/docx/enum/section.py b/docx/enum/section.py
@@ -0,0 +1,38 @@
+# encoding: utf-8
+
+"""
+Enumerations related to the main document in WordprocessingML files
+"""
+
+from __future__ import absolute_import, print_function, unicode_literals
+
+from .base import alias, XmlEnumeration, XmlMappedEnumMember
+
+
+@alias('WD_SECTION')
+class WD_SECTION_START(XmlEnumeration):
+    """
+    Specifies the start type of a section break.
+    """
+
+    __ms_name__ = 'WdSectionStart'
+
+    __url__ = 'http://msdn.microsoft.com/en-us/library/office/ff840975.aspx'
+
+    __members__ = (
+        XmlMappedEnumMember(
+            'CONTINUOUS', 0, 'continuous', 'Continuous section break.'
+        ),
+        XmlMappedEnumMember(
+            'NEW_COLUMN', 1, 'nextColumn', 'New column section break.'
+        ),
+        XmlMappedEnumMember(
+            'NEW_PAGE', 2, 'nextPage', 'New page section break.'
+        ),
+        XmlMappedEnumMember(
+            'EVEN_PAGE', 3, 'evenPage', 'Even pages section break.'
+        ),
+        XmlMappedEnumMember(
+            'ODD_PAGE', 4, 'oddPage', 'Section begins on next odd page.'
+        ),
+    )
diff --git a/features/sct-section-props.feature b/features/sct-section-props.feature
@@ -0,0 +1,18 @@
+Feature: Access and change section properties
+  In order to discover and modify document section behaviors
+  As a developer using python-docx
+  I need a way to get and set the properties of a section
+
+
+  @wip
+  Scenario Outline: Get section start type
+    Given a section having start type <start-type>
+     Then the reported section start type is <start-type>
+
+    Examples: Section start types
+      | start-type |
+      | CONTINUOUS |
+      | NEW_COLUMN |
+      | NEW_PAGE   |
+      | EVEN_PAGE  |
+      | ODD_PAGE   |
diff --git a/features/steps/section.py b/features/steps/section.py
@@ -0,0 +1,43 @@
+# encoding: utf-8
+
+"""
+Step implementations for section-related features
+"""
+
+from __future__ import absolute_import, print_function, unicode_literals
+
+from behave import given, then
+
+from docx import Document
+from docx.enum.section import WD_SECTION
+
+from helpers import test_docx
+
+
+# given ====================================================
+
+@given('a section having start type {start_type}')
+def given_a_section_having_start_type(context, start_type):
+    section_idx = {
+        'CONTINUOUS': 0,
+        'NEW_PAGE':   1,
+        'ODD_PAGE':   2,
+        'EVEN_PAGE':  3,
+        'NEW_COLUMN': 4,
+    }[start_type]
+    document = Document(test_docx('sct-section-props'))
+    context.section = document.sections[section_idx]
+
+
+# then =====================================================
+
+@then('the reported section start type is {start_type}')
+def then_the_reported_section_start_type_is_type(context, start_type):
+    expected_start_type = {
+        'CONTINUOUS': WD_SECTION.CONTINUOUS,
+        'EVEN_PAGE':  WD_SECTION.EVEN_PAGE,
+        'NEW_COLUMN': WD_SECTION.NEW_COLUMN,
+        'NEW_PAGE':   WD_SECTION.NEW_PAGE,
+        'ODD_PAGE':   WD_SECTION.ODD_PAGE,
+    }[start_type]
+    assert context.section.start_type == expected_start_type
diff --git a/features/steps/test_files/sct-section-props.docx b/features/steps/test_files/sct-section-props.docx
