Merge pull request #593 from aperechnev/master

elapouya · web-flow · commit 08a5d748f6cd · 2025-05-02T15:56:50.000+02:00
Possibility to skip missing pictures
diff --git a/docxtpl/template.py b/docxtpl/template.py
@@ -46,6 +46,7 @@ def __init__(self, template_file: Union[IO[bytes], str, PathLike]) -> None:
         self.docx = None
         self.is_rendered = False
         self.is_saved = False
+        self.allow_missing_pics = False
 
     def init_docx(self, reload: bool = True):
         if not self.docx or (self.is_rendered and reload):
@@ -797,10 +798,11 @@ def _replace_pics(self):
             if rel.reltype in (REL_TYPE.HEADER, REL_TYPE.FOOTER):
                 self._replace_docx_part_pics(rel.target_part, replaced_pics)
 
-        # make sure all template images defined by user were replaced
-        for img_id, replaced in replaced_pics.items():
-            if not replaced:
-                raise ValueError("Picture %s not found in the docx template" % img_id)
+        if not self.allow_missing_pics:
+            # make sure all template images defined by user were replaced
+            for img_id, replaced in replaced_pics.items():
+                if not replaced:
+                    raise ValueError("Picture %s not found in the docx template" % img_id)
 
     def get_pic_map(self):
         return self.pic_map
