python-pptx2 2.15.0__tar.gz → 2.16.0__tar.gz

{python_pptx2-2.15.0 → python_pptx2-2.16.0}/HISTORY.rst

@@ -15,6 +15,21 @@ can sit beside both ``python-pptx`` (``pptx``) and ``power-pptx``
 .. _`scanny/python-pptx`: https://github.com/scanny/python-pptx
 
 
+2.16.0 (2026-08-30)
++++++++++++++++++++
+
+Added
+.....
+
+* ``audit(..., extra_safe_fonts=[...])`` — the font-warning probe now
+  accepts additional fonts to treat as safe (case-insensitive), on top
+  of the built-in common Windows/macOS/Office list. For rendering
+  environments that genuinely ship a font the built-in list doesn't
+  know — e.g. a Linux sandbox whose font policy standardizes on
+  ``DejaVu Sans`` — this keeps the audit signal instead of drowning it
+  in per-slide warnings.
+
+
 2.15.0 (2026-08-30)
 +++++++++++++++++++
 

{python_pptx2-2.15.0/src/python_pptx2.egg-info → python_pptx2-2.16.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-pptx2
-Version: 2.15.0
+Version: 2.16.0
 Summary: Create, read, and update PowerPoint 2007+ (.pptx) files. Fork of power-pptx / python-pptx, published as python-pptx2.
 Author: Matěj Štágl
 Author-email: stagl@wattlescript.org

{python_pptx2-2.15.0 → python_pptx2-2.16.0}/src/pptx2/__init__.py

@@ -57,7 +57,7 @@ from pptx2.parts.slide import (
 if TYPE_CHECKING:
     from pptx2.opc.package import Part
 
-__version__ = "2.15.0"
+__version__ = "2.16.0"
 
 sys.modules["pptx2.exceptions"] = exceptions
 del sys

{python_pptx2-2.15.0 → python_pptx2-2.16.0}/src/pptx2/audit.py

@@ -30,7 +30,7 @@ The audit is read-only — it never mutates the deck.
 from __future__ import annotations
 
 from dataclasses import dataclass, field
-from typing import TYPE_CHECKING, Any
+from typing import TYPE_CHECKING, Any, Iterable
 
 if TYPE_CHECKING:
     from pptx2.api import Presentation
@@ -174,15 +174,27 @@ def audit(
     *,
     size_warn_bytes: int = 2_000_000,
     check_fonts: bool = True,
+    extra_safe_fonts: "Iterable[str] | None" = None,
 ) -> AuditReport:
     """Walk the deck and return an :class:`AuditReport` summary.
 
     Read-only — never mutates the presentation.  Each slide is linted
     in passing-defaults mode; per-slide overrides should be supplied
     via the slide-level ``slide.lint(...)`` API directly.
+
+    *extra_safe_fonts* names additional fonts to treat as safe for the
+    font-warning probe, on top of the common Windows/macOS/Office set
+    (matching is case-insensitive).  Use it where the rendering
+    environment genuinely ships the font — e.g. ``DejaVu Sans`` in a
+    sandbox whose font policy standardizes on it, or a corporate font
+    you embed in every deck.
     """
     from pptx2.shapes.picture import Picture
 
+    safe_fonts = _COMMON_FONTS
+    if extra_safe_fonts is not None:
+        safe_fonts = _COMMON_FONTS | frozenset(f.lower() for f in extra_safe_fonts)
+
     report = AuditReport()
     slides = list(prs.slides)
     report.total_slides = len(slides)
@@ -249,7 +261,7 @@ def audit(
                 for para in tf.paragraphs:
                     for run in para.runs:
                         name = run.font.name
-                        if name and name.lower() not in _COMMON_FONTS:
+                        if name and name.lower() not in safe_fonts:
                             report.font_warnings.append((idx, name))
 
         if content_shapes == 0:

{python_pptx2-2.15.0 → python_pptx2-2.16.0}/src/pptx2/skill/references/lint.md

@@ -178,6 +178,15 @@ if data["has_errors"]:
     ...                        # hand `data` straight to the model to fix
 ```
 
+`audit()` also warns on fonts outside the common Windows/macOS/Office
+safe-list. When the rendering environment genuinely ships a font (e.g.
+DejaVu Sans in a Linux sandbox), pass it instead of letting the deck
+drown in noise:
+
+```python
+report = audit(prs, extra_safe_fonts=["DejaVu Sans", "Noto Sans CJK JP"])
+```
+
 ## Save-time hooks (via `from_spec`)
 
 If you build the deck through `pptx2.compose.from_spec`, the spec dict

{python_pptx2-2.15.0 → python_pptx2-2.16.0/src/python_pptx2.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-pptx2
-Version: 2.15.0
+Version: 2.16.0
 Summary: Create, read, and update PowerPoint 2007+ (.pptx) files. Fork of power-pptx / python-pptx, published as python-pptx2.
 Author: Matěj Štágl
 Author-email: stagl@wattlescript.org

{python_pptx2-2.15.0 → python_pptx2-2.16.0}/tests/schema/oxml_schema_validator.py

@@ -130,6 +130,68 @@ def _resolve_mce(doc):
     return doc
 
 
+def _strip_mce_ignorables(doc):
+    """Drop markup an ISO-pure processor must ignore, in place.
+
+    ISO/IEC 29500-3 (Markup Compatibility): a processor that does not
+    understand a namespace listed in ``mc:Ignorable`` MUST ignore every
+    element and attribute in that namespace — and the ``mc:*`` compatibility
+    attributes themselves are outside the base schemas.  The bundled XSDs are
+    exactly such an "MCE-unaware" consumer, so before strict validation this
+    removes:
+
+    * every attribute in the ``mc`` compatibility namespace (``mc:Ignorable``,
+      ``mc:MustUnderstand``, ``mc:ProcessConflicts``, ``mc:PreserveIgnorable``);
+    * every element and attribute in any namespace declared ignorable via
+      ``mc:Ignorable`` (e.g. the ``a14`` equation host namespace 2.14.0+
+      slides declare so PowerPoint tolerates their ``a14:m`` runs).
+
+    Without this, every generated slide fails validation on the
+    ``mc:Ignorable`` attribute alone, deafening the gate to real violations.
+    """
+    # -- 1. collect the namespaces declared ignorable anywhere in the part --
+    ignorable_ns = set()
+    for el in doc.iter():
+        declared = el.get("{%s}Ignorable" % _MC_NS)
+        if not declared:
+            continue
+        for prefix in declared.split():
+            # nsmap is the full in-scope prefix map at this element, so it
+            # resolves prefixes declared on ancestors as well.
+            uri = el.nsmap.get(prefix)
+            if uri is not None:
+                ignorable_ns.add(uri)
+
+    # -- 2. drop elements in ignorable namespaces (root cannot be ignorable:
+    # --    a part whose root is outside the base schema has no schema here) --
+    if ignorable_ns:
+        root = doc.getroottree().getroot()
+        for el in list(doc.iter()):
+            if el is root:
+                continue
+            if etree.QName(el).namespace in ignorable_ns:
+                parent = el.getparent()
+                if parent is not None:
+                    parent.remove(el)
+
+    # -- 3. drop mc:* compatibility attributes and ignorable-ns attributes --
+    mc_attrs = [
+        "{%s}Ignorable" % _MC_NS,
+        "{%s}MustUnderstand" % _MC_NS,
+        "{%s}ProcessConflicts" % _MC_NS,
+        "{%s}PreserveIgnorable" % _MC_NS,
+    ]
+    for el in doc.iter():
+        for attr in list(el.attrib):
+            if attr in mc_attrs:
+                del el.attrib[attr]
+                continue
+            brace = attr.find("}")
+            if brace != -1 and attr[1:brace] in ignorable_ns:
+                del el.attrib[attr]
+    return doc
+
+
 def _should_check(partname: str) -> bool:
     return partname in _CHECKED_EXACT or partname.startswith(_CHECKED_PREFIXES)
 
@@ -440,6 +502,7 @@ def iter_schema_violations(
             schema = _schema_for_namespace(etree.QName(doc).namespace)
             if schema is None:
                 continue
+            _strip_mce_ignorables(doc)
             _resolve_mce(doc)
             if not schema.validate(doc):
                 for err in schema.error_log:  # type: ignore[attr-defined]

{python_pptx2-2.15.0 → python_pptx2-2.16.0}/tests/test_audit.py

@@ -54,6 +54,30 @@ class DescribeAudit:
         assert any(font == "Definitely-Not-A-Real-Font-Name"
                    for _, font in report.font_warnings)
 
+    def it_accepts_extra_safe_fonts(self, prs):
+        slide = prs.slides.add_slide(prs.slide_layouts[6])
+        slide.shapes.add_text(
+            BBox.from_inches(1, 1, 4, 1),
+            text="Hi",
+            font="DejaVu Sans",
+        )
+        # -- without the override the sandbox font is flagged --
+        report = audit(prs)
+        assert any(font == "DejaVu Sans" for _, font in report.font_warnings)
+        # -- and with it (case-insensitively) the warning disappears --
+        report = audit(prs, extra_safe_fonts=["DEJAVU SANS"])
+        assert not any(font == "DejaVu Sans" for _, font in report.font_warnings)
+        # -- other unknown fonts are still flagged alongside the override --
+        slide.shapes.add_text(
+            BBox.from_inches(1, 2.5, 4, 1),
+            text="Also hi",
+            font="Definitely-Not-A-Real-Font-Name",
+        )
+        report = audit(prs, extra_safe_fonts=["DejaVu Sans"])
+        assert any(font == "Definitely-Not-A-Real-Font-Name"
+                   for _, font in report.font_warnings)
+        assert not any(font == "DejaVu Sans" for _, font in report.font_warnings)
+
     def it_treats_full_bleed_only_slide_as_empty(self, prs):
         # A slide whose only shape is a slide-spanning background rect
         # should be reported as empty (it has no content).

{python_pptx2-2.15.0 → python_pptx2-2.16.0}/tests/test_files/minimal_slide.xml

@@ -1,4 +1,4 @@
-<p:sld xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships">
+<p:sld xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" xmlns:m="http://schemas.openxmlformats.org/officeDocument/2006/math" xmlns:a14="http://schemas.microsoft.com/office/drawing/2010/main" xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main" mc:Ignorable="a14">
   <p:cSld>
     <p:spTree>
       <p:nvGrpSpPr>