parts: add _Document.blob

Steve Canny · Steve Canny · commit 759e7c466be8 · 2013-12-20T20:10:44.000-08:00
diff --git a/docx/parts.py b/docx/parts.py
@@ -13,7 +13,7 @@
 
 from opc import Part
 
-from docx.oxml.base import oxml_fromstring
+from docx.oxml.base import oxml_fromstring, oxml_tostring
 from docx.text import Paragraph
 
 
@@ -25,6 +25,11 @@ def __init__(self, partname, content_type, document_elm):
         super(_Document, self).__init__(partname, content_type)
         self._element = document_elm
 
+    @property
+    def blob(self):
+        return oxml_tostring(self._element, encoding='UTF-8',
+                             pretty_print=False, standalone=True)
+
     @property
     def body(self):
         """
diff --git a/tests/test_parts.py b/tests/test_parts.py
@@ -33,6 +33,10 @@ def init(self, request):
     def oxml_fromstring_(self, request):
         return function_mock('docx.parts.oxml_fromstring', request)
 
+    @pytest.fixture
+    def oxml_tostring(self, request):
+        return function_mock('docx.parts.oxml_tostring', request)
+
     def it_can_be_constructed_by_opc_part_factory(
             self, oxml_fromstring_, init):
         # mockery ----------------------
@@ -58,6 +62,17 @@ def it_has_a_body(self, init, _Body_):
         _Body_.assert_called_once_with(doc._element.body)
         assert body is _Body_.return_value
 
+    def it_can_serialize_to_xml(self, init, oxml_tostring):
+        # mockery ----------------------
+        doc = _Document(None, None, None)
+        doc._element = Mock(name='_element')
+        # exercise ---------------------
+        doc.blob
+        # verify -----------------------
+        oxml_tostring.assert_called_once_with(
+            doc._element, encoding='UTF-8', pretty_print=False,
+            standalone=True)
+
 
 class Describe_Body(object):
 
