python-docx-oss 0.1.1__py3-none-any.whl → 0.3.0__py3-none-any.whl

docx/__init__.py

@@ -13,7 +13,7 @@ from docx.api import Document
 if TYPE_CHECKING:
     from docx.opc.part import Part
 
-__version__ = "0.1.1"
+__version__ = "0.3.0"
 
 
 __all__ = ["Document"]

docx/api.py

@@ -5,6 +5,7 @@ Provides a syntactically more convenient API for interacting with the OpcPackage
 
 from __future__ import annotations
 
+import io
 import os
 from typing import IO, TYPE_CHECKING, cast
 
@@ -16,18 +17,20 @@ if TYPE_CHECKING:
     from docx.parts.document import DocumentPart
 
 
-def Document(docx: str | IO[bytes] | None = None) -> DocumentObject:
+def Document(docx: str | bytes | IO[bytes] | None = None) -> DocumentObject:
     """Return a |Document| object loaded from `docx`, where `docx` can be either a path
-    to a ``.docx`` file (a string) or a file-like object.
+    to a ``.docx`` file, raw DOCX bytes, or a binary file-like object.
 
     If `docx` is missing or ``None``, the built-in default document "template" is
     loaded.
     """
     docx = _default_docx_path() if docx is None else docx
+    source_name = "<bytes>" if isinstance(docx, bytes) else docx
+    docx = io.BytesIO(docx) if isinstance(docx, bytes) else docx
     document_part = cast("DocumentPart", Package.open(docx).main_document_part)
     if document_part.content_type != CT.WML_DOCUMENT_MAIN:
         tmpl = "file '%s' is not a Word file, content type is '%s'"
-        raise ValueError(tmpl % (docx, document_part.content_type))
+        raise ValueError(tmpl % (source_name, document_part.content_type))
     return document_part.document
 
 

docx/document.py

@@ -5,11 +5,14 @@
 
 from __future__ import annotations
 
+import io
 from typing import IO, TYPE_CHECKING, Iterator, List, Sequence
 
+from docx.api import Document as open_document
 from docx.blkcntnr import BlockItemContainer
 from docx.enum.section import WD_SECTION
 from docx.enum.text import WD_BREAK
+from docx.sanitize import SanitizationReport, sanitize_document
 from docx.section import Section, Sections
 from docx.shared import ElementProxy, Emu, Inches, Length
 from docx.text.run import Run
@@ -182,6 +185,10 @@ class Document(ElementProxy):
         """A |CoreProperties| object providing Dublin Core properties of document."""
         return self._part.core_properties
 
+    def copy(self) -> Document:
+        """Return an independent in-memory snapshot of this document."""
+        return open_document(io.BytesIO(self.to_bytes()))
+
     @property
     def custom_properties(self) -> CustomProperties:
         """A |CustomProperties| object providing custom properties of document."""
@@ -223,6 +230,27 @@ class Document(ElementProxy):
         """
         self._part.save(path_or_stream)
 
+    def sanitize(
+        self,
+        *,
+        personal_metadata: bool = False,
+        comments: bool = False,
+        web_extensions: bool = False,
+        formatting_revisions: bool = False,
+    ) -> SanitizationReport:
+        """Apply the explicitly selected package-level cleanup operations.
+
+        Every option defaults to |False| because sanitization is destructive. The
+        returned report describes all package and XML changes made to this document.
+        """
+        return sanitize_document(
+            self,
+            personal_metadata=personal_metadata,
+            comments=comments,
+            web_extensions=web_extensions,
+            formatting_revisions=formatting_revisions,
+        )
+
     @property
     def sections(self) -> Sections:
         """|Sections| object providing access to each section in this document."""
@@ -249,6 +277,12 @@ class Document(ElementProxy):
         """
         return self._body.tables
 
+    def to_bytes(self) -> bytes:
+        """Serialize this document as a complete in-memory DOCX package."""
+        with io.BytesIO() as stream:
+            self.save(stream)
+            return stream.getvalue()
+
     @property
     def _block_width(self) -> Length:
         """A |Length| object specifying the space between margins in last section."""

docx/image/constants.py

@@ -101,6 +101,7 @@ class MIME_TYPE:
     """Image content types."""
 
     BMP = "image/bmp"
+    EMF = "image/x-emf"
     GIF = "image/gif"
     JPEG = "image/jpeg"
     PNG = "image/png"

docx/image/emf.py

@@ -13,7 +13,7 @@ class Emf(BaseImageHeader):
     @property
     def content_type(self):
         """
-        MIME content type for this image, unconditionally `image/emf` for
+        MIME content type for this image, unconditionally `image/x-emf` for
         EMF images.
         """
         return MIME_TYPE.EMF
@@ -38,7 +38,6 @@ class Emf(BaseImageHeader):
         y1 = stream_rdr.read_long(20)
 
         frame = tuple(map(stream_rdr.read_long, (24, 28, 32, 36)))
-        size = x1 - x0, y1 - y0
 
         xdpi = 2540.0 * (x1 - x0) / (frame[2] - frame[0])
         ydpi = 2540.0 * (y1 - y0) / (frame[3] - frame[1])

docx/opc/coreprops.py

@@ -9,6 +9,7 @@ import datetime as dt
 from typing import TYPE_CHECKING
 
 from docx.oxml.coreprops import CT_CoreProperties
+from docx.oxml.ns import qn
 
 if TYPE_CHECKING:
     from docx.oxml.coreprops import CT_CoreProperties
@@ -21,6 +22,40 @@ class CoreProperties:
     def __init__(self, element: CT_CoreProperties):
         self._element = element
 
+    def deduplicate(self, *property_names: str) -> set[str]:
+        """Remove duplicate XML elements for the named core properties.
+
+        The first occurrence is retained so callers can subsequently normalize its
+        value through the regular property setter.
+        """
+        element_tags = {
+            "author": qn("dc:creator"),
+            "category": qn("cp:category"),
+            "comments": qn("dc:description"),
+            "content_status": qn("cp:contentStatus"),
+            "created": qn("dcterms:created"),
+            "identifier": qn("dc:identifier"),
+            "keywords": qn("cp:keywords"),
+            "language": qn("dc:language"),
+            "last_modified_by": qn("cp:lastModifiedBy"),
+            "last_printed": qn("cp:lastPrinted"),
+            "modified": qn("dcterms:modified"),
+            "revision": qn("cp:revision"),
+            "subject": qn("dc:subject"),
+            "title": qn("dc:title"),
+            "version": qn("cp:version"),
+        }
+        changed: set[str] = set()
+        for property_name in property_names:
+            try:
+                tag = element_tags[property_name]
+            except KeyError as exc:
+                raise ValueError(f"Unsupported core property: {property_name}") from exc
+            for duplicate in self._element.findall(tag)[1:]:
+                self._element.remove(duplicate)
+                changed.add(property_name)
+        return changed
+
     @property
     def author(self):
         return self._element.author_text

docx/opc/part.py

@@ -144,6 +144,10 @@ class Part:
             rel = self.rels.get_or_add(reltype, cast(Part, target))
             return rel.rId
 
+    def replace_blob(self, blob: bytes) -> None:
+        """Replace the serialized payload of this non-XML part."""
+        self._blob = blob
+
     @property
     def related_parts(self):
         """Dictionary mapping related parts by rId, so child objects can resolve
@@ -235,6 +239,10 @@ class XmlPart(Part):
         """The root XML element of this XML part."""
         return self._element
 
+    def replace_blob(self, blob: bytes) -> None:
+        """Reject raw replacement because this part serializes from ``element``."""
+        raise TypeError("cannot replace the blob of an XmlPart; replace its element instead")
+
     @element.setter
     def element(self, e: BaseOxmlElement):
         self._element = e

docx/opc/rel.py

@@ -28,6 +28,11 @@ class Relationships(Dict[str, "_Relationship"]):
             self._target_parts_by_rId[rId] = target
         return rel
 
+    def __delitem__(self, rId: str) -> None:
+        """Remove the relationship and its cached target-part reference."""
+        super().__delitem__(rId)
+        self._target_parts_by_rId.pop(rId, None)
+
     def get_or_add(self, reltype: str, target_part: Part) -> _Relationship:
         """Return relationship of `reltype` to `target_part`, newly added if not already
         present in collection."""

docx/parts/customxml.py

@@ -59,7 +59,7 @@ class CustomXmlPart(XmlPart):
         """
         return self.element.getchildren()
 
-    def add_item(self, tag: str, text: str = "", **attrib):
+    def add_item(self, tag: str, text: str = "", **attrib: str) -> None:
         """
         Add a child element to root.
         """

docx/parts/document.py

@@ -54,6 +54,24 @@ class DocumentPart(StoryPart):
         rId = self.relate_to(header_part, RT.HEADER)
         return header_part, rId
 
+    def delete_custom_xml_part(self, part: CustomXmlPart) -> None:
+        """Delete a Custom XML part related to this document.
+
+        Related Custom XML property parts are detached with the part and omitted from
+        the package when it is next saved.
+        """
+        matching_rIds = [
+            rId
+            for rId, rel in self.rels.items()
+            if rel.reltype == RT.CUSTOM_XML and not rel.is_external and rel.target_part is part
+        ]
+        if not matching_rIds:
+            raise ValueError(f"part '{part.partname}' is not related to this document")
+
+        part.drop_rels(lambda rel: rel.reltype == RT.CUSTOM_XML_PROPS)
+        for rId in matching_rIds:
+            del self.rels[rId]
+
     @property
     def comments(self) -> Comments:
         """|Comments| object providing access to the comments added to this document."""

docx/sanitize/__init__.py

@@ -0,0 +1,10 @@
+"""Package-level DOCX sanitization.
+
+Callers use :meth:`docx.document.Document.sanitize`; this package keeps OPC graph
+mutation and XML cleanup details behind that single method.
+"""
+
+from docx.sanitize.cleaner import sanitize_document
+from docx.sanitize.result import RemovedRelationship, SanitizationReport
+
+__all__ = ["RemovedRelationship", "SanitizationReport", "sanitize_document"]

docx/sanitize/cleaner.py

@@ -0,0 +1,221 @@
+"""Implementation of the package-level sanitization boundary."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Iterator
+
+from lxml import etree
+
+from docx.opc.oxml import serialize_part_xml
+from docx.opc.part import Part, XmlPart
+from docx.oxml.ns import qn
+from docx.oxml.parser import parse_xml
+from docx.sanitize.result import RemovedRelationship, SanitizationReport
+
+if TYPE_CHECKING:
+    from lxml.etree import _Element as etree_Element  # pyright: ignore[reportPrivateUsage]
+
+    from docx.document import Document
+    from docx.opc.package import OpcPackage
+    from docx.oxml.xmlchemy import BaseOxmlElement
+
+
+_COMMENT_MARKER_TAGS = (
+    qn("w:commentRangeStart"),
+    qn("w:commentRangeEnd"),
+    qn("w:commentReference"),
+)
+_COMMENT_RELATIONSHIP_NAMES = frozenset(
+    {
+        "commentauthors",
+        "comments",
+        "commentsextended",
+        "commentsextensible",
+        "commentsids",
+        "people",
+    }
+)
+_FORMATTING_REVISION_TAGS = tuple(
+    qn(tag)
+    for tag in (
+        "w:rPrChange",
+        "w:pPrChange",
+        "w:tblPrChange",
+        "w:trPrChange",
+        "w:tcPrChange",
+        "w:sectPrChange",
+    )
+)
+_WEB_EXTENSION_RELATIONSHIP_NAMES = frozenset({"webextension", "webextensiontaskpanes"})
+
+
+def sanitize_document(
+    document: Document,
+    *,
+    personal_metadata: bool,
+    comments: bool,
+    web_extensions: bool,
+    formatting_revisions: bool,
+) -> SanitizationReport:
+    """Apply selected sanitizers while keeping all graph mechanics internal."""
+    package = document.part.package
+    assert package is not None
+
+    if not any((personal_metadata, comments, web_extensions, formatting_revisions)):
+        return SanitizationReport()
+
+    parts_before = _reachable_part_names(package)
+    scrubbed_properties: list[str] = []
+    removed_relationships: list[RemovedRelationship] = []
+    warnings: list[str] = []
+    removed_comment_markers = 0
+    removed_formatting_revisions = 0
+
+    if personal_metadata:
+        scrubbed_properties.extend(_scrub_personal_metadata(package))
+
+    if comments or formatting_revisions:
+        for part, root in _iter_word_xml(package, warnings):
+            part_changed = False
+            if comments:
+                count = _remove_elements(root, _COMMENT_MARKER_TAGS)
+                removed_comment_markers += count
+                part_changed = part_changed or count > 0
+            if formatting_revisions:
+                count = _remove_elements(root, _FORMATTING_REVISION_TAGS)
+                removed_formatting_revisions += count
+                part_changed = part_changed or count > 0
+            if part_changed and not isinstance(part, XmlPart):
+                part.replace_blob(serialize_part_xml(root))
+
+    if comments:
+        removed_relationships.extend(_drop_relationships(package, _COMMENT_RELATIONSHIP_NAMES))
+    if web_extensions:
+        removed_relationships.extend(
+            _drop_relationships(package, _WEB_EXTENSION_RELATIONSHIP_NAMES)
+        )
+
+    parts_after = _reachable_part_names(package)
+    return SanitizationReport(
+        scrubbed_properties=tuple(scrubbed_properties),
+        removed_comment_markers=removed_comment_markers,
+        removed_formatting_revisions=removed_formatting_revisions,
+        removed_parts=tuple(sorted(parts_before - parts_after)),
+        removed_relationships=tuple(removed_relationships),
+        warnings=tuple(warnings),
+    )
+
+
+def _drop_relationships(
+    package: OpcPackage, relationship_names: frozenset[str]
+) -> list[RemovedRelationship]:
+    removed: list[RemovedRelationship] = []
+    for source_name, source in _relationship_sources(package):
+        for rId, rel in list(source.rels.items()):
+            if _relationship_name(rel.reltype) not in relationship_names:
+                continue
+            target = rel.target_ref if rel.is_external else str(rel.target_part.partname)
+            removed.append(RemovedRelationship(source_name, rId, rel.reltype, target))
+            del source.rels[rId]
+    return removed
+
+
+def _iter_word_xml(
+    package: OpcPackage, warnings: list[str]
+) -> Iterator[tuple[Part, BaseOxmlElement]]:
+    for part in _reachable_parts(package):
+        if not str(part.partname).startswith("/word/"):
+            continue
+        if isinstance(part, XmlPart):
+            yield part, part.element
+            continue
+        if not part.content_type.endswith("+xml") and part.content_type != "application/xml":
+            continue
+        try:
+            yield part, parse_xml(part.blob)
+        except etree.XMLSyntaxError as exc:
+            warnings.append(f"Could not sanitize XML part {part.partname}: {exc}")
+
+
+def _reachable_parts(package: OpcPackage) -> list[Part]:
+    parts: list[Part] = []
+    visited: set[int] = set()
+
+    def walk(source: OpcPackage | Part) -> None:
+        for rel in source.rels.values():
+            if rel.is_external:
+                continue
+            part = rel.target_part
+            identity = id(part)
+            if identity in visited:
+                continue
+            visited.add(identity)
+            parts.append(part)
+            walk(part)
+
+    walk(package)
+    return parts
+
+
+def _reachable_part_names(package: OpcPackage) -> set[str]:
+    return {str(part.partname) for part in _reachable_parts(package)}
+
+
+def _relationship_name(relationship_type: str) -> str:
+    return relationship_type.rstrip("/").rsplit("/", 1)[-1].lower()
+
+
+def _relationship_sources(package: OpcPackage) -> list[tuple[str, OpcPackage | Part]]:
+    return [("/", package), *[(str(part.partname), part) for part in _reachable_parts(package)]]
+
+
+def _remove_elements(root: BaseOxmlElement, tags: tuple[str, ...]) -> int:
+    tag_set = set(tags)
+    elements = [
+        element
+        for tag in tags
+        for element in root.iter(tag)
+        if not any(ancestor.tag in tag_set for ancestor in element.iterancestors())
+    ]
+    for element in elements:
+        parent = element.getparent()
+        if parent is not None:
+            comment_run = _empty_comment_reference_run(element)
+            parent.remove(element)
+            if comment_run is not None:
+                comment_run_parent = comment_run.getparent()
+                if comment_run_parent is not None:
+                    comment_run_parent.remove(comment_run)
+    return len(elements)
+
+
+def _scrub_personal_metadata(package: OpcPackage) -> list[str]:
+    core_properties = package.core_properties
+    changed = core_properties.deduplicate("author", "last_modified_by", "revision")
+    if core_properties.author:
+        changed.add("author")
+    if core_properties.last_modified_by:
+        changed.add("last_modified_by")
+    if core_properties.revision != 1:
+        changed.add("revision")
+    core_properties.author = ""
+    core_properties.last_modified_by = ""
+    core_properties.revision = 1
+    return [name for name in ("author", "last_modified_by", "revision") if name in changed]
+
+
+def _empty_comment_reference_run(element: etree_Element) -> etree_Element | None:
+    if element.tag != qn("w:commentReference"):
+        return None
+    run = element.getparent()
+    if run is None or run.tag != qn("w:r"):
+        return None
+    remaining = [child for child in run if child is not element]
+    if not remaining:
+        return run
+    if len(remaining) != 1 or remaining[0].tag != qn("w:rPr"):
+        return None
+    run_properties = remaining[0]
+    if len(run_properties) != 1 or run_properties[0].tag != qn("w:rStyle"):
+        return None
+    return run if run_properties[0].get(qn("w:val")) == "CommentReference" else None

docx/sanitize/result.py

@@ -0,0 +1,38 @@
+"""Value objects returned by document sanitization."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True)
+class RemovedRelationship:
+    """A package relationship removed during sanitization."""
+
+    source: str
+    relationship_id: str
+    relationship_type: str
+    target: str
+
+
+@dataclass(frozen=True)
+class SanitizationReport:
+    """Immutable summary of changes made by ``Document.sanitize()``."""
+
+    scrubbed_properties: tuple[str, ...] = ()
+    removed_comment_markers: int = 0
+    removed_formatting_revisions: int = 0
+    removed_parts: tuple[str, ...] = ()
+    removed_relationships: tuple[RemovedRelationship, ...] = ()
+    warnings: tuple[str, ...] = ()
+
+    @property
+    def changed(self) -> bool:
+        """Whether the document package was modified."""
+        return bool(
+            self.scrubbed_properties
+            or self.removed_comment_markers
+            or self.removed_formatting_revisions
+            or self.removed_parts
+            or self.removed_relationships
+        )

{python_docx_oss-0.1.1.dist-info → python_docx_oss-0.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-docx-oss
-Version: 0.1.1
+Version: 0.3.0
 Summary: Create, read, and update Microsoft Word .docx files.
 Author: Ethan St Lee
 License-Expression: MIT
@@ -23,7 +23,7 @@ Classifier: Topic :: Software Development :: Libraries
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: lxml>=3.1.0
+Requires-Dist: lxml>=6.1.0
 Requires-Dist: typing_extensions>=4.9.0
 Dynamic: license-file
 
@@ -53,18 +53,20 @@ Use it when an application needs more than basic paragraphs and tables: custom d
 metadata, application-owned XML, vector images, floating pictures, East Asian fonts,
 or low-level package and relationship access.
 
-## Features
-
-| Capability | Support |
-| --- | --- |
-| Documents, paragraphs, runs, tables, styles, sections, headers, and footers | ✓ |
-| Custom document properties | ✓ |
-| Custom XML parts | ✓ |
-| SVG and EMF images | ✓ |
-| Inline and floating pictures | ✓ |
-| Independent ASCII, High ANSI, and East Asian font controls | ✓ |
-| Low-level OPC parts and relationships | ✓ |
-| File-path and in-memory stream processing | ✓ |
+## Capability Matrix
+
+| Capability | Status | Primary API |
+| --- | --- | --- |
+| Documents, paragraphs, tables, styles, sections, headers, and footers | Stable | `Document()` and document object APIs |
+| Custom document properties | Stable | `document.custom_properties` |
+| Custom XML lifecycle | Stable | `add_custom_xml_part()`, `delete_custom_xml_part()` |
+| SVG and EMF images | Stable | `add_picture()` |
+| Inline and floating pictures | Stable | `add_picture()`, `add_float_picture()` |
+| Latin and East Asian font controls | Stable | `run.font.name`, `run.font.hAnsi`, `run.font.eastAsia` |
+| Low-level OPC parts and relationships | Stable | `document.part.package`, `part.rels` |
+| In-memory read, export, and independent copies | Stable | `Document()`, `to_bytes()`, `copy()` |
+| Document sanitization | Development | `document.sanitize()` |
+| Package inspection and diff | Planned | — |
 
 ## Installation
 
@@ -170,6 +172,8 @@ available through `Document.add_float_picture()` and `Run.add_float_picture()`.
 - [API reference](docs/index.rst#api-documentation)
 - [Custom properties](docs/user/custom-properties.rst)
 - [Custom XML](docs/user/custom-xml.rst)
+- [python-docx compatibility](docs/user/compatibility.rst)
+- [Upstream maintenance](docs/dev/upstream-maintenance.rst)
 - [Release history](HISTORY.md)
 
 ## Quality and Testing

{python_docx_oss-0.1.1.dist-info → python_docx_oss-0.3.0.dist-info}/RECORD

@@ -1,8 +1,8 @@
-docx/__init__.py,sha256=lzMxui-aFJFpJ33Mg8ra9T6A4KSd24ZH5sEHgXwgmcU,2102
-docx/api.py,sha256=13U56iPSM2tMRDEb03OmSZQkDAPmwGjfxosYkWS2tcc,1350
+docx/__init__.py,sha256=sDaLx2PbYx5dXsjgnP0rhCKyeZZrysYhseDkNNC3Q2Y,2102
+docx/api.py,sha256=jIojXW4IRDEXQqaqvmOZbzBvNeyRXv9ntHByxd-Kb0M,1518
 docx/blkcntnr.py,sha256=_xe7Uz3RBCz4TPKXpIzRxtGg-1YPb3gAG9YvsSUyoLU,3525
 docx/comments.py,sha256=MmaP7U9mZOUFsRhaZNIbXatqOOA8-pOC6UlqWAuTHsc,6385
-docx/document.py,sha256=MbIMThSh8tEVExx72aKI4SMGQBcsScQdGLzNv2Asa9o,11941
+docx/document.py,sha256=IYTU_lmh_f1SILGGc0XqrDMl814hZ937d8iubfsYFos,13163
 docx/exceptions.py,sha256=WWiMy3ZtsfKRS31Wv09egLZnpPkX0H66B8JkOPCC3FM,454
 docx/package.py,sha256=Eob2q7R6jXQ3iPD0cAGHzu2RVYgU2te4zfG3oVN_-lM,4288
 docx/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -25,8 +25,8 @@ docx/enum/table.py,sha256=7PuQ--PGnSaNiE0Bu4VJ9t6LOgM-hNNmKEcl-3S2eUk,3943
 docx/enum/text.py,sha256=o6bdpJot2iY40UnnBQ1uGfdE8oHFm3dtXUrmt9eMlvE,10276
 docx/image/__init__.py,sha256=OvnRg5_DTmmrJObUBWLVcPFMRPb-u63e0EKfF_eIQlk,924
 docx/image/bmp.py,sha256=w_Jhu6hByAckJNyKhI3zHOKsHyibHgxDIjiPI9ev704,1347
-docx/image/constants.py,sha256=Y-ME9Z2KDLsjFQDun8XxhXrL6HNXhkUZqGHuCHXEMf4,3466
-docx/image/emf.py,sha256=BnPe6n9f4H9GZvB3Rb8zY-aaHr61WFLcQkryAqx4V4c,1210
+docx/image/constants.py,sha256=c6Mtsy38b0nilCcRp9vvXkV7hyLDb0sDHfJoPqH-lPk,3490
+docx/image/emf.py,sha256=C22sBpDu6vxLqAQmycPCb6xBc8ezVpr1C8x-C8SL2GE,1180
 docx/image/exceptions.py,sha256=_6rkjXXcbFxb_H-J0kK4Q1J9RaLx3TVQ5hoOVENvQaI,383
 docx/image/gif.py,sha256=0R7L0r7kjf844pdpN6UKEISsEQzOPAyA3cghXXdJW2s,1118
 docx/image/helpers.py,sha256=jy0fQBqIfstp9ExfKw3dGNKozn74RnmSA_YwmolsDqM,3089
@@ -37,17 +37,17 @@ docx/image/svg.py,sha256=qDtoQerJ7lJscevXM65BlWqmtUKVB05jTnQajjwLpFw,3576
 docx/image/tiff.py,sha256=LZx-P2uMSzgdzHfIWRqRqtnbhuIqWBY_cLkx9_HTrPs,10379
 docx/opc/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 docx/opc/constants.py,sha256=u7JE0q95EFiAp3jXOntjv1cV0GdGpKtLfx85D2mlch0,17124
-docx/opc/coreprops.py,sha256=IfQeqC5o4k9Obj_kQ4ZKfFl6IL7eIm7dcIC1AZkVvac,3468
+docx/opc/coreprops.py,sha256=DUE7xnk0syV2EtwHtJimX5V5efDccsqoB2KW_mmuHEA,4937
 docx/opc/customprops.py,sha256=oCHxWPNWSekBQrtO07WPSb0WKLQgTgfS3y8m8ZUXN-A,1986
 docx/opc/exceptions.py,sha256=pqa1GuFxMlGZDBgGBqntZ_8aDINLwo2gtPuNRwADzyM,264
 docx/opc/oxml.py,sha256=IE3H4F-DWr8QSZi0pxc767apU3Nk-BhFTs7HiTD5ck0,8325
 docx/opc/package.py,sha256=zWteqHOyPbR4mpcoOZy-sPVWvQR2e2fQVoYdjaHXXfI,10217
 docx/opc/packuri.py,sha256=1-uRAwjIftl475nozvssEoS-0EBz0w-oJvT-fNYcx9o,3729
-docx/opc/part.py,sha256=15TjdwOs137LDdr-EVNeLb4iQdRyIfDZg6Vjx6_8Zdc,9606
+docx/opc/part.py,sha256=WZsVGi25sZhRobXEFRBQCVX6EXan2pE1GPe_zH5nhxk,9977
 docx/opc/phys_pkg.py,sha256=-eNZDBbLShHo3W1iglf1CwN_nkK8qnmTWp6ABg77cjA,4005
 docx/opc/pkgreader.py,sha256=iUPZ7Ba4kNXjPB-q1mQEO44eVmbnP08po4WFH-HD2IE,9588
 docx/opc/pkgwriter.py,sha256=shDeuBtW2BbFOTHrXx8R97PWFaH_fE37JYBfbw6QWRs,4524
-docx/opc/rel.py,sha256=9BAZ59Cr5-BKs_5R8aifPDnPpXw-75GdfYYY6_a8Ays,6219
+docx/opc/rel.py,sha256=ziqjJ_zQZ1Ow1sNM46se8F6YZRVST-Z8Z4NYvnnOt8o,6423
 docx/opc/shared.py,sha256=Zn2avg2g0J2fkG5YgFfCbl138gXex8stR-QwVJcuSIY,996
 docx/opc/spec.py,sha256=GP8YEb7bSmZQ0i338M3lQCVZm6yUnkUhm3PFKVgW8bQ,638
 docx/opc/parts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -81,14 +81,17 @@ docx/oxml/text/parfmt.py,sha256=5TYCf-QfcwlECXUkrLSYFfewFA1JieKGTtm3X01fu64,1222
 docx/oxml/text/run.py,sha256=W8vwOomvk1oGzAq2BqDgyVftKsSi5LK9_vlADVcMgpg,11238
 docx/parts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 docx/parts/comments.py,sha256=Dmxh_i8ADRo-wLfO9LV0Lyho5XC_76oU1NJN8itw8lc,1760
-docx/parts/customxml.py,sha256=7GNGmzJf6-jBZ7ltciXp_3nfGDJGKI7y5jDCarbjVuI,1907
-docx/parts/document.py,sha256=lQSAco_MB0Y5hv7zDQGypR9JcYNi6HcF5Qsfn5c3ahg,7450
+docx/parts/customxml.py,sha256=hbwDmPwR-1RRLOOFhmiPd0B-dNwpfZFrOxIaGU4UlG4,1920
+docx/parts/document.py,sha256=hox7yRnsZRTF1C4ersAQUHNP58YhHxHMJnnztyp-2wM,8171
 docx/parts/hdrftr.py,sha256=_U0PCjVkK6EWwkyZb9oTunlNb6x55rECD1xFDzwUlPM,1709
 docx/parts/image.py,sha256=c-DF5YFvp1qVTx7Zon-xOXw0qPc_3LoeX9qMSFPs6mo,2739
 docx/parts/numbering.py,sha256=rrVIiRoBQIy6j8eWGhWyhcJvNx6RRaItWVDhorwrVyo,1715
 docx/parts/settings.py,sha256=lqcDzDNLEc8ElxmNMKwy6uNgOesfYcvBDhKz7uUMnb4,1717
 docx/parts/story.py,sha256=WgsvzLkfZ7DigCE9MVSGPfajzennxdPvOtIdoSxmeuk,4577
 docx/parts/styles.py,sha256=Ly7aJyPgtwQ2TRIwuUtHz_x1Z0FH9JTtsNohml1-ykM,1391
+docx/sanitize/__init__.py,sha256=woy_ORRETalWdjmOsDAV7F4ON0jmOWBWm5b8KHhp_yw,387
+docx/sanitize/cleaner.py,sha256=BwAKuJ_B36J6TLSnePMzzvgB129T3QitO6lHS5LXsB0,7602
+docx/sanitize/result.py,sha256=JL5IrKnFpG4WQrXcMqNNxFmBHib7J0IXp4D5p2_iI5c,1055
 docx/styles/__init__.py,sha256=aCJqhH4JhG_cIm3iwVJGtWpWW0AXJx3QMag7MORmrdI,1406
 docx/styles/latent.py,sha256=EDBcgd-1jKmW-wGz64GvcGSopnOuPQG1inU0pnHRsQA,7211
 docx/styles/style.py,sha256=BoGXQRSyODmPI38bAEWPgTXEPwhXyVYZZ9nSYxRSHPM,8051
@@ -125,8 +128,8 @@ docx/text/paragraph.py,sha256=N3F62_JRQZYaumuoaJXKCDnRSw2DIiOwzyMPV2Jd7GI,6828
 docx/text/parfmt.py,sha256=70M75HFo7ydpqmIdZjkV711muyrsBGdr4WZscF3YVJY,10339
 docx/text/run.py,sha256=tsW8dXOE4VnqEM7cJz_uU2Vq3qgdnrMGzyDq9x5jvE4,10800
 docx/text/tabstops.py,sha256=bJN98GWW22f4Sqg0dQbyUcnuOn65fHsNZuCGswI03_c,3896
-python_docx_oss-0.1.1.dist-info/licenses/LICENSE,sha256=lf2yZv-riPwFeah3IMDeG0zqI6fXcV9T9YOToeG54NM,1164
-python_docx_oss-0.1.1.dist-info/METADATA,sha256=vsUjUJmj42pvIO-LKhVnsuAxjpmU415JVPKJzSRfR4Q,7319
-python_docx_oss-0.1.1.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-python_docx_oss-0.1.1.dist-info/top_level.txt,sha256=zkbrD3gmyqHpD_XhHe7lCbr2M5vT229nJ4UFqF5VjIs,5
-python_docx_oss-0.1.1.dist-info/RECORD,,
+python_docx_oss-0.3.0.dist-info/licenses/LICENSE,sha256=lf2yZv-riPwFeah3IMDeG0zqI6fXcV9T9YOToeG54NM,1164
+python_docx_oss-0.3.0.dist-info/METADATA,sha256=hp-fShMO4V9dZLm86V-xoMsQgyphHVcgtLr8-tS7aa0,7900
+python_docx_oss-0.3.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+python_docx_oss-0.3.0.dist-info/top_level.txt,sha256=zkbrD3gmyqHpD_XhHe7lCbr2M5vT229nJ4UFqF5VjIs,5
+python_docx_oss-0.3.0.dist-info/RECORD,,