PyPDFForm 3.5.0__py3-none-any.whl → 3.5.2__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.5.0"
+__version__ = "3.5.2"
 
 from .middleware.text import Text  # exposing for setting global font attrs
 from .widgets import Fields

PyPDFForm/hooks.py

@@ -83,19 +83,31 @@ def update_text_field_font(annot: DictionaryObject, val: str) -> None:
     Updates the font of a text field annotation.
 
     This function modifies the appearance string (DA) in the annotation dictionary
-    to change the font used for the text field.
+    to change the font used for the text field. It ensures that the provided font
+    name is a proper PDF font by checking if it starts with a slash "/".
+    The function then correctly identifies and updates the font in the appearance
+    stream by locating the existing font identifier (which also starts with a slash).
 
     Args:
         annot (DictionaryObject): The annotation dictionary for the text field.
-        val (str): The new font name to use for the text field.
+        val (str): The new font name to use for the text field. Must start with "/".
     """
+    if not val.startswith("/"):
+        return
     if Parent in annot and DA not in annot:
         text_appearance = annot[Parent][DA]
     else:
         text_appearance = annot[DA]
 
     text_appearance = text_appearance.split(" ")
-    text_appearance[0] = val
+
+    index_to_update = 0
+    for i, each in enumerate(text_appearance):
+        if each.startswith("/"):
+            index_to_update = i
+            break
+
+    text_appearance[index_to_update] = val
     new_text_appearance = " ".join(text_appearance)
 
     if Parent in annot and DA not in annot:

PyPDFForm/patterns.py

@@ -17,8 +17,9 @@ from typing import Union
 from pypdf.generic import (ArrayObject, DictionaryObject, NameObject,
                            NumberObject, TextStringObject)
 
-from .constants import (AP, AS, DV, FT, IMAGE_FIELD_IDENTIFIER, JS, SLASH, TU,
-                        A, Btn, Ch, I, N, Off, Opt, Parent, Sig, T, Tx, V, Yes)
+from .constants import (AP, AS, DV, FT, IMAGE_FIELD_IDENTIFIER, JS, MULTILINE,
+                        SLASH, TU, A, Btn, Ch, Ff, 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
@@ -277,3 +278,29 @@ def update_annotation_name(annot: DictionaryObject, val: str) -> None:
         annot[NameObject(Parent)][NameObject(T)] = TextStringObject(val)
     else:
         annot[NameObject(T)] = TextStringObject(val)
+
+
+def get_text_field_multiline(annot: DictionaryObject) -> bool:
+    """
+    Checks if a text field annotation is multiline.
+
+    This function inspects the 'Ff' (field flags) entry of the text annotation
+    dictionary (or its parent if it's a child annotation) to determine if the
+    Multiline flag is set.
+
+    Args:
+        annot (DictionaryObject): The text annotation dictionary.
+
+    Returns:
+        bool: True if the text field is multiline, False otherwise.
+    """
+    if Parent in annot and Ff not in annot:
+        return bool(
+            int(
+                annot[NameObject(Parent)][NameObject(Ff)]
+                if Ff in annot[NameObject(Parent)]
+                else 0
+            )
+            & MULTILINE
+        )
+    return bool(int(annot[NameObject(Ff)] if Ff in annot else 0) & MULTILINE)

PyPDFForm/template.py

@@ -28,7 +28,8 @@ from .middleware.text import Text
 from .patterns import (DROPDOWN_CHOICE_PATTERNS, WIDGET_DESCRIPTION_PATTERNS,
                        WIDGET_KEY_PATTERNS, WIDGET_TYPE_PATTERNS,
                        get_checkbox_value, get_dropdown_value, get_radio_value,
-                       get_text_value, update_annotation_name)
+                       get_text_field_multiline, get_text_value,
+                       update_annotation_name)
 from .utils import extract_widget_property, find_pattern_match, stream_to_io
 
 
@@ -69,6 +70,7 @@ def build_widgets(
                     # mostly for schema for now
                     # doesn't trigger hook
                     _widget.__dict__["max_length"] = get_text_field_max_length(widget)
+                    _widget.__dict__["multiline"] = get_text_field_multiline(widget)
                     get_text_value(widget, _widget)
 
                 if type(_widget) is Checkbox:
@@ -150,20 +152,23 @@ def get_widget_key(widget: dict, use_full_widget_name: bool) -> str:
     Returns:
         str: The extracted widget key.
     """
-    key = extract_widget_property(widget, WIDGET_KEY_PATTERNS, None, str)
     if not use_full_widget_name:
-        return key
+        return extract_widget_property(widget, WIDGET_KEY_PATTERNS, None, str)
 
+    key = widget.get(T)
     if (
         Parent in widget
         and T in widget[Parent].get_object()
         and widget[Parent].get_object()[T] != key  # sejda case
     ):
-        key = (
+        if key is None:
+            return get_widget_key(widget[Parent].get_object(), use_full_widget_name)
+
+        return (
             f"{get_widget_key(widget[Parent].get_object(), use_full_widget_name)}.{key}"
         )
 
-    return key
+    return key or ""
 
 
 def construct_widget(widget: dict, key: str) -> Union[WIDGET_TYPES, None]:

{pypdfform-3.5.0.dist-info → pypdfform-3.5.2.dist-info}/METADATA

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

{pypdfform-3.5.0.dist-info → pypdfform-3.5.2.dist-info}/RECORD

@@ -1,13 +1,13 @@
-PyPDFForm/__init__.py,sha256=TBcOLWb7xcC0r6Qo7teHtwcQA97qsTX5gUay7Vfq3LY,963
+PyPDFForm/__init__.py,sha256=g66KyIWGw_i9Ncx2rTMq6ne2WeeBuvjgKFLZb_G5Vmo,963
 PyPDFForm/adapter.py,sha256=LBxHth0qJFB6rdByRJbsn4x0dftCOAolKVutZeFZm9E,2634
 PyPDFForm/constants.py,sha256=tFtomm4bSsghxRqKaMP6Tln7ug9W_72e-AAU3sEU_no,2917
 PyPDFForm/coordinate.py,sha256=veYOlRyFKIvzLISYA_f-drNBiKOzFwr0EIFCaUAzGgo,4428
 PyPDFForm/filler.py,sha256=fqGIxT3FR3cWo3SMTDYud6Ocs9SZBmSpFv5yg1v19Wk,8450
 PyPDFForm/font.py,sha256=TkiGPHIf4NxDiDzkrlXIr1r-DZC1V4aYrQAzGFxBlLI,13423
-PyPDFForm/hooks.py,sha256=tW4VGAFZupSMhtHWoGsoljOciGT2yBBuoqNCuyGsKzM,15697
+PyPDFForm/hooks.py,sha256=SFE7YlZQQpra7A2D_4ITU1TzGyfiqJk3mQUVfQHu8Bg,16210
 PyPDFForm/image.py,sha256=P1P3Ejm8PVPQwpJFGAesjtwS5hxnVItrj75TE3WnFhM,4607
-PyPDFForm/patterns.py,sha256=HbTqzFllQ1cW3CqyNEfVh0qUMeFerbvOd0-HQnkifQQ,9765
-PyPDFForm/template.py,sha256=mmy4kVMe1plHxKtxFLbajBT1Mrv9g_oNCyzTUCWEyVw,11101
+PyPDFForm/patterns.py,sha256=CjZBv5nGfJ1NmAiwfsvRTwEQ-v5U8S6vrUlrUaAAyP0,10621
+PyPDFForm/template.py,sha256=IQ5iPcAIeKNnNcv_eYqjcid-1CtQdNQtN4vu4F3pPBU,11362
 PyPDFForm/utils.py,sha256=JavhAO4HmYRdujlsPXcZWGXTf7wDXzj4uU1XGRFsAaA,13257
 PyPDFForm/watermark.py,sha256=BJ8NeZLKf-MuJ2XusHiALaQpoqE8j6hHGbWcNhpjxN0,11299
 PyPDFForm/wrapper.py,sha256=_KKE2jUBcXxnkMzL8T43JjMmf8fvuJ-TTmYEy_h7h-c,30603
@@ -28,8 +28,8 @@ PyPDFForm/widgets/image.py,sha256=SegpzNjTXPuWX4hk_20yKk_IDaOrc81X9b9B4qK-kME,16
 PyPDFForm/widgets/radio.py,sha256=pSOAgOakGAoi-190pFklMmLClFdPCWMDYWW1Ce6q__g,3933
 PyPDFForm/widgets/signature.py,sha256=yye_CLYpgurLJ_rt7Td3xaY28uSAHc1YlqL1gmWqPqw,6034
 PyPDFForm/widgets/text.py,sha256=EG2mR-POHGWt9I-t3QVsTFIiDB5yqKPDBTKkAytQGp8,3836
-pypdfform-3.5.0.dist-info/licenses/LICENSE,sha256=43awmYkI6opyTpg19me731iO1WfXZwViqb67oWtCsFY,1065
-pypdfform-3.5.0.dist-info/METADATA,sha256=ojZtGj142xTZFvkwQN1iI7QFwjQFpoHxxYa-cctXQlA,4267
-pypdfform-3.5.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-pypdfform-3.5.0.dist-info/top_level.txt,sha256=GQQKuWqPUjT9YZqwK95NlAQzxjwoQrsxQ8ureM8lWOY,10
-pypdfform-3.5.0.dist-info/RECORD,,
+pypdfform-3.5.2.dist-info/licenses/LICENSE,sha256=43awmYkI6opyTpg19me731iO1WfXZwViqb67oWtCsFY,1065
+pypdfform-3.5.2.dist-info/METADATA,sha256=UzNH_wWYUjaKHbD-V5mpLVA9HbyHp4-8Ghze4UntJdQ,4267
+pypdfform-3.5.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+pypdfform-3.5.2.dist-info/top_level.txt,sha256=GQQKuWqPUjT9YZqwK95NlAQzxjwoQrsxQ8ureM8lWOY,10
+pypdfform-3.5.2.dist-info/RECORD,,