PyPDFForm 1.4.36__py3-none-any.whl → 1.5.0__py3-none-any.whl

PyPDFForm/__init__.py

@@ -1,7 +1,7 @@
 # -*- coding: utf-8 -*-
 """Contains any object users might need."""
 
-__version__ = "1.4.36"
+__version__ = "1.5.0"
 
 from .wrapper import FormWrapper, PdfWrapper
 

PyPDFForm/constants.py

@@ -31,6 +31,7 @@ Annots = "/Annots"
 A = "/A"
 JS = "/JS"
 T = "/T"
+TU = "/TU"
 Rect = "/Rect"
 FT = "/FT"
 Parent = "/Parent"

PyPDFForm/middleware/base.py

@@ -16,7 +16,8 @@ class Widget:
 
         super().__init__()
         self._name = name
-        self.value = value
+        self._value = value
+        self.desc = None
 
     @property
     def name(self) -> str:
@@ -24,11 +25,28 @@ class Widget:
 
         return self._name
 
+    @property
+    def value(self) -> Any:
+        """Value to fill for the widget."""
+
+        return self._value
+
+    @value.setter
+    def value(self, value: Any) -> None:
+        """Sets value to fill for the widget."""
+
+        self._value = value
+
     @property
     def schema_definition(self) -> dict:
         """Json schema definition of the widget."""
 
-        raise NotImplementedError
+        result = {}
+
+        if self.desc is not None:
+            result["description"] = self.desc
+
+        return result
 
     @property
     def sample_value(self) -> Any:

PyPDFForm/middleware/checkbox.py

@@ -31,7 +31,7 @@ class Checkbox(Widget):
     def schema_definition(self) -> dict:
         """Json schema definition of the checkbox."""
 
-        return {"type": "boolean"}
+        return {"type": "boolean", **super().schema_definition}
 
     @property
     def sample_value(self) -> Union[bool, int]:

PyPDFForm/middleware/dropdown.py

@@ -17,12 +17,17 @@ class Dropdown(Widget):
         super().__init__(name, value)
 
         self.choices = []
+        self.desc = None
 
     @property
     def schema_definition(self) -> dict:
         """Json schema definition of the dropdown."""
 
-        return {"type": "integer", "maximum": len(self.choices) - 1}
+        return {
+            "type": "integer",
+            "maximum": len(self.choices) - 1,
+            **super().schema_definition,
+        }
 
     @property
     def sample_value(self) -> int:

PyPDFForm/middleware/radio.py

@@ -22,7 +22,11 @@ class Radio(Checkbox):
     def schema_definition(self) -> dict:
         """Json schema definition of the radiobutton."""
 
-        return {"type": "integer", "maximum": self.number_of_options - 1}
+        return {
+            "maximum": self.number_of_options - 1,
+            **super().schema_definition,
+            "type": "integer",
+        }
 
     @property
     def sample_value(self) -> int:

PyPDFForm/middleware/text.py

@@ -1,6 +1,8 @@
 # -*- coding: utf-8 -*-
 """Contains text middleware."""
 
+from typing import Any
+
 from .base import Widget
 
 
@@ -27,6 +29,21 @@ class Text(Widget):
         self.text_line_x_coordinates = None
         self.preview = False
 
+    @property
+    def value(self) -> Any:
+        """Value to fill for the text field."""
+
+        if isinstance(self._value, (int, float)):
+            return str(self._value)
+
+        return self._value
+
+    @value.setter
+    def value(self, value: str) -> None:
+        """Sets value to fill for the text field."""
+
+        self._value = value
+
     @property
     def schema_definition(self) -> dict:
         """Json schema definition of the text field."""
@@ -36,7 +53,7 @@ class Text(Widget):
         if self.max_length is not None:
             result["maxLength"] = self.max_length
 
-        return result
+        return {**result, **super().schema_definition}
 
     @property
     def sample_value(self) -> str:

PyPDFForm/patterns.py

@@ -5,7 +5,7 @@ from pypdf.generic import (DictionaryObject, NameObject, NumberObject,
                            TextStringObject)
 
 from .constants import (AP, AS, CA, DA, DV, FT, IMAGE_FIELD_IDENTIFIER, JS, MK,
-                        MULTILINE, READ_ONLY, A, Btn, Ch, Ff, N, Off, Opt,
+                        MULTILINE, READ_ONLY, TU, A, Btn, Ch, Ff, N, Off, Opt,
                         Parent, Q, Sig, T, Tx, V, Yes)
 from .middleware.checkbox import Checkbox
 from .middleware.dropdown import Dropdown
@@ -68,6 +68,8 @@ WIDGET_KEY_PATTERNS = [
     {Parent: {T: True}},
 ]
 
+WIDGET_DESCRIPTION_PATTERNS = [{TU: True}, {Parent: {TU: True}}]
+
 DROPDOWN_CHOICE_PATTERNS = [
     {Opt: True},
     {Parent: {Opt: True}},

PyPDFForm/template.py

@@ -21,8 +21,8 @@ from .middleware.radio import Radio
 from .middleware.text import Text
 from .patterns import (BUTTON_STYLE_PATTERNS, DROPDOWN_CHOICE_PATTERNS,
                        TEXT_FIELD_FLAG_PATTERNS, WIDGET_ALIGNMENT_PATTERNS,
-                       WIDGET_KEY_PATTERNS, WIDGET_TYPE_PATTERNS,
-                       update_annotation_name)
+                       WIDGET_DESCRIPTION_PATTERNS, WIDGET_KEY_PATTERNS,
+                       WIDGET_TYPE_PATTERNS, update_annotation_name)
 from .utils import find_pattern_match, stream_to_io, traverse_pattern
 from .watermark import create_watermarks_and_draw
 
@@ -51,10 +51,9 @@ def build_widgets(pdf_stream: bytes) -> Dict[str, WIDGET_TYPES]:
     for widgets in get_widgets_by_page(pdf_stream).values():
         for widget in widgets:
             key = get_widget_key(widget)
-
             _widget = construct_widget(widget, key)
-
             if _widget is not None:
+                _widget.desc = get_widget_description(widget)
                 if isinstance(_widget, Text):
                     _widget.max_length = get_text_field_max_length(widget)
                     if _widget.max_length is not None and is_text_field_comb(widget):
@@ -74,7 +73,6 @@ def build_widgets(pdf_stream: bytes) -> Dict[str, WIDGET_TYPES]:
                     continue
 
                 results[key] = _widget
-
     return results
 
 
@@ -225,6 +223,18 @@ def get_text_field_max_length(widget: dict) -> Union[int, None]:
     return int(widget[MaxLen]) or None if MaxLen in widget else None
 
 
+def get_widget_description(widget: dict) -> Union[str, None]:
+    """Returns the description of the widget if presented or None."""
+
+    result = None
+    for pattern in WIDGET_DESCRIPTION_PATTERNS:
+        value = traverse_pattern(pattern, widget)
+        if value:
+            result = str(value)
+            break
+    return result
+
+
 def check_field_flag_bit(widget: dict, bit: int) -> bool:
     """Checks if a bit is set in a widget's field flag."""
 
@@ -408,39 +418,41 @@ def get_paragraph_auto_wrap_length(widget_middleware: Text) -> int:
     return result
 
 
-def update_widget_key(
+def update_widget_keys(
     template: bytes,
     widgets: Dict[str, WIDGET_TYPES],
-    old_key: str,
-    new_key: str,
-    index: int,
+    old_keys: List[str],
+    new_keys: List[str],
+    indices: List[int],
 ) -> bytes:
-    """Updates the key of a widget."""
+    """Updates a list of keys of widgets."""
     # pylint: disable=R0801
 
     pdf = PdfReader(stream_to_io(template))
     out = PdfWriter()
     out.append(pdf)
 
-    tracker = -1
-
-    for page in out.pages:
-        for annot in page.get(Annots, []):  # noqa
-            annot = cast(DictionaryObject, annot.get_object())
-            key = get_widget_key(annot.get_object())
-
-            widget = widgets.get(key)
-            if widget is None:
-                continue
+    for i, old_key in enumerate(old_keys):
+        index = indices[i]
+        new_key = new_keys[i]
+        tracker = -1
+        for page in out.pages:
+            for annot in page.get(Annots, []):  # noqa
+                annot = cast(DictionaryObject, annot.get_object())
+                key = get_widget_key(annot.get_object())
+
+                widget = widgets.get(key)
+                if widget is None:
+                    continue
 
-            if old_key != key:
-                continue
+                if old_key != key:
+                    continue
 
-            tracker += 1
-            if not isinstance(widget, Radio) and tracker != index:
-                continue
+                tracker += 1
+                if not isinstance(widget, Radio) and tracker != index:
+                    continue
 
-            update_annotation_name(annot, new_key)
+                update_annotation_name(annot, new_key)
 
     with BytesIO() as f:
         out.write(f)

PyPDFForm/wrapper.py

@@ -18,7 +18,7 @@ from .middleware.dropdown import Dropdown
 from .middleware.text import Text
 from .template import (build_widgets, dropdown_to_text,
                        set_character_x_paddings, update_text_field_attributes,
-                       update_widget_key, widget_rect_watermarks)
+                       update_widget_keys, widget_rect_watermarks)
 from .utils import (get_page_streams, merge_two_pdfs, preview_widget_to_draw,
                     remove_all_widgets)
 from .watermark import create_watermarks_and_draw, merge_watermarks_with_pdf
@@ -79,17 +79,35 @@ class PdfWrapper(FormWrapper):
         """Constructs all attributes for the object."""
 
         super().__init__(template)
-        self.widgets = build_widgets(self.stream) if self.stream else {}
+        self.widgets = {}
+        self._keys_to_update = []
 
         self.global_font = kwargs.get("global_font")
         self.global_font_size = kwargs.get("global_font_size")
         self.global_font_color = kwargs.get("global_font_color")
 
-        for each in self.widgets.values():
-            if isinstance(each, Text):
-                each.font = self.global_font
-                each.font_size = self.global_font_size
-                each.font_color = self.global_font_color
+        self._init_helper()
+
+    def _init_helper(self, key_to_refresh: str = None) -> None:
+        """Updates all attributes when the state of the PDF stream changes."""
+
+        refresh_not_needed = {}
+        new_widgets = build_widgets(self.read()) if self.read() else {}
+        for k, v in self.widgets.items():
+            if k in new_widgets:
+                new_widgets[k] = v
+                refresh_not_needed[k] = True
+        self.widgets = new_widgets
+
+        for key, value in self.widgets.items():
+            if (key_to_refresh and key == key_to_refresh) or (
+                key_to_refresh is None
+                and isinstance(value, Text)
+                and not refresh_not_needed.get(key)
+            ):
+                value.font = self.global_font
+                value.font_size = self.global_font_size
+                value.font_color = self.global_font_color
 
     @property
     def sample_data(self) -> dict:
@@ -223,31 +241,42 @@ class PdfWrapper(FormWrapper):
                 self.stream, name, obj.non_acro_form_params
             )
 
-        new_widgets = build_widgets(self.read())
-        for k, v in self.widgets.items():
-            if k in new_widgets:
-                new_widgets[k] = v
-        self.widgets = new_widgets
+        key_to_refresh = ""
         if widget_type in ("text", "dropdown"):
-            self.widgets[name].font = self.global_font
-            self.widgets[name].font_size = self.global_font_size
-            self.widgets[name].font_color = self.global_font_color
+            key_to_refresh = name
+
+        self._init_helper(key_to_refresh)
 
         return self
 
     def update_widget_key(
-        self, old_key: str, new_key: str, index: int = 0
+        self, old_key: str, new_key: str, index: int = 0, defer: bool = False
     ) -> PdfWrapper:
         """Updates the key of an existed widget on a PDF form."""
 
-        self.__init__(
-            template=update_widget_key(
-                self.read(), self.widgets, old_key, new_key, index
-            ),
-            global_font=self.global_font,
-            global_font_size=self.global_font_size,
-            global_font_color=self.global_font_color,
+        if defer:
+            self._keys_to_update.append((old_key, new_key, index))
+            return self
+
+        self.stream = update_widget_keys(
+            self.read(), self.widgets, [old_key], [new_key], [index]
+        )
+        self._init_helper()
+
+        return self
+
+    def commit_widget_key_updates(self) -> PdfWrapper:
+        """Commits all deferred widget key updates on a PDF form."""
+
+        old_keys = [each[0] for each in self._keys_to_update]
+        new_keys = [each[1] for each in self._keys_to_update]
+        indices = [each[2] for each in self._keys_to_update]
+
+        self.stream = update_widget_keys(
+            self.read(), self.widgets, old_keys, new_keys, indices
         )
+        self._init_helper()
+        self._keys_to_update = []
 
         return self
 

{PyPDFForm-1.4.36.dist-info → PyPDFForm-1.5.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: PyPDFForm
-Version: 1.4.36
+Version: 1.5.0
 Summary: The Python library for PDF forms.
 Home-page: https://github.com/chinapandaman/PyPDFForm
 Author: Jinge Li
@@ -13,6 +13,7 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Topic :: Software Development :: Libraries :: Python Modules

PyPDFForm-1.5.0.dist-info/RECORD

@@ -0,0 +1,30 @@
+PyPDFForm/__init__.py,sha256=-JU9Sz_lN3p7mSfsgeNlTUs4CS28fueCscA5_Bhv3sg,178
+PyPDFForm/adapter.py,sha256=WFP-r8FLeKa-D9mFO9AphOcuXgyeAI1Ak0d-YsqxsK4,861
+PyPDFForm/constants.py,sha256=48mxgyY3UgiVO2UIZuDe_B8KOE5bedyujnOjk6MtzHQ,1749
+PyPDFForm/coordinate.py,sha256=V_ZZQ1pXtVPAyfMJCX7fKoEimK7XwX6bU3VQ0nKOhQA,7314
+PyPDFForm/filler.py,sha256=ztYU-Rk_LKfCw-BhmdIDnK7ez-5jSPoi2Ho3xvbO4Io,7487
+PyPDFForm/font.py,sha256=TbFLY4G72d7cQ3VG2g4HaYKROzQPQUmh6-8ynN6hzXY,5713
+PyPDFForm/image.py,sha256=sjXPg9fjenNFj12a321xHX6JvuJs6PJRGLzpSNw5mVU,1180
+PyPDFForm/patterns.py,sha256=Z548TjpQpaVepctvlRYe0-2i7Aws96fo-ncG82CUX14,5423
+PyPDFForm/template.py,sha256=6cyuFieAyQM6S-x6Sasp7dLIb8aKwtlhlOgutjoX0ks,14839
+PyPDFForm/utils.py,sha256=9omR-oT3OdZqioxpiGqA9_P0GSFC6mg4Y1xrLvWOzkk,4309
+PyPDFForm/watermark.py,sha256=L4LfzjjyJ6TDq9ad2dbtQYheBOic1_oZ7smhFFekNog,4725
+PyPDFForm/wrapper.py,sha256=n3qJVI3JRn-WKxq_CwC1tJw7AiI2Ltj8mvLDexK8U8s,11084
+PyPDFForm/middleware/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+PyPDFForm/middleware/base.py,sha256=xMg6X6-hJgvV-e_2rRJHBRO7gGICcBsnvUzxtF2XtVs,1120
+PyPDFForm/middleware/checkbox.py,sha256=0EWFECXYdz9SNxgGe1QCcRrdxLVUIJpzRYwKfGRA9e4,1346
+PyPDFForm/middleware/dropdown.py,sha256=_RXs9o3vWH_a402zhTOYE_mcWbtFfVU7bReYcEFAIyk,793
+PyPDFForm/middleware/image.py,sha256=xjPxRiGBWFEU3EQGGqJXY1iMX1kmr0jO8O9iVUC5rcc,177
+PyPDFForm/middleware/radio.py,sha256=uffpK15U1gUn7mkyOcMwZByZo-I2cMWWsW3sBb1WeYk,801
+PyPDFForm/middleware/signature.py,sha256=m7tNvGZ7fQ0yuVKzSlLbNQ2IILo1GDnjzMDzMnYCKVM,1104
+PyPDFForm/middleware/text.py,sha256=7HFHy_lfBFfYbSUzgVKovSoShbNP6L7tiILIw-9_kpo,1549
+PyPDFForm/widgets/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+PyPDFForm/widgets/base.py,sha256=nb6HEfRdWSjZc_Th1XI62PIlgREn_JiApGC-epb6jAg,3348
+PyPDFForm/widgets/checkbox.py,sha256=MGB6NGI-XMBz4j2erykgYOCd1pswvthuQ6UFowQOd4o,503
+PyPDFForm/widgets/dropdown.py,sha256=2_R5xcLUWAL0G4raVgWWtE7TJdiWJITay-Gtl8YI2QI,705
+PyPDFForm/widgets/text.py,sha256=sCB8CQAjh30QOGr8FTIDSk3X6dXSHJztOz6YkKEBDss,691
+PyPDFForm-1.5.0.dist-info/LICENSE,sha256=43awmYkI6opyTpg19me731iO1WfXZwViqb67oWtCsFY,1065
+PyPDFForm-1.5.0.dist-info/METADATA,sha256=OzbNc9l4HTogbGqi45TaQzEGQaLr3sQStxf-84dI49Y,4201
+PyPDFForm-1.5.0.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
+PyPDFForm-1.5.0.dist-info/top_level.txt,sha256=GQQKuWqPUjT9YZqwK95NlAQzxjwoQrsxQ8ureM8lWOY,10
+PyPDFForm-1.5.0.dist-info/RECORD,,

{PyPDFForm-1.4.36.dist-info → PyPDFForm-1.5.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.1.0)
+Generator: setuptools (75.6.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

PyPDFForm-1.4.36.dist-info/RECORD

@@ -1,30 +0,0 @@
-PyPDFForm/__init__.py,sha256=piytcpUIHLfdyWTQOM9ZDn1CgeF0GlRVciqihHGpihQ,179
-PyPDFForm/adapter.py,sha256=WFP-r8FLeKa-D9mFO9AphOcuXgyeAI1Ak0d-YsqxsK4,861
-PyPDFForm/constants.py,sha256=FMsdOvnYpchEfki3gf_Y2Wj1SThUxMzsPbOx12_S1GA,1738
-PyPDFForm/coordinate.py,sha256=V_ZZQ1pXtVPAyfMJCX7fKoEimK7XwX6bU3VQ0nKOhQA,7314
-PyPDFForm/filler.py,sha256=ztYU-Rk_LKfCw-BhmdIDnK7ez-5jSPoi2Ho3xvbO4Io,7487
-PyPDFForm/font.py,sha256=TbFLY4G72d7cQ3VG2g4HaYKROzQPQUmh6-8ynN6hzXY,5713
-PyPDFForm/image.py,sha256=sjXPg9fjenNFj12a321xHX6JvuJs6PJRGLzpSNw5mVU,1180
-PyPDFForm/patterns.py,sha256=NluZyGSiKTV8ijqvBYSV8q389TuijI4wbv6fooHD6hk,5353
-PyPDFForm/template.py,sha256=AaJ9qHw2Fw-51CRSfOy4POeEvFlKJ5h-WdqlFsGBuY4,14230
-PyPDFForm/utils.py,sha256=9omR-oT3OdZqioxpiGqA9_P0GSFC6mg4Y1xrLvWOzkk,4309
-PyPDFForm/watermark.py,sha256=L4LfzjjyJ6TDq9ad2dbtQYheBOic1_oZ7smhFFekNog,4725
-PyPDFForm/wrapper.py,sha256=PRtiLJAtO3Sbpvr3qDy1ElitSRcNghpbkwSSiCMQ-7E,10231
-PyPDFForm/middleware/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-PyPDFForm/middleware/base.py,sha256=p-3XsZJ6d7ai2JFLF7LisMWi9yzM3pN7CsFECxtEoI0,751
-PyPDFForm/middleware/checkbox.py,sha256=3-9CMhhtyO9U6lLXDciW-59ng8uS4m6_clPB02mzV9c,1317
-PyPDFForm/middleware/dropdown.py,sha256=7_DuacMQCRvp2pYxDvzEjUNKDUsTfU0aGTRMBtYWTIA,692
-PyPDFForm/middleware/image.py,sha256=xjPxRiGBWFEU3EQGGqJXY1iMX1kmr0jO8O9iVUC5rcc,177
-PyPDFForm/middleware/radio.py,sha256=ZDrRRF0Tu_3VBQ69x0G-IaZVf8FSOVz8xVpQsyiKhBc,725
-PyPDFForm/middleware/signature.py,sha256=m7tNvGZ7fQ0yuVKzSlLbNQ2IILo1GDnjzMDzMnYCKVM,1104
-PyPDFForm/middleware/text.py,sha256=BvdfmHu3GIWPMALahhHOz39mJPuMBx0c9ubYwi2kSZk,1144
-PyPDFForm/widgets/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-PyPDFForm/widgets/base.py,sha256=nb6HEfRdWSjZc_Th1XI62PIlgREn_JiApGC-epb6jAg,3348
-PyPDFForm/widgets/checkbox.py,sha256=MGB6NGI-XMBz4j2erykgYOCd1pswvthuQ6UFowQOd4o,503
-PyPDFForm/widgets/dropdown.py,sha256=2_R5xcLUWAL0G4raVgWWtE7TJdiWJITay-Gtl8YI2QI,705
-PyPDFForm/widgets/text.py,sha256=sCB8CQAjh30QOGr8FTIDSk3X6dXSHJztOz6YkKEBDss,691
-PyPDFForm-1.4.36.dist-info/LICENSE,sha256=43awmYkI6opyTpg19me731iO1WfXZwViqb67oWtCsFY,1065
-PyPDFForm-1.4.36.dist-info/METADATA,sha256=bDAjb3toOHXX-5hMPJQSWEzzcMDRoHCOkYgDWoxh4hM,4151
-PyPDFForm-1.4.36.dist-info/WHEEL,sha256=GV9aMThwP_4oNCtvEC2ec3qUYutgWeAzklro_0m4WJQ,91
-PyPDFForm-1.4.36.dist-info/top_level.txt,sha256=GQQKuWqPUjT9YZqwK95NlAQzxjwoQrsxQ8ureM8lWOY,10
-PyPDFForm-1.4.36.dist-info/RECORD,,