PyPDFForm 2.2.1__tar.gz → 2.2.3__tar.gz

{pypdfform-2.2.1 → pypdfform-2.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyPDFForm
-Version: 2.2.1
+Version: 2.2.3
 Summary: The Python library for PDF forms.
 Author: Jinge Li
 License-Expression: MIT
@@ -26,7 +26,9 @@ Requires-Dist: pillow
 Requires-Dist: pypdf
 Requires-Dist: reportlab
 Provides-Extra: dev
+Requires-Dist: black; extra == "dev"
 Requires-Dist: coverage; extra == "dev"
+Requires-Dist: isort; extra == "dev"
 Requires-Dist: jsonschema; extra == "dev"
 Requires-Dist: mkdocs; extra == "dev"
 Requires-Dist: pudb; extra == "dev"
@@ -76,7 +78,7 @@ pip install PyPDFForm
 ```
 
 ## Quick Example
-![Check out the GitHub repository for a live demo if you can't see it here.](https://github.com/chinapandaman/PyPDFForm/raw/master/demo.gif)
+![Check out the GitHub repository for a live demo if you can't see it here.](https://github.com/chinapandaman/PyPDFForm/raw/master/docs/img/demo.gif)
 
 A sample PDF form can be found [here](https://github.com/chinapandaman/PyPDFForm/raw/master/pdf_samples/sample_template.pdf). Download it and try:
 

{pypdfform-2.2.1 → pypdfform-2.2.3}/PyPDFForm/__init__.py

@@ -5,7 +5,7 @@ This package provides tools for filling PDF forms, drawing text and images,
 and manipulating PDF form elements programmatically.
 """
 
-__version__ = "2.2.1"
+__version__ = "2.2.3"
 
 from .wrapper import FormWrapper, PdfWrapper
 

{pypdfform-2.2.1 → pypdfform-2.2.3}/PyPDFForm/watermark.py

@@ -10,7 +10,7 @@ This module handles:
 """
 
 from io import BytesIO
-from typing import List
+from typing import List, Union
 
 from pypdf import PdfReader, PdfWriter
 from pypdf.generic import ArrayObject, NameObject
@@ -335,20 +335,22 @@ def merge_watermarks_with_pdf(
 
 
 def copy_watermark_widgets(
-    pdf: bytes, watermarks: List[bytes], keys: List[str]
+    pdf: bytes, watermarks: Union[List[bytes], bytes], keys: Union[List[str], None]
 ) -> bytes:
     """
     Copies annotation widgets (form fields) from watermark PDFs onto the corresponding pages of a base PDF,
     including only those widgets whose key matches an entry in the provided keys list.
 
-    For each watermark in the provided list, any annotation widgets (such as form fields) are cloned
-    and appended to the annotations of the corresponding page in the base PDF, but only if their key
-    matches one of the specified keys.
+    For each watermark in the provided list (or single watermark PDF if bytes input is provided),
+    any annotation widgets (such as form fields) are cloned and appended to the annotations of the
+    corresponding page in the base PDF, but only if their key matches one of the specified keys.
 
     Args:
         pdf: The original PDF document as bytes.
-        watermarks: List of watermark PDF data (as bytes), one per page. Empty or None entries are skipped.
+        watermarks: Either a list of watermark PDF data (as bytes, one per page) or a single watermark PDF.
+                   Empty or None entries are skipped.
         keys: List of widget keys (str). Only widgets whose key is in this list will be copied.
+              If None, all widgets will be copied.
 
     Returns:
         bytes: The resulting PDF document with selected annotation widgets from watermarks copied onto their respective pages.
@@ -358,21 +360,29 @@ def copy_watermark_widgets(
     out = PdfWriter()
     out.append(pdf_file)
 
-    widgets_to_copy = {}
+    widgets_to_copy_watermarks = {}
+    widgets_to_copy_pdf = {}
+
+    widgets_to_copy = widgets_to_copy_watermarks
+    if isinstance(watermarks, bytes):
+        watermarks = [watermarks]
+        widgets_to_copy = widgets_to_copy_pdf
 
     for i, watermark in enumerate(watermarks):
         if not watermark:
             continue
 
-        widgets_to_copy[i] = []
+        widgets_to_copy_watermarks[i] = []
         watermark_file = PdfReader(stream_to_io(watermark))
-        for page in watermark_file.pages:
+        for j, page in enumerate(watermark_file.pages):
+            widgets_to_copy_pdf[j] = []
             for annot in page.get(Annots, []):  # noqa
                 key = extract_widget_property(
                     annot.get_object(), WIDGET_KEY_PATTERNS, None, str
                 )
-                if key in keys:
-                    widgets_to_copy[i].append(annot.clone(out))
+                if keys is None or key in keys:
+                    widgets_to_copy_watermarks[i].append(annot.clone(out))
+                    widgets_to_copy_pdf[j].append(annot.clone(out))
 
     for i, page in enumerate(out.pages):
         if i in widgets_to_copy:

{pypdfform-2.2.1 → pypdfform-2.2.3}/PyPDFForm/wrapper.py

@@ -586,7 +586,10 @@ class PdfWrapper(FormWrapper):
         """Draws static text onto the PDF document at specified coordinates.
 
         Adds non-interactive text that becomes part of the PDF content rather
-        than a form field. Useful for annotations, labels, signatures, etc.
+        than a form field. The text is drawn using a temporary Text widget and
+        merged via watermark operations, preserving existing form fields.
+
+        Supports multi-line text (using NEW_LINE_SYMBOL) and custom formatting.
 
         Args:
             text: The text content to draw (supports newlines with NEW_LINE_SYMBOL)
@@ -624,7 +627,11 @@ class PdfWrapper(FormWrapper):
             ],
         )
 
+        stream_with_widgets = self.read()
         self.stream = merge_watermarks_with_pdf(self.stream, watermarks)
+        self.stream = copy_watermark_widgets(
+            remove_all_widgets(self.stream), stream_with_widgets, None
+        )
 
         return self
 
@@ -640,10 +647,8 @@ class PdfWrapper(FormWrapper):
     ) -> PdfWrapper:
         """Draws an image onto the PDF document at specified coordinates.
 
-        Supports common image formats (JPEG, PNG) from various sources:
-        - Raw image bytes
-        - File path
-        - File-like object
+        The image is merged via watermark operations, preserving existing form fields.
+        Supports common formats (JPEG, PNG) from bytes, file paths, or file objects.
 
         Args:
             image: Image data as bytes, file path, or file object
@@ -664,7 +669,11 @@ class PdfWrapper(FormWrapper):
             self.stream, page_number, "image", [[image, x, y, width, height]]
         )
 
+        stream_with_widgets = self.read()
         self.stream = merge_watermarks_with_pdf(self.stream, watermarks)
+        self.stream = copy_watermark_widgets(
+            remove_all_widgets(self.stream), stream_with_widgets, None
+        )
 
         return self
 

{pypdfform-2.2.1 → pypdfform-2.2.3}/PyPDFForm.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyPDFForm
-Version: 2.2.1
+Version: 2.2.3
 Summary: The Python library for PDF forms.
 Author: Jinge Li
 License-Expression: MIT
@@ -26,7 +26,9 @@ Requires-Dist: pillow
 Requires-Dist: pypdf
 Requires-Dist: reportlab
 Provides-Extra: dev
+Requires-Dist: black; extra == "dev"
 Requires-Dist: coverage; extra == "dev"
+Requires-Dist: isort; extra == "dev"
 Requires-Dist: jsonschema; extra == "dev"
 Requires-Dist: mkdocs; extra == "dev"
 Requires-Dist: pudb; extra == "dev"
@@ -76,7 +78,7 @@ pip install PyPDFForm
 ```
 
 ## Quick Example
-![Check out the GitHub repository for a live demo if you can't see it here.](https://github.com/chinapandaman/PyPDFForm/raw/master/demo.gif)
+![Check out the GitHub repository for a live demo if you can't see it here.](https://github.com/chinapandaman/PyPDFForm/raw/master/docs/img/demo.gif)
 
 A sample PDF form can be found [here](https://github.com/chinapandaman/PyPDFForm/raw/master/pdf_samples/sample_template.pdf). Download it and try:
 

{pypdfform-2.2.1 → pypdfform-2.2.3}/PyPDFForm.egg-info/requires.txt

@@ -4,7 +4,9 @@ pypdf
 reportlab
 
 [dev]
+black
 coverage
+isort
 jsonschema
 mkdocs
 pudb

{pypdfform-2.2.1 → pypdfform-2.2.3}/README.md

@@ -37,7 +37,7 @@ pip install PyPDFForm
 ```
 
 ## Quick Example
-![Check out the GitHub repository for a live demo if you can't see it here.](https://github.com/chinapandaman/PyPDFForm/raw/master/demo.gif)
+![Check out the GitHub repository for a live demo if you can't see it here.](https://github.com/chinapandaman/PyPDFForm/raw/master/docs/img/demo.gif)
 
 A sample PDF form can be found [here](https://github.com/chinapandaman/PyPDFForm/raw/master/pdf_samples/sample_template.pdf). Download it and try:
 

{pypdfform-2.2.1 → pypdfform-2.2.3}/pyproject.toml

@@ -40,7 +40,9 @@ Documentation = "https://chinapandaman.github.io/PyPDFForm/"
 
 [project.optional-dependencies]
 dev = [
+    "black",
     "coverage",
+    "isort",
     "jsonschema",
     "mkdocs",
     "pudb",

{pypdfform-2.2.1 → pypdfform-2.2.3}/tests/test_functional.py

@@ -34,6 +34,25 @@ def test_fill(template_stream, pdf_samples, data_dict, request):
             assert not widgets
 
 
+def test_fill_not_render_widgets(template_stream, pdf_samples, data_dict, request):
+    expected_path = os.path.join(pdf_samples, "test_fill_not_render_widgets.pdf")
+    with open(expected_path, "rb+") as f:
+        obj = PdfWrapper(template_stream, render_widgets=False).fill(
+            data_dict,
+        )
+
+        request.config.results["expected_path"] = expected_path
+        request.config.results["stream"] = obj.read()
+
+        assert len(obj.read()) == len(obj.stream)
+        assert obj.read() == obj.stream
+
+        expected = f.read()
+
+        assert len(obj.stream) == len(expected)
+        assert obj.stream == expected
+
+
 def test_register_bad_fonts():
     assert not PdfWrapper.register_font("foo", b"foo")
     assert not PdfWrapper.register_font("foo", "foo")
@@ -218,6 +237,52 @@ def test_draw_text_on_one_page(template_stream, pdf_samples, request):
         assert obj.stream == expected
 
 
+def test_draw_text_on_radio_template(
+    template_with_radiobutton_stream, pdf_samples, request
+):
+    expected_path = os.path.join(pdf_samples, "test_draw_text_on_radio_template.pdf")
+    with open(expected_path, "rb+") as f:
+        obj = PdfWrapper(template_with_radiobutton_stream).draw_text(
+            "drawn_text",
+            1,
+            300,
+            225,
+            font=constants.DEFAULT_FONT,
+            font_size=20,
+            font_color=(1, 0, 0),
+        )
+
+        request.config.results["expected_path"] = expected_path
+        request.config.results["stream"] = obj.read()
+
+        expected = f.read()
+
+        assert len(obj.stream) == len(expected)
+        assert obj.stream == expected
+
+
+def test_draw_text_on_sejda_template(sejda_template, pdf_samples, request):
+    expected_path = os.path.join(pdf_samples, "test_draw_text_on_sejda_template.pdf")
+    with open(expected_path, "rb+") as f:
+        obj = PdfWrapper(sejda_template).draw_text(
+            "drawn_text",
+            1,
+            300,
+            225,
+            font=constants.DEFAULT_FONT,
+            font_size=20,
+            font_color=(1, 0, 0),
+        )
+
+        request.config.results["expected_path"] = expected_path
+        request.config.results["stream"] = obj.read()
+
+        expected = f.read()
+
+        assert len(obj.stream) == len(expected)
+        assert obj.stream == expected
+
+
 def test_draw_text_new_line_symbol(template_stream, pdf_samples, request):
     expected_path = os.path.join(
         pdf_samples, "sample_pdf_with_drawn_text_new_line_symbol.pdf"
@@ -261,6 +326,54 @@ def test_draw_image_on_one_page(template_stream, image_samples, pdf_samples, req
             assert obj.stream == expected
 
 
+def test_draw_image_on_radio_template(
+    template_with_radiobutton_stream, image_samples, pdf_samples, request
+):
+    expected_path = os.path.join(pdf_samples, "test_draw_image_on_radio_template.pdf")
+    with open(expected_path, "rb+") as f:
+        with open(os.path.join(image_samples, "sample_image.jpg"), "rb+") as _f:
+            obj = PdfWrapper(template_with_radiobutton_stream).draw_image(
+                _f,
+                2,
+                100,
+                100,
+                400,
+                225,
+            )
+
+        expected = f.read()
+
+        request.config.results["expected_path"] = expected_path
+        request.config.results["stream"] = obj.read()
+
+        assert len(obj.stream) == len(expected)
+        assert obj.stream == expected
+
+
+def test_draw_image_on_sejda_template(
+    sejda_template, image_samples, pdf_samples, request
+):
+    expected_path = os.path.join(pdf_samples, "test_draw_image_on_sejda_template.pdf")
+    with open(expected_path, "rb+") as f:
+        with open(os.path.join(image_samples, "sample_image.jpg"), "rb+") as _f:
+            obj = PdfWrapper(sejda_template).draw_image(
+                _f,
+                2,
+                100,
+                100,
+                400,
+                225,
+            )
+
+        expected = f.read()
+
+        request.config.results["expected_path"] = expected_path
+        request.config.results["stream"] = obj.read()
+
+        assert len(obj.stream) == len(expected)
+        assert obj.stream == expected
+
+
 def test_draw_png_image_on_one_page(
     template_stream, image_samples, pdf_samples, request
 ):

{pypdfform-2.2.1 → pypdfform-2.2.3}/tests/test_paragraph.py

@@ -139,6 +139,102 @@ def test_fill_sejda_complex(sejda_template_complex, pdf_samples, request):
         assert obj.stream == expected
 
 
+def test_fill_sejda_complex_not_render_widgets(
+    sejda_template_complex, pdf_samples, request
+):
+    expected_path = os.path.join(
+        pdf_samples, "paragraph", "test_fill_sejda_complex_not_render_widgets.pdf"
+    )
+    with open(expected_path, "rb+") as f:
+        obj = PdfWrapper(sejda_template_complex, render_widgets=False).fill(
+            {
+                "checkbox": True,
+                "radio": 0,
+                "dropdown_font_auto_left": 0,
+                "dropdown_font_auto_center": 1,
+                "dropdown_font_auto_right": 2,
+                "dropdown_font_ten_left": 0,
+                "dropdown_font_ten_center": 1,
+                "dropdown_font_ten_right": 2,
+                "paragraph_font_auto_left": "paragraph_font_auto_left",
+                "paragraph_font_auto_center": "paragraph_font_auto_center",
+                "paragraph_font_auto_right": "paragraph_font_auto_right",
+                "paragraph_font_ten_left": "paragraph_font_ten_left",
+                "paragraph_font_ten_center": "paragraph_font_ten_center",
+                "paragraph_font_ten_right": "paragraph_font_ten_right",
+                "text__font_auto_left": "test text",
+                "text_font_auto_center": "test text",
+                "text_font_auto_right": "test text",
+                "text_font_ten_left": "text_font_ten_left",
+                "text_font_ten_center": "text_font_ten_center",
+                "text_font_ten_right": "text_font_ten_right",
+            }
+        )
+
+        request.config.results["expected_path"] = expected_path
+        request.config.results["stream"] = obj.read()
+        assert len(obj.read()) == len(obj.stream)
+        assert obj.read() == obj.stream
+
+        expected = f.read()
+
+        assert len(obj.stream) == len(expected)
+        assert obj.stream == expected
+
+
+def test_fill_sejda_complex_not_render_some_widgets(
+    sejda_template_complex, pdf_samples, request
+):
+    expected_path = os.path.join(
+        pdf_samples, "paragraph", "test_fill_sejda_complex_not_render_some_widgets.pdf"
+    )
+    with open(expected_path, "rb+") as f:
+        obj = PdfWrapper(sejda_template_complex)
+
+        obj.widgets["radio"].render_widget = False
+        obj.widgets["dropdown_font_auto_center"].render_widget = False
+        obj.widgets["dropdown_font_ten_center"].render_widget = False
+        obj.widgets["paragraph_font_auto_center"].render_widget = False
+        obj.widgets["paragraph_font_ten_center"].render_widget = False
+        obj.widgets["text_font_auto_center"].render_widget = False
+        obj.widgets["text_font_ten_center"].render_widget = False
+
+        obj.fill(
+            {
+                "checkbox": True,
+                "radio": 0,
+                "dropdown_font_auto_left": 0,
+                "dropdown_font_auto_center": 1,
+                "dropdown_font_auto_right": 2,
+                "dropdown_font_ten_left": 0,
+                "dropdown_font_ten_center": 1,
+                "dropdown_font_ten_right": 2,
+                "paragraph_font_auto_left": "paragraph_font_auto_left",
+                "paragraph_font_auto_center": "paragraph_font_auto_center",
+                "paragraph_font_auto_right": "paragraph_font_auto_right",
+                "paragraph_font_ten_left": "paragraph_font_ten_left",
+                "paragraph_font_ten_center": "paragraph_font_ten_center",
+                "paragraph_font_ten_right": "paragraph_font_ten_right",
+                "text__font_auto_left": "test text",
+                "text_font_auto_center": "test text",
+                "text_font_auto_right": "test text",
+                "text_font_ten_left": "text_font_ten_left",
+                "text_font_ten_center": "text_font_ten_center",
+                "text_font_ten_right": "text_font_ten_right",
+            }
+        )
+
+        request.config.results["expected_path"] = expected_path
+        request.config.results["stream"] = obj.read()
+        assert len(obj.read()) == len(obj.stream)
+        assert obj.read() == obj.stream
+
+        expected = f.read()
+
+        assert len(obj.stream) == len(expected)
+        assert obj.stream == expected
+
+
 def test_sejda_complex_paragraph_multiple_line_alignment(
     sejda_template_complex, pdf_samples, request
 ):