fix: #1256 republish parse_xml() at docx.oxml

scanny · scanny · commit 129dd83f4aef · 2023-10-11T09:41:01.000-07:00
Multiple downstream "extension" packages expect to find `OxmlElement`
and `parse_xml()` at `docx.oxml`. Refactoring in v1.0.0 moved those to
`docx.oxml.parser`, but republishing them at `docx.oxml` does not cause
any immediate breakage.

Republish those two callables at `docx.oxml` for v1.0.1.
diff --git a/src/docx/oxml/__init__.py b/src/docx/oxml/__init__.py
@@ -6,7 +6,7 @@
 from __future__ import annotations
 
 from docx.oxml.drawing import CT_Drawing
-from docx.oxml.parser import register_element_cls
+from docx.oxml.parser import OxmlElement, parse_xml, register_element_cls
 from docx.oxml.shape import (
     CT_Anchor,
     CT_Blip,
@@ -34,6 +34,11 @@
     CT_Text,
 )
 
+# -- `OxmlElement` and `parse_xml()` are not used in this module but several downstream
+# -- "extension" packages expect to find them here and there's no compelling reason
+# -- not to republish them here so those keep working.
+__all__ = ["OxmlElement", "parse_xml"]
+
 # ---------------------------------------------------------------------------
 # DrawingML-related elements
 
