doc: add Document.inline_shapes

Steve Canny · Steve Canny · commit 026db1b24567 · 2015-02-15T00:18:53.000-08:00
diff --git a/docx/document.py b/docx/document.py
@@ -106,6 +106,16 @@ def core_properties(self):
         """
         return self._part.core_properties
 
+    @property
+    def inline_shapes(self):
+        """
+        An |InlineShapes| object providing access to the inline shapes in
+        this document. An inline shape is a graphical object, such as
+        a picture, contained in a run of text and behaving like a character
+        glyph, being flowed like other text in a paragraph.
+        """
+        return self._part.inline_shapes
+
     @property
     def part(self):
         """
diff --git a/tests/test_document.py b/tests/test_document.py
@@ -14,7 +14,7 @@
 from docx.enum.section import WD_SECTION
 from docx.enum.text import WD_BREAK
 from docx.opc.coreprops import CoreProperties
-from docx.parts.document import DocumentPart
+from docx.parts.document import DocumentPart, InlineShapes
 from docx.shape import InlineShape
 from docx.table import Table
 from docx.text.paragraph import Paragraph
@@ -84,6 +84,11 @@ def it_provides_access_to_its_core_properties(self, core_props_fixture):
         core_properties = document.core_properties
         assert core_properties is core_properties_
 
+    def it_provides_access_to_its_inline_shapes(self, inline_shapes_fixture):
+        document, inline_shapes_ = inline_shapes_fixture
+        inline_shapes = document.inline_shapes
+        assert inline_shapes is inline_shapes_
+
     def it_provides_access_to_the_document_part(self, part_fixture):
         document, part_ = part_fixture
         assert document.part is part_
@@ -174,6 +179,12 @@ def core_props_fixture(self, document_part_, core_properties_):
         document_part_.core_properties = core_properties_
         return document, core_properties_
 
+    @pytest.fixture
+    def inline_shapes_fixture(self, document_part_, inline_shapes_):
+        document = Document(None, document_part_)
+        document_part_.inline_shapes = inline_shapes_
+        return document, inline_shapes_
+
     @pytest.fixture
     def part_fixture(self, document_part_):
         document = Document(None, document_part_)
@@ -205,6 +216,10 @@ def core_properties_(self, request):
     def document_part_(self, request):
         return instance_mock(request, DocumentPart)
 
+    @pytest.fixture
+    def inline_shapes_(self, request):
+        return instance_mock(request, InlineShapes)
+
     @pytest.fixture
     def paragraph_(self, request):
         return instance_mock(request, Paragraph)
