doc: add Document.settings

Steve Canny · Steve Canny · commit 3805d702566c · 2015-03-15T22:49:27.000-07:00
diff --git a/docx/document.py b/docx/document.py
@@ -149,6 +149,14 @@ def sections(self):
         """
         return Sections(self._element)
 
+    @property
+    def settings(self):
+        """
+        A |Settings| object providing access to the document-level settings
+        for this document.
+        """
+        return self._part.settings
+
     @property
     def styles(self):
         """
diff --git a/docx/parts/document.py b/docx/parts/document.py
@@ -127,6 +127,14 @@ def save(self, path_or_stream):
         """
         self.package.save(path_or_stream)
 
+    @property
+    def settings(self):
+        """
+        A |Settings| object providing access to the settings in the settings
+        part of this document.
+        """
+        raise NotImplementedError
+
     @property
     def styles(self):
         """
diff --git a/tests/test_document.py b/tests/test_document.py
@@ -16,6 +16,7 @@
 from docx.opc.coreprops import CoreProperties
 from docx.parts.document import DocumentPart
 from docx.section import Section, Sections
+from docx.settings import Settings
 from docx.shape import InlineShape, InlineShapes
 from docx.shared import Length
 from docx.styles.styles import Styles
@@ -107,6 +108,10 @@ def it_provides_access_to_its_sections(self, sections_fixture):
         Sections_.assert_called_once_with(document._element)
         assert sections is sections_
 
+    def it_provides_access_to_its_settings(self, settings_fixture):
+        document, settings_ = settings_fixture
+        assert document.settings is settings_
+
     def it_provides_access_to_its_styles(self, styles_fixture):
         document, styles_ = styles_fixture
         assert document.styles is styles_
@@ -253,6 +258,12 @@ def sections_fixture(self, Sections_, sections_):
         Sections_.return_value = sections_
         return document, Sections_, sections_
 
+    @pytest.fixture
+    def settings_fixture(self, document_part_, settings_):
+        document = Document(None, document_part_)
+        document_part_.settings = settings_
+        return document, settings_
+
     @pytest.fixture
     def styles_fixture(self, document_part_, styles_):
         document = Document(None, document_part_)
@@ -335,6 +346,10 @@ def sections_(self, request):
     def sections_prop_(self, request):
         return property_mock(request, Document, 'sections')
 
+    @pytest.fixture
+    def settings_(self, request):
+        return instance_mock(request, Settings)
+
     @pytest.fixture
     def styles_(self, request):
         return instance_mock(request, Styles)
