Return result from read_document_xml_element

1 files changed, 22 insertions, 13 deletions

diff --git a/tests/docx/document_xml_tests.py b/tests/docx/document_xml_tests.py
index 5f64e2b..232bb34 100644
--- a/tests/docx/document_xml_tests.py
+++ b/tests/docx/document_xml_tests.py
@@ -11,14 +11,14 @@ class ReadXmlElementTests(object):
     @istest
     def text_from_text_element_is_read(self):
         element = _text_element("Hello!")
-        assert_equal(documents.Text("Hello!"), read_document_xml_element(element))
+        assert_equal(documents.Text("Hello!"), _read_and_get_document_xml_element(element))
     
     @istest
     def can_read_text_within_run(self):
         element = _run_element_with_text("Hello!")
         assert_equal(
             documents.run([documents.Text("Hello!")]),
-            read_document_xml_element(element)
+            _read_and_get_document_xml_element(element)
         )
     
     @istest
@@ -26,7 +26,7 @@ class ReadXmlElementTests(object):
         element = _paragraph_element_with_text("Hello!")
         assert_equal(
             documents.paragraph([documents.run([documents.Text("Hello!")])]),
-            read_document_xml_element(element)
+            _read_and_get_document_xml_element(element)
         )
     
     @istest
@@ -34,26 +34,26 @@ class ReadXmlElementTests(object):
         element = _document_element_with_text("Hello!")
         assert_equal(
             documents.Document([documents.paragraph([documents.run([documents.Text("Hello!")])])]),
-            read_document_xml_element(element)
+            _read_and_get_document_xml_element(element)
         )
         
     @istest
     def paragraph_has_no_style_if_it_has_no_properties(self):
         element = xml_element("w:p")
-        assert_equal(None, read_document_xml_element(element).style_name)
+        assert_equal(None, _read_and_get_document_xml_element(element).style_name)
         
     @istest
     def paragraph_has_style_name_read_from_paragraph_properties_if_present(self):
         style_xml = xml_element("w:pStyle", {"w:val": "Heading1"})
         properties_xml = xml_element("w:pPr", {}, [style_xml])
         paragraph_xml = xml_element("w:p", {}, [properties_xml])
-        paragraph = read_document_xml_element(paragraph_xml)
+        paragraph = _read_and_get_document_xml_element(paragraph_xml)
         assert_equal("Heading1", paragraph.style_name)
         
     @istest
     def paragraph_has_no_numbering_if_it_has_no_numbering_properties(self):
         element = xml_element("w:p")
-        assert_equal(None, read_document_xml_element(element).numbering)
+        assert_equal(None, _read_and_get_document_xml_element(element).numbering)
         
     @istest
     def paragraph_has_numbering_properties_from_paragraph_properties_if_present(self):
@@ -65,7 +65,7 @@ class ReadXmlElementTests(object):
         paragraph_xml = xml_element("w:p", {}, [properties_xml])
         
         numbering = Numbering({"42": {"1": NumberingLevel("1", True)}})
-        paragraph = read_document_xml_element(paragraph_xml, numbering=numbering)
+        paragraph = _read_and_get_document_xml_element(paragraph_xml, numbering=numbering)
         
         assert_equal("1", paragraph.numbering.level_index)
         assert_equal(True, paragraph.numbering.is_ordered)
@@ -73,7 +73,7 @@ class ReadXmlElementTests(object):
     @istest
     def run_has_no_style_if_it_has_no_properties(self):
         element = xml_element("w:r")
-        assert_equal(None, read_document_xml_element(element).style_name)
+        assert_equal(None, _read_and_get_document_xml_element(element).style_name)
         
     @istest
     def run_has_style_name_read_from_run_properties_if_present(self):
@@ -104,28 +104,37 @@ class ReadXmlElementTests(object):
     def _read_run_with_properties(self, properties):
         properties_xml = xml_element("w:rPr", {}, properties)
         run_xml = xml_element("w:r", {}, [properties_xml])
-        return read_document_xml_element(run_xml)
+        return _read_and_get_document_xml_element(run_xml)
 
 
     @istest
     def can_read_tab_element(self):
         element = xml_element("w:tab")
-        tab = read_document_xml_element(element)
+        tab = _read_and_get_document_xml_element(element)
         assert_equal(documents.tab(), tab)
     
     @istest
+    def ignored_elements_are_ignored_without_message(self):
+        element = xml_element("w:bookmarkStart")
+        result = read_document_xml_element(element)
+        assert_equal([], result.messages)
+    
+    @istest
     def unrecognised_elements_are_ignored(self):
         element = xml_element("w:huh", {}, [])
-        assert_equal(None, read_document_xml_element(element))
+        assert_equal(None, _read_and_get_document_xml_element(element))
     
     @istest
     def unrecognised_children_are_ignored(self):
         element = xml_element("w:r", {}, [_text_element("Hello!"), xml_element("w:huh", {}, [])])
         assert_equal(
             documents.run([documents.Text("Hello!")]),
-            read_document_xml_element(element)
+            _read_and_get_document_xml_element(element)
         )
 
+def _read_and_get_document_xml_element(*args, **kwargs):
+    return read_document_xml_element(*args, **kwargs).value
+
 
 def _document_element_with_text(text):
     return xml_element("w:document", {}, [