doc: add Document.core_properties

Steve Canny · Steve Canny · commit e08d95cded72 · 2015-02-14T23:15:10.000-08:00
diff --git a/docx/document.py b/docx/document.py
@@ -98,6 +98,14 @@ def add_table(self, rows, cols, style='Light Shading Accent 1'):
         table.style = style
         return table
 
+    @property
+    def core_properties(self):
+        """
+        A |CoreProperties| object providing read/write access to the core
+        properties of this document.
+        """
+        return self._part.core_properties
+
     @property
     def part(self):
         """
diff --git a/docx/parts/document.py b/docx/parts/document.py
@@ -31,6 +31,14 @@ def body(self):
         """
         return _Body(self._element.body, self)
 
+    @property
+    def core_properties(self):
+        """
+        A |CoreProperties| object providing read/write access to the core
+        properties of this document.
+        """
+        raise NotImplementedError
+
     @property
     def document(self):
         """
diff --git a/tests/test_document.py b/tests/test_document.py
@@ -13,6 +13,7 @@
 from docx.document import _Body, Document
 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.shape import InlineShape
 from docx.table import Table
@@ -78,6 +79,11 @@ def it_can_add_a_table(self, add_table_fixture):
         assert table == table_
         assert table.style == style
 
+    def it_provides_access_to_its_core_properties(self, core_props_fixture):
+        document, core_properties_ = core_props_fixture
+        core_properties = document.core_properties
+        assert core_properties is core_properties_
+
     def it_provides_access_to_the_document_part(self, part_fixture):
         document, part_ = part_fixture
         assert document.part is part_
@@ -162,6 +168,12 @@ def body_fixture(self, _Body_, body_):
         document = Document(document_elm, None)
         return document, body_elm, _Body_, body_
 
+    @pytest.fixture
+    def core_props_fixture(self, document_part_, core_properties_):
+        document = Document(None, document_part_)
+        document_part_.core_properties = core_properties_
+        return document, core_properties_
+
     @pytest.fixture
     def part_fixture(self, document_part_):
         document = Document(None, document_part_)
@@ -185,6 +197,10 @@ def body_(self, request):
     def body_prop_(self, request, body_):
         return property_mock(request, Document, '_body', return_value=body_)
 
+    @pytest.fixture
+    def core_properties_(self, request):
+        return instance_mock(request, CoreProperties)
+
     @pytest.fixture
     def document_part_(self, request):
         return instance_mock(request, DocumentPart)
