PyPDFForm 3.0.1__py3-none-any.whl → 3.1.0__py3-none-any.whl

PyPDFForm/__init__.py

@@ -20,7 +20,7 @@ The library supports various PDF form features, including:
 PyPDFForm aims to simplify PDF form manipulation, making it accessible to developers of all skill levels.
 """
 
-__version__ = "3.0.1"
+__version__ = "3.1.0"
 
 from .middleware.text import Text  # exposing for setting global font attrs
 from .wrapper import PdfWrapper

PyPDFForm/filler.py

@@ -15,6 +15,7 @@ from pypdf import PdfReader, PdfWriter
 from pypdf.generic import DictionaryObject
 
 from .constants import WIDGET_TYPES, Annots
+from .hooks import flatten_generic, flatten_radio
 from .image import get_draw_image_resolutions, get_image_dimensions
 from .middleware.checkbox import Checkbox
 from .middleware.dropdown import Dropdown
@@ -22,9 +23,8 @@ from .middleware.image import Image
 from .middleware.radio import Radio
 from .middleware.signature import Signature
 from .middleware.text import Text
-from .patterns import (flatten_generic, flatten_radio, update_checkbox_value,
-                       update_dropdown_value, update_radio_value,
-                       update_text_value)
+from .patterns import (update_checkbox_value, update_dropdown_value,
+                       update_radio_value, update_text_value)
 from .template import get_widget_key
 from .utils import stream_to_io
 from .watermark import create_watermarks_and_draw, merge_watermarks_with_pdf
@@ -145,7 +145,9 @@ def fill(
 
             # flatten all
             if flatten:
-                (flatten_radio if isinstance(widget, Radio) else flatten_generic)(annot)
+                (flatten_radio if isinstance(widget, Radio) else flatten_generic)(
+                    annot, True
+                )
             if widget.value is None:
                 continue
 

PyPDFForm/hooks.py

@@ -4,7 +4,8 @@ This module defines widget hooks that allow for dynamic modification of PDF form
 
 It provides functions to trigger these hooks, enabling changes to text field properties
 like font, font size, color, alignment, and multiline settings, as well as the size
-of checkbox and radio button widgets. These hooks are triggered during the PDF form
+of checkbox and radio button widgets. It also provides functions for flattening
+generic and radio button widgets. These hooks are triggered during the PDF form
 filling process, allowing for customization of the form's appearance and behavior.
 """
 
@@ -17,7 +18,7 @@ from pypdf.generic import (ArrayObject, DictionaryObject, FloatObject,
                            NameObject, NumberObject, TextStringObject)
 
 from .constants import (COMB, DA, FONT_COLOR_IDENTIFIER, FONT_SIZE_IDENTIFIER,
-                        MULTILINE, Annots, Ff, Opt, Parent, Q, Rect)
+                        MULTILINE, READ_ONLY, Annots, Ff, Opt, Parent, Q, Rect)
 from .template import get_widget_key
 from .utils import stream_to_io
 
@@ -249,8 +250,78 @@ def update_dropdown_choices(annot: DictionaryObject, val: list) -> None:
 
     Args:
         annot (DictionaryObject): The annotation dictionary for the dropdown field.
-        val (list): A list of strings representing the new choices for the dropdown.
+        val (list): A list of strings or tuples representing the new choices for the dropdown.
     """
     annot[NameObject(Opt)] = ArrayObject(
-        [ArrayObject([TextStringObject(each), TextStringObject(each)]) for each in val]
+        [
+            (
+                ArrayObject([TextStringObject(each[1]), TextStringObject(each[0])])
+                if isinstance(each, tuple)
+                else ArrayObject([TextStringObject(each), TextStringObject(each)])
+            )
+            for each in val
+        ]
     )
+
+
+def flatten_radio(annot: DictionaryObject, val: bool) -> None:
+    """
+    Flattens a radio button annotation by setting or unsetting the ReadOnly flag,
+    making it non-editable or editable based on the `val` parameter.
+
+    This function modifies the Ff (flags) entry in the radio button's annotation
+    dictionary or its parent dictionary if `Parent` exists in `annot`, to set or
+    unset the ReadOnly flag, preventing or allowing the user from changing the
+    selected option.
+
+    Args:
+        annot (DictionaryObject): The radio button annotation dictionary.
+        val (bool): True to flatten (make read-only), False to unflatten (make editable).
+    """
+    if Parent in annot:
+        annot[NameObject(Parent)][NameObject(Ff)] = NumberObject(
+            (
+                int(annot[NameObject(Parent)].get(NameObject(Ff), 0)) | READ_ONLY
+                if val
+                else int(annot[NameObject(Parent)].get(NameObject(Ff), 0)) & ~READ_ONLY
+            )
+        )
+    else:
+        annot[NameObject(Ff)] = NumberObject(
+            (
+                int(annot.get(NameObject(Ff), 0)) | READ_ONLY
+                if val
+                else int(annot.get(NameObject(Ff), 0)) & ~READ_ONLY
+            )
+        )
+
+
+def flatten_generic(annot: DictionaryObject, val: bool) -> None:
+    """
+    Flattens a generic annotation by setting or unsetting the ReadOnly flag,
+    making it non-editable or editable based on the `val` parameter.
+
+    This function modifies the Ff (flags) entry in the annotation dictionary to
+    set or unset the ReadOnly flag, preventing or allowing the user from
+    interacting with the form field.
+
+    Args:
+        annot (DictionaryObject): The annotation dictionary.
+        val (bool): True to flatten (make read-only), False to unflatten (make editable).
+    """
+    if Parent in annot and Ff not in annot:
+        annot[NameObject(Parent)][NameObject(Ff)] = NumberObject(
+            (
+                int(annot.get(NameObject(Ff), 0)) | READ_ONLY
+                if val
+                else int(annot.get(NameObject(Ff), 0)) & ~READ_ONLY
+            )
+        )
+    else:
+        annot[NameObject(Ff)] = NumberObject(
+            (
+                int(annot.get(NameObject(Ff), 0)) | READ_ONLY
+                if val
+                else int(annot.get(NameObject(Ff), 0)) & ~READ_ONLY
+            )
+        )

PyPDFForm/middleware/base.py

@@ -21,7 +21,9 @@ class Widget:
     as name, value, and schema definition.
     """
 
-    SET_ATTR_TRIGGER_HOOK_MAP = {}
+    SET_ATTR_TRIGGER_HOOK_MAP = {
+        "readonly": "flatten_generic",
+    }
 
     def __init__(
         self,
@@ -39,6 +41,7 @@ class Widget:
         self._name = name
         self._value = value
         self.desc = None
+        self.readonly = None
         self.hooks_to_trigger = []
 
     def __setattr__(self, name: str, value: Any) -> None:

PyPDFForm/middleware/checkbox.py

@@ -20,10 +20,6 @@ class Checkbox(Widget):
     implements the schema_definition and sample_value properties.
     """
 
-    SET_ATTR_TRIGGER_HOOK_MAP = {
-        "size": "update_check_radio_size",
-    }
-
     def __init__(
         self,
         name: str,
@@ -39,6 +35,11 @@ class Checkbox(Widget):
         Attributes:
             size (int): The size of the checkbox. Defaults to None.
         """
+        self.SET_ATTR_TRIGGER_HOOK_MAP.update(
+            {
+                "size": "update_check_radio_size",
+            }
+        )
         super().__init__(name, value)
 
         self.size = None

PyPDFForm/middleware/dropdown.py

@@ -26,11 +26,6 @@ class Dropdown(Widget):
         sample_value: Returns a sample value for the dropdown.
     """
 
-    SET_ATTR_TRIGGER_HOOK_MAP = {
-        "font": "update_text_field_font",
-        "choices": "update_dropdown_choices",
-    }
-
     def __init__(
         self,
         name: str,
@@ -47,6 +42,12 @@ class Dropdown(Widget):
             font (str): The font of the dropdown field.
             choices (List[str]): The list of choices for the dropdown.
         """
+        self.SET_ATTR_TRIGGER_HOOK_MAP.update(
+            {
+                "font": "update_text_field_font",
+                "choices": "update_dropdown_choices",
+            }
+        )
         super().__init__(name, value)
 
         self.font = None

PyPDFForm/middleware/radio.py

@@ -34,6 +34,11 @@ class Radio(Checkbox):
         Attributes:
             number_of_options (int): The number of options for the radio button.
         """
+        self.SET_ATTR_TRIGGER_HOOK_MAP.update(
+            {
+                "readonly": "flatten_radio",
+            }
+        )
         super().__init__(name, value)
 
         self.number_of_options = 0

PyPDFForm/middleware/text.py

@@ -22,15 +22,6 @@ class Text(Widget):
     font_size, font_color, comb, alignment, and multiline.
     """
 
-    SET_ATTR_TRIGGER_HOOK_MAP = {
-        "font": "update_text_field_font",
-        "font_size": "update_text_field_font_size",
-        "font_color": "update_text_field_font_color",
-        "comb": "update_text_field_comb",
-        "alignment": "update_text_field_alignment",
-        "multiline": "update_text_field_multiline",
-    }
-
     def __init__(
         self,
         name: str,
@@ -52,6 +43,16 @@ class Text(Widget):
             multiline (bool): Whether the text field is multiline. Defaults to None.
             max_length (int): The maximum length of the text field. Defaults to None.
         """
+        self.SET_ATTR_TRIGGER_HOOK_MAP.update(
+            {
+                "font": "update_text_field_font",
+                "font_size": "update_text_field_font_size",
+                "font_color": "update_text_field_font_color",
+                "comb": "update_text_field_comb",
+                "alignment": "update_text_field_alignment",
+                "multiline": "update_text_field_multiline",
+            }
+        )
         super().__init__(name, value)
 
         self.font = None

PyPDFForm/patterns.py

@@ -5,15 +5,14 @@ This module defines patterns and utility functions for interacting with PDF form
 It includes patterns for identifying different types of widgets (e.g., text fields,
 checkboxes, radio buttons, dropdowns, images, and signatures) based on their
 properties in the PDF's annotation dictionary. It also provides utility functions
-for updating and flattening these widgets.
+for updating these widgets.
 """
 
 from pypdf.generic import (ArrayObject, DictionaryObject, NameObject,
                            NumberObject, TextStringObject)
 
-from .constants import (AP, AS, DV, FT, IMAGE_FIELD_IDENTIFIER, JS, READ_ONLY,
-                        TU, A, Btn, Ch, Ff, I, N, Off, Opt, Parent, Sig, T, Tx,
-                        V, Yes)
+from .constants import (AP, AS, DV, FT, IMAGE_FIELD_IDENTIFIER, JS, TU, A, Btn,
+                        Ch, I, N, Off, Opt, Parent, Sig, T, Tx, V, Yes)
 from .middleware.checkbox import Checkbox
 from .middleware.dropdown import Dropdown
 from .middleware.image import Image
@@ -177,42 +176,6 @@ def update_text_value(annot: DictionaryObject, widget: Text) -> None:
         annot[NameObject(AP)] = TextStringObject(widget.value)
 
 
-def flatten_radio(annot: DictionaryObject) -> None:
-    """
-    Flattens a radio button annotation by setting the ReadOnly flag, making it non-editable.
-
-    This function modifies the Ff (flags) entry in the radio button's parent
-    dictionary to set the ReadOnly flag, preventing the user from changing the
-    selected option.
-
-    Args:
-        annot (DictionaryObject): The radio button annotation dictionary.
-    """
-    annot[NameObject(Parent)][NameObject(Ff)] = NumberObject(
-        int(annot[NameObject(Parent)].get(NameObject(Ff), 0)) | READ_ONLY
-    )
-
-
-def flatten_generic(annot: DictionaryObject) -> None:
-    """
-    Flattens a generic annotation by setting the ReadOnly flag, making it non-editable.
-
-    This function modifies the Ff (flags) entry in the annotation dictionary to
-    set the ReadOnly flag, preventing the user from interacting with the form field.
-
-    Args:
-        annot (DictionaryObject): The annotation dictionary.
-    """
-    if Parent in annot and Ff not in annot:
-        annot[NameObject(Parent)][NameObject(Ff)] = NumberObject(
-            int(annot.get(NameObject(Ff), 0)) | READ_ONLY
-        )
-    else:
-        annot[NameObject(Ff)] = NumberObject(
-            int(annot.get(NameObject(Ff), 0)) | READ_ONLY
-        )
-
-
 def update_annotation_name(annot: DictionaryObject, val: str) -> None:
     """
     Updates the name of an annotation, setting the T (title) entry.

{pypdfform-3.0.1.dist-info → pypdfform-3.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyPDFForm
-Version: 3.0.1
+Version: 3.1.0
 Summary: The Python library for PDF forms.
 Author: Jinge Li
 License-Expression: MIT

{pypdfform-3.0.1.dist-info → pypdfform-3.1.0.dist-info}/RECORD

@@ -1,24 +1,24 @@
-PyPDFForm/__init__.py,sha256=fU6FXBvP7HiJDQK5BgFx4eTbgpGsOH9hZ6Xwf02-L_I,925
+PyPDFForm/__init__.py,sha256=R4BorFo4mdXpjdpfUiO6kvJpowukDOHSiRpfHBV2jYs,925
 PyPDFForm/adapter.py,sha256=8E_PZlXU1ALWez_pWF_U52cynzowK_NQFYzMJoH9VUk,2428
 PyPDFForm/constants.py,sha256=WQjBvYTryj5gxxeXECPgHplXXXmqHNeVbgmhvlLDCpA,2443
 PyPDFForm/coordinate.py,sha256=VMVkqa-VAGJSGVvetZwOxeMzIgQtQdvtn_DI_qSecCE,3876
-PyPDFForm/filler.py,sha256=YgYYUKyG4n6ADmE7vjlorbqDVbhU3LEJn1H3Ptl26CA,7233
+PyPDFForm/filler.py,sha256=KwStL6YzrNBcDd919ig83MnAxopi8Vnz3QNJzN_CjNM,7272
 PyPDFForm/font.py,sha256=EZSAHnkzaBo96p9XJrQDMcEhjh5BZ8p7WwFC3SbKRMM,8828
-PyPDFForm/hooks.py,sha256=myL6RS82uz4oM3mufOgFuyfMWkhhUwNNgWYLkMUuUtk,9016
+PyPDFForm/hooks.py,sha256=A8p67ubWvCvzRt346Q7BjOvbi4_NXBcynXmq6fJTadY,11679
 PyPDFForm/image.py,sha256=CAC69jEfSbWbyNJcjLhjWVSNJuFh7frMI70eaiFayHw,3823
-PyPDFForm/patterns.py,sha256=pv2a5aJD3xv9pJddtOu_Ol7A6p0VWlDcnHyW1diqeIM,7151
+PyPDFForm/patterns.py,sha256=xuKAqGf07f3WFXwASnrmcS073pSEcR9lQMqLppjkQ2E,5829
 PyPDFForm/template.py,sha256=aGhwezcynmwCEck1SUNlQvgfupn-plV9mV2FF2RNn_M,9188
 PyPDFForm/utils.py,sha256=RX2mOP2uCIcN_JcTalCdYKhnYtyYc8dUIqg1wP_7MJA,10867
 PyPDFForm/watermark.py,sha256=9p1tjaIqicXngTNai_iOEkCoXRYnR66azB4s7wNsZUw,9349
 PyPDFForm/wrapper.py,sha256=Ysd1mkvE5OfDkjUI6mNFIt16-JUKwj2ifbp1MioWPUo,25257
 PyPDFForm/middleware/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-PyPDFForm/middleware/base.py,sha256=67ZRxAs5wFLoIZ8JxviINswBIIanh_5IsiX1p3nWZC8,3001
-PyPDFForm/middleware/checkbox.py,sha256=cxcfi0Vm9ZPJJQAbMWn2fUinLaGpiUD47QkzC-t2kVQ,1811
-PyPDFForm/middleware/dropdown.py,sha256=wfVx_O94yTJA0ww65kbgGocH0zXtCZTlBR2Ak-qwYls,2301
+PyPDFForm/middleware/base.py,sha256=J8mlVIzC0QrljNAjRjGm0ns6w1MJOVp5cRSyqN1Bv_Q,3074
+PyPDFForm/middleware/checkbox.py,sha256=GVYVXRDFQ_nj720Vsol2kkyBf3UqTtKOXDxY0O_2moM,1863
+PyPDFForm/middleware/dropdown.py,sha256=hzXTLwvHob8EyI1ePJgqMoxePfPiE4FpPehvWD6pdvc,2361
 PyPDFForm/middleware/image.py,sha256=oeXaThV9hEpHsTwH7VT4qbreh_5tsS1dwA1E_eHe61o,579
-PyPDFForm/middleware/radio.py,sha256=L-D669dQ-j5y867WZLjtglyqyDFpL84TcwlKAp_cJhE,2076
+PyPDFForm/middleware/radio.py,sha256=4XQU8zjPzZoEx0v_ukKpHPuUhLHyAKFrAwoMVy3nC8I,2206
 PyPDFForm/middleware/signature.py,sha256=I0ygzfgodREUAEfEA2AzIszAVFg4In_K-l4bAKZiImE,2143
-PyPDFForm/middleware/text.py,sha256=VJ5MCw8Lx_U8eZJcxAjTvttW2qEoyybIvtlrCReP3bE,3803
+PyPDFForm/middleware/text.py,sha256=HAMsLiuX0iQZnsrenlc_QJdJ2R46sxQ0Fn5VTHla9_k,3895
 PyPDFForm/widgets/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 PyPDFForm/widgets/base.py,sha256=kOfxV8HSmwXoy0vFYPgJKKDQ7RUNMACWfX6T4HeJeOU,5177
 PyPDFForm/widgets/bedrock.py,sha256=j6beU04kaQzpAIFZHI5VJLaDT5RVAAa6LzkU1luJpN8,137660
@@ -28,8 +28,8 @@ PyPDFForm/widgets/image.py,sha256=aSD-3MEZFIRL7HYVuO6Os8irfSUOLHA_rHGkqcEIPPA,85
 PyPDFForm/widgets/radio.py,sha256=nWSQQp06kRISO7Q7FVFeB3PXYvMOSc0SMhRs1bHTxeQ,2261
 PyPDFForm/widgets/signature.py,sha256=EqIRIuKSQEg8LJZ_Mu859eEvs0dwO-mzkMNuhHG1Vsg,4034
 PyPDFForm/widgets/text.py,sha256=gtheE6_w0vQPRJJ9oj_l9FaMDEGnPtvVR6_axsrmxKI,1540
-pypdfform-3.0.1.dist-info/licenses/LICENSE,sha256=43awmYkI6opyTpg19me731iO1WfXZwViqb67oWtCsFY,1065
-pypdfform-3.0.1.dist-info/METADATA,sha256=AU8iGNQzMZynQLF-7jeMio5xJg4jjHLXYWqsaxuJ59I,4587
-pypdfform-3.0.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-pypdfform-3.0.1.dist-info/top_level.txt,sha256=GQQKuWqPUjT9YZqwK95NlAQzxjwoQrsxQ8ureM8lWOY,10
-pypdfform-3.0.1.dist-info/RECORD,,
+pypdfform-3.1.0.dist-info/licenses/LICENSE,sha256=43awmYkI6opyTpg19me731iO1WfXZwViqb67oWtCsFY,1065
+pypdfform-3.1.0.dist-info/METADATA,sha256=-vHzFtOdPxAwCjPm98xvD424mC3Yc0KttyMir2HvPjE,4587
+pypdfform-3.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+pypdfform-3.1.0.dist-info/top_level.txt,sha256=GQQKuWqPUjT9YZqwK95NlAQzxjwoQrsxQ8ureM8lWOY,10
+pypdfform-3.1.0.dist-info/RECORD,,