acpt: add scenarios for Document.settings

Steve Canny · Steve Canny · commit 4f0c32289726 · 2015-03-15T22:49:27.000-07:00
diff --git a/docx/settings.py b/docx/settings.py
@@ -0,0 +1,20 @@
+# encoding: utf-8
+
+"""
+Settings object, providing access to document-level settings.
+"""
+
+from __future__ import (
+    absolute_import, division, print_function, unicode_literals
+)
+
+from .shared import ElementProxy
+
+
+class Settings(ElementProxy):
+    """
+    Provides access to document-level settings for a document. Accessed using
+    the :attr:`.Document.settings` property.
+    """
+
+    __slots__ = ()
diff --git a/features/doc-settings.feature b/features/doc-settings.feature
@@ -0,0 +1,15 @@
+Feature: Access to document settings
+  In order to operate on document-level settings
+  As a developer using python-docx
+  I access to settings stored in the settings part
+
+
+  @wip
+  Scenario Outline: Access document settings
+    Given a document having <a-or-no> settings part
+     Then document.settings is a Settings object
+
+    Examples: having a settings part or not
+      | a-or-no   |
+      | a         |
+      | no        |
diff --git a/features/doc-styles.feature b/features/doc-styles.feature
@@ -15,5 +15,3 @@ Feature: Access a document style
       | styles-state   | style-count |
       | a styles part  |      6      |
       | no styles part |      4      |
-
-
diff --git a/features/steps/settings.py b/features/steps/settings.py
@@ -0,0 +1,36 @@
+# encoding: utf-8
+
+"""
+Step implementations for document settings-related features
+"""
+
+from __future__ import (
+    absolute_import, division, print_function, unicode_literals
+)
+
+from behave import given, then
+
+from docx import Document
+from docx.settings import Settings
+
+from helpers import test_docx
+
+
+# given ====================================================
+
+@given('a document having a settings part')
+def given_a_document_having_a_settings_part(context):
+    context.document = Document(test_docx('doc-word-default-blank'))
+
+
+@given('a document having no settings part')
+def given_a_document_having_no_settings_part(context):
+    context.document = Document(test_docx('set-no-settings-part'))
+
+
+# then =====================================================
+
+@then('document.settings is a Settings object')
+def then_document_settings_is_a_Settings_object(context):
+    document = context.document
+    assert type(document.settings) is Settings
diff --git a/features/steps/test_files/set-no-settings-part.docx b/features/steps/test_files/set-no-settings-part.docx
