style: add Document.styles

Steve Canny · Steve Canny · commit ea2f8b40d9cd · 2014-12-27T22:51:55.000-08:00
diff --git a/docx/api.py b/docx/api.py
@@ -159,6 +159,13 @@ def sections(self):
         """
         return self._document_part.sections
 
+    @property
+    def styles(self):
+        """
+        A |Styles| object providing access to the styles for this document.
+        """
+        return self._document_part.styles
+
     @lazyproperty
     def styles_part(self):
         """
diff --git a/docx/parts/document.py b/docx/parts/document.py
@@ -102,6 +102,14 @@ def sections(self):
         """
         return Sections(self._element)
 
+    @property
+    def styles(self):
+        """
+        A |Styles| object providing access to the styles in the styles part
+        of this document.
+        """
+        raise NotImplementedError
+
     @property
     def tables(self):
         """
diff --git a/tests/test_api.py b/tests/test_api.py
@@ -20,6 +20,7 @@
 from docx.parts.styles import StylesPart
 from docx.section import Section
 from docx.shape import InlineShape
+from docx.styles.styles import Styles
 from docx.table import Table
 from docx.text.paragraph import Paragraph
 from docx.text.run import Run
@@ -138,6 +139,11 @@ def it_provides_access_to_the_core_properties(self, core_props_fixture):
         core_properties = document.core_properties
         assert core_properties is core_properties_
 
+    def it_provides_access_to_its_styles(self, styles_fixture):
+        document, styles_ = styles_fixture
+        styles = document.styles
+        assert styles is styles_
+
     def it_provides_access_to_the_numbering_part(self, num_part_get_fixture):
         document, document_part_, numbering_part_ = num_part_get_fixture
         numbering_part = document.numbering_part
@@ -249,6 +255,11 @@ def save_fixture(self, request, open_, package_):
         document = Document()
         return document, package_, file_
 
+    @pytest.fixture
+    def styles_fixture(self, document, styles_):
+        document._document_part.styles = styles_
+        return document, styles_
+
     @pytest.fixture
     def tables_fixture(self, document, tables_):
         return document, tables_
@@ -362,6 +373,10 @@ def section_(self, request):
     def start_type_(self, request):
         return instance_mock(request, int)
 
+    @pytest.fixture
+    def styles_(self, request):
+        return instance_mock(request, Styles)
+
     @pytest.fixture
     def StylesPart_(self, request, styles_part_):
         StylesPart_ = class_mock(request, 'docx.api.StylesPart')
