ENH: Add 'strict' parameter to PDFWriter (#3503)

Closes #3494.

Author: Arya-A-Nair

docs/user/robustness.md

@@ -32,8 +32,7 @@ pypdf has two core objects:
 * {class}`~pypdf.PdfReader`
 * {class}`~pypdf.PdfWriter`
 
-Only the PdfReader has a `strict` parameter, since presumably you do not want
-to write a non-conforming PDF.
+PdfReader and PdfWriter both have a `strict` parameter.
 
 Choosing `strict=True` means that pypdf will raise an exception if a PDF does
 not follow the specification.

pypdf/_writer.py

@@ -160,6 +160,10 @@ class PdfWriter(PdfDocCommon):
         full: If true, loads all the objects (always full if incremental = True).
             This parameter may allow loading large PDFs.
 
+        strict: If true, pypdf will raise an exception if a PDF does not follow the specification.
+            If false, pypdf will try to be forgiving and do something reasonable, but it will log
+            a warning message. It is a best-effort approach.
+
     """
 
     def __init__(
@@ -168,7 +172,15 @@ def __init__(
         clone_from: Union[None, PdfReader, StrByteType, Path] = None,
         incremental: bool = False,
         full: bool = False,
+        strict: bool = False,
     ) -> None:
+        self.strict = strict
+        """
+        If true, pypdf will raise an exception if a PDF does not follow the specification.
+        If false, pypdf will try to be forgiving and do something reasonable, but it will log
+        a warning message. It is a best-effort approach.
+        """
+
         self.incremental = incremental or full
         """
         Returns if the PdfWriter object has been started in incremental mode.

tests/test_writer.py

@@ -2867,8 +2867,7 @@ def test_wrong_size_in_incremental_pdf(caplog):
     assert len(writer._objects) == 20
 
     caplog.clear()
-    writer = PdfWriter(incremental=False)
-    writer.strict = True
+    writer = PdfWriter(incremental=False, strict=True)
     with pytest.raises(expected_exception=PdfReadError, match=r"^Object count 19 exceeds defined trailer size 2$"):
         writer.clone_reader_document_root(reader=PdfReader(BytesIO(modified_data)))