python-pdffiller 1.1.2__py3-none-any.whl → 2.0.0__py3-none-any.whl

pdffiller/_version.py

@@ -3,4 +3,4 @@ __copyright__ = "Copyright 2025 SISMIC"
 __email__ = "jraphanel@sismic.fr"
 __license__ = "MIT"
 __title__ = "pdffiller"
-__version__ = "1.1.2"
+__version__ = "2.0.0"

pdffiller/cli/commands/dump_data_fields.py

@@ -30,7 +30,8 @@ def dump_fields_text_formatter(pdf: Pdf) -> None:
 
 def dump_fields_json_formatter(pdf: Pdf) -> None:
     """Print output text for dump_fields command as simple text"""
-
+    if not pdf:
+        return
     cli_out_write(json.dumps(pdf.schema, indent=4, ensure_ascii=False))
 
 

pdffiller/pdf.py

@@ -12,25 +12,12 @@ methods for interacting with its form fields and content.
 
 from collections import OrderedDict
 
-from pypdf import PdfReader
-from pypdf.errors import PyPdfError
-from pypdf.generic import ArrayObject, DictionaryObject, NameObject
+import pymupdf
 
-from pdffiller.io.custom_pdf_writer import CustomPdfWriter
+from pdffiller.exceptions import PdfFillerException
 from pdffiller.io.output import PdfFillerOutput
 
-from .typing import (
-    Any,
-    cast,
-    Dict,
-    List,
-    Optional,
-    PathLike,
-    StrByteType,
-    Tuple,
-    Type,
-    Union,
-)
+from .typing import Any, cast, Dict, List, Optional, PathLike, StreamType, Type
 from .widgets.base import Widget
 from .widgets.checkbox import CheckBoxWidget
 from .widgets.radio import RadioWidget
@@ -40,27 +27,6 @@ from .widgets.text import TextWidget
 class PdfAttributes:  # pylint: disable=too-few-public-methods
     """Various constants, enums, and flags to aid readability."""
 
-    Widget = "/Widget"
-    Subtype = "/Subtype"
-    Parent = "/Parent"
-    T = "/T"
-    V = "/V"
-    AS = "/AS"
-    Kids = "/Kids"
-    AP = "/AP"
-    N = "/N"
-    D = "/D"
-    Opt = "/Opt"
-    MaxLen = "/MaxLen"
-    AcroForm = "/AcroForm"
-    Root = "/Root"
-    XFA = "/XFA"
-    FT = "/FT"
-    Ff = "/Ff"
-    Tx = "/Tx"
-    Ch = "/Ch"
-    Btn = "/Btn"
-    Off = "/Off"
     READ_ONLY = 1 << 0
 
 
@@ -75,15 +41,13 @@ class Pdf:
     """
 
     TYPE_TO_OBJECT: Dict[str, Type[Widget]] = {
-        "text": TextWidget,
-        "radio": RadioWidget,
-        "checkbox": CheckBoxWidget,
+        "Text": TextWidget,
+        "RadioButton": RadioWidget,
+        "CheckBox": CheckBoxWidget,
     }
 
     def __init__(
-        self,
-        content: Optional[StrByteType] = None,
-        adode_mode: Optional[bool] = True,
+        self, filename: Optional[PathLike] = None, stream: Optional[StreamType] = None
     ) -> None:
         """
         Constructor method for the `Pdf` class.
@@ -91,108 +55,58 @@ class Pdf:
         Initializes a new `Pdf` object with the given template PDF and optional keyword arguments.
 
         Args:
-            content (Optional[StrByteType]): The template PDF, provided as either:
-                - str: The file path to the PDF.
-                - BinaryIO: An open file-like object containing the PDF data.
-            adobe_mode (bool): Whether to enable Adobe-specific compatibility mode.
+            filename (Optional[PathLike]): Path to the input pdf
+            stream (Optional[StreamType]): An open file-like object containing the PDF data.
         """
 
         super().__init__()
         self.widgets: OrderedDict[str, Widget] = OrderedDict()
-        self.adobe_mode = adode_mode
-
-        self._init_helper(content)
+        self._init_helper(filename, stream)
 
-    def _init_helper(self, content: Optional[StrByteType] = None) -> None:
+    def _init_helper(
+        self, filename: Optional[PathLike] = None, stream: Optional[StreamType] = None
+    ) -> None:
         """
         Helper method to initialize widgets
 
-        This method is called during initialization and after certain operations
-        that modify the PDF content.
-        It rebuilds the widget dictionary.
-
         Args:
-            content (Optional[StrByteType]): The template PDF, provided as either:
-                - str: The file path to the PDF.
-                - BinaryIO: An open file-like object containing the PDF data.
+            filename (Optional[PathLike]): Path to the input pdf
+            stream (Optional[StreamType]): An open file-like object containing the PDF data.
         """
-        if not content:
+        if not filename and not stream:
             return
 
         output = PdfFillerOutput()
-        output.verbose("loading file in memory")
+        output.info("loading file in memory")
         loaded_widgets: OrderedDict[str, Widget] = OrderedDict()
         try:
-            pdf_file = PdfReader(content)
-        except PyPdfError as ex:
+            doc = pymupdf.open(filename=filename, stream=stream)
+        except Exception as ex:  # pylint: disable=broad-exception-caught
             PdfFillerOutput().error(str(ex))
-            return
-
-        for i, page in enumerate(pdf_file.pages):
-            output.verbose(f"loading page {i+1}/{len(pdf_file.pages)}")
-            widgets: Optional[ArrayObject] = page.annotations
-            if not widgets:
-                continue
-            for widget in widgets:
-                choices: Optional[List[str]] = None
-                if (
-                    PdfAttributes.Subtype not in widget
-                    or widget[PdfAttributes.Subtype] != PdfAttributes.Widget
-                ):
-                    continue
-
-                if PdfAttributes.T not in widget:
-                    widget = widget[PdfAttributes.Parent]
-                key = self._get_widget_name(widget)
-                if not key:
-                    continue
-                widget_type: Optional[str] = self._get_field_type(widget)
-                if not widget_type:
-                    continue
-
-                value = widget[PdfAttributes.V] if PdfAttributes.V in widget else None
-                if widget_type == "radio":
-                    if value:
-                        value = value[1:]
-                    choices = []
-                    if PdfAttributes.Kids in widget:
-                        for each in widget[PdfAttributes.Kids]:
-                            for each in each[PdfAttributes.AP][PdfAttributes.N].keys():
-                                if each[1:] not in choices:
-                                    choices.append(each[1:])
-
-                elif widget_type == "checkbox":
-
-                    if (
-                        PdfAttributes.AP in widget
-                        and PdfAttributes.N in widget[PdfAttributes.AP]
-                        and PdfAttributes.D in widget[PdfAttributes.AP]
-                        and PdfAttributes.AS in widget
-                    ):
-                        choices = [
-                            each[1:] for each in (widget[PdfAttributes.AP][PdfAttributes.N]).keys()
-                        ]
-                        if "Off" not in choices:
-                            choices.insert(0, "Off")
-                elif widget_type in ["list", "combo"] and value:
-                    choices = [each[1:] for each in widget[PdfAttributes.Opt]]
-                if key not in loaded_widgets:
-                    new_widget = self.TYPE_TO_OBJECT[widget_type](
-                        key, i, value, self.is_readonly(widget_type, widget.get_object())
+            raise PdfFillerException(
+                f"failed to load {filename or 'file from input string'}"
+            ) from ex
+
+        for i, page in enumerate(doc.pages()):
+            output.verbose(f"loading page {i+1}/{doc.page_count}")
+            for widget in page.widgets():
+                button_states = widget.button_states()
+                choices = button_states["normal"] if button_states else None
+
+                if widget.field_name not in loaded_widgets:
+                    if widget.field_type_string not in self.TYPE_TO_OBJECT:
+                        output.verbose(f"unsupported {widget.field_type_string} widget type")
+                        continue
+                    new_widget = self.TYPE_TO_OBJECT[widget.field_type_string](
+                        widget.field_name, i, widget.field_value, widget.field_flags & (1 << 0)
                     )
                     if choices and isinstance(new_widget, CheckBoxWidget):
                         new_widget.choices = choices
                     elif isinstance(new_widget, TextWidget):
-                        max_length = (
-                            int(widget[PdfAttributes.MaxLen])
-                            if PdfAttributes.MaxLen in widget
-                            else None
-                        )
-                        if max_length:
-                            new_widget.max_length = max_length
-                    loaded_widgets[key] = new_widget
+                        new_widget.max_length = widget.text_maxlen
+                    loaded_widgets[widget.field_name] = new_widget
                 else:
-                    new_widget = loaded_widgets[key]
+                    new_widget = loaded_widgets[widget.field_name]
                     if choices and isinstance(new_widget, CheckBoxWidget):
                         for each in choices:
                             if new_widget.choices is not None:
@@ -201,7 +115,9 @@ class Pdf:
                             else:
                                 new_widget.choices = [each]
 
-                        cast(CheckBoxWidget, loaded_widgets[key]).choices = new_widget.choices
+                        cast(CheckBoxWidget, loaded_widgets[widget.field_name]).choices = (
+                            new_widget.choices
+                        )
 
         self.widgets = loaded_widgets
 
@@ -222,7 +138,7 @@ class Pdf:
 
     def fill(
         self,
-        input_file: StrByteType,
+        input_file: PathLike,
         output_file: PathLike,
         data: Dict[str, str],
         flatten: bool = True,
@@ -231,9 +147,7 @@ class Pdf:
         Fill the PDF form with data from a dictionary.
 
         Args:
-            input_file (StrByteType): The template PDF, provided as either:
-                - str: The file path to the PDF.
-                - BinaryIO: An open file-like object containing the PDF data.
+            input_file (PathLike): The input file path.
             output_file (PathLike): The output file path.
             data (Dict[str, Union[str, bool, int]]): A dictionary where keys are form field names
                 and values are the data to fill the fields with.  Values can be strings, booleans,
@@ -244,108 +158,64 @@ class Pdf:
         Returns:
             Pdf: The `Pdf` object, allowing for method chaining.
         """
-        reader = PdfReader(input_file)
+        try:
+            document = pymupdf.open(filename=input_file)
+        except Exception as ex:
+            PdfFillerOutput().error(str(ex))
+            raise PdfFillerException(f"failed to open {input_file}") from ex
+
         output = PdfFillerOutput()
 
-        self._init_helper(input_file)
-        fields: Dict[str, Union[str, List[str], Tuple[str, str, float]]] = {}
-
-        output.verbose("checking value for radio/checkbox ...")
-        for name, value in data.items():
-            widget = self.widgets.get(name)
-            fields[name] = value
-            if isinstance(widget, CheckBoxWidget):
-                if value and value[0] != "/":
-                    output.info(f"override {name} value with /{value}")
-                    fields[name] = f"/{value}"
-
-        output.info("fill pdf with input values")
-        writer = CustomPdfWriter(reader)
-        writer.update_field_values(None, fields, auto_regenerate=False, flatten=flatten)
-        if flatten:
-            output.info("remove all annotations")
-            writer.remove_annotations(None)
-        output.info("compress file")
-        writer.compress_identical_objects(remove_identicals=False, remove_orphans=True)
-
-        output.info(f"write {output_file} on the disk")
-        with open(output_file, "wb") as f:
-            writer.write(f)
-
-        output.info("try to remove identical objects")
-        try:
-            writer.compress_identical_objects(remove_identicals=True, remove_orphans=False)
-            output.info(f"write {output_file} on the disk")
-            with open(output_file, "wb") as f:
-                writer.write(f)
-        except Exception:  # pylint: disable=broad-exception-caught
-            output.warning("An error occurs when removing identical objects")
-        return self
+        output.info("filling pdf with input values")
+        # Iterate over all pages and process fields
+        for page in document:
+            for field in page.widgets():
+                if field.field_name in data:
+                    value = data[field.field_name]
 
-    def _get_widget_name(self, widget: Any) -> Optional[str]:
-        if PdfAttributes.T not in widget:
-            return None
-        key: Optional[str] = widget[PdfAttributes.T]
-        if (
-            PdfAttributes.Parent in widget
-            and PdfAttributes.T in widget[PdfAttributes.Parent].get_object()
-            and widget[PdfAttributes.Parent].get_object()[PdfAttributes.T] != key
-        ):
-            key = f"{self._get_widget_name(widget[PdfAttributes.Parent].get_object())}.{key}"
+                    # Handling checkboxes
+                    if (
+                        field.field_type
+                        == pymupdf.PDF_WIDGET_TYPE_CHECKBOX  # pylint: disable=no-member
+                    ):
+                        print(f"{field.field_name} => {field.on_state()} vs {value}")
+                        if value.strip() and "Off" != value.strip():
+                            output.verbose(
+                                f"updating checkbox with {value} from {field.field_value}"
+                            )
+                            field.field_value = True
+                        else:
+                            field.field_value = False
+
+                    # Handling radio buttons
+                    elif (
+                        field.field_type
+                        == pymupdf.PDF_WIDGET_TYPE_RADIOBUTTON  # pylint: disable=no-member
+                    ):
+                        if value == field.on_state():
+                            output.verbose(
+                                f"updating radiobutton with {value} from {field.field_value}"
+                            )
+                            field.field_value = value
+
+                    # Handling other fields types
+                    else:
+                        output.verbose(
+                            f"updating {field.field_name} with {value} from {field.field_value}"
+                        )
+                        field.field_value = value
 
-        return key
+                    # Update the widget!
+                    field.update()
 
-    def _get_field_type(self, annotation: Any) -> Optional[str]:
-        """
-        Determine widget type given its annotations.
-        """
-        ft = annotation[PdfAttributes.FT] if PdfAttributes.FT in annotation else None
-        ff = annotation[PdfAttributes.Ff] if PdfAttributes.Ff in annotation else None
-
-        if ft == PdfAttributes.Tx:
-            return "text"
-        if ft == PdfAttributes.Ch:
-            if ff and int(ff) & 1 << 17:  # test 18th bit
-                return "combo"
-            return "list"
-        if ft == PdfAttributes.Btn:
-            if ff and int(ff) & 1 << 15:  # test 16th bit
-                return "radio"
-            return "checkbox"
-
-        return None
-
-    @staticmethod
-    def is_readonly(widget_type: str, annot: DictionaryObject) -> bool:
-        """
-        Determines whether readonly flag is set or not.
+        try:
+            if flatten:
+                output.info("remove all annotations")
+                document.bake(annots=False)
 
-        This function evaluates if readonly is activating by checking Ff (flags) entry
-        in the annotation dictionary.
+            # Save the modified PDF
+            document.save(output_file)
+        except Exception:  # pylint: disable=broad-exception-caught
+            output.warning("an error occurs when saving file")
 
-        Args:
-            widget_type (str): The widget type
-            annot (DictionaryObject): The annotation dictionary.
-        Returns:
-            True if read-only is set, else False
-        """
-        if widget_type == "radio":
-            if PdfAttributes.Parent in annot:
-                return (
-                    int(
-                        cast(Any, annot[NameObject(PdfAttributes.Parent)]).get(
-                            NameObject(PdfAttributes.Ff), 0
-                        )
-                    )
-                    & PdfAttributes.READ_ONLY
-                    == PdfAttributes.READ_ONLY
-                )
-            return (
-                int(annot.get(NameObject(PdfAttributes.Ff), 0)) & PdfAttributes.READ_ONLY
-                == PdfAttributes.READ_ONLY
-            )
-
-        return (
-            int(annot.get(NameObject(PdfAttributes.Ff), 0)) & PdfAttributes.READ_ONLY
-            == PdfAttributes.READ_ONLY
-        )
+        return self

pdffiller/typing.py

@@ -43,7 +43,7 @@ __all__ = [
     "Type",
     "Union",
     "SubParserType",
-    "StrByteType",
+    "StreamType",
     "TextIO",
 ]
 
@@ -52,7 +52,6 @@ ExitCode = Union[str, int, None]
 PathLike = Union[str, Path]
 
 StreamType = IO[Any]
-StrByteType = Union[PathLike, StreamType]
 
 if TYPE_CHECKING:
     # pylint: disable=protected-access,line-too-long

{python_pdffiller-1.1.2.dist-info → python_pdffiller-2.0.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-pdffiller
-Version: 1.1.2
+Version: 2.0.0
 Summary: Interact with PDF by inspecting or filling it
 Author-email: Jacques Raphanel <jraphanel@sismic.fr>
 License-Expression: MIT
@@ -26,7 +26,7 @@ Requires-Python: >=3.9
 Description-Content-Type: text/x-rst
 License-File: COPYING
 License-File: AUTHORS.rst
-Requires-Dist: pypdf
+Requires-Dist: pymupdf==1.24.10
 Requires-Dist: colorama
 Requires-Dist: pyyaml
 Dynamic: license-file

{python_pdffiller-1.1.2.dist-info → python_pdffiller-2.0.0.dist-info}/RECORD

@@ -1,11 +1,11 @@
 pdffiller/__init__.py,sha256=0HtgXhEV1fKTKAcOXGcq4UsCFflDIPCDQvckshZf-1k,195
 pdffiller/__main__.py,sha256=7NPQgZVx6VSZS7OrmyJQ_O1vL4wiSqhiILi-outwUqM,107
-pdffiller/_version.py,sha256=Za2kjmAG5y6PfrdsRibsxyoNKcK_36DjRsmSsSZVa1c,172
+pdffiller/_version.py,sha256=52zTPeF0KaGbSTkNknOnH2BFjTPDTqn6KWd0vLwHy7o,172
 pdffiller/const.py,sha256=if_j5I8ftczpjrzZjA7idv-XpvIj1-XBF4oe6VtQvF0,434
 pdffiller/exceptions.py,sha256=CdN93bZ0mBBS5vLxg14FYZUy4xkYqoD3_SzqtSkZr4g,1624
-pdffiller/pdf.py,sha256=Z_AwWD2_PSvRwJGQy9-czmxnVqPvbAY7y9T7GXtIboo,12733
+pdffiller/pdf.py,sha256=zy-mIC5GQBSK2iKOceRiioMQGTTrp9leFpLSaJBxV50,8417
 pdffiller/py.typed.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pdffiller/typing.py,sha256=dW2hGtyaNgTowUl1zsEt3ldhbHM2KfCyHAASb0RZcEs,980
+pdffiller/typing.py,sha256=4GJGevlU-YOR9fmuPT8jmyg5MBhn-2TB1K88b6C8VRw,937
 pdffiller/utils.py,sha256=pmGf3QwkhKwosk_eFCauzHM-XHp_WGVQAtZlxa7taYY,827
 pdffiller/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pdffiller/cli/args.py,sha256=1MUtxIVgdBWJCjgp2gxUuGW-vH4qne92A7Rns2DylsQ,870
@@ -17,21 +17,20 @@ pdffiller/cli/formatters.py,sha256=k0Y0FaRuHFlW8pxePxGsYA7UEmG-gLkb_H3rFbyTuV4,4
 pdffiller/cli/once_argument.py,sha256=olQvNhObObS0iXVL1YCa-_lH76SV0I4FvnlgR9roqo4,687
 pdffiller/cli/smart_formatter.py,sha256=59hwF07nKbp-P9IfbqKgMFsfbvjIw5SACCZpUF4nnuE,318
 pdffiller/cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pdffiller/cli/commands/dump_data_fields.py,sha256=YR8aENCGkCRro0jTuuvMg2HCEos9aF81aL4SxP--_2E,2262
+pdffiller/cli/commands/dump_data_fields.py,sha256=o7LmFBdl9GfJOyZM1tOgeesx004QWIIXVp2_pX6FB1Q,2292
 pdffiller/cli/commands/fill_form.py,sha256=5wjbjwYLsytY6ea-n_KDbU9UDmkN00NYj_gm25MQqJ8,4758
 pdffiller/io/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pdffiller/io/colors.py,sha256=QCBEWksTVNurOJQYO0zh1X_xxIOXxXmYSJhbCqnNjI8,1710
-pdffiller/io/custom_pdf_writer.py,sha256=5lKz59fobhQZ74tmV-4hosVi6Kd6PFTIKNptFO9-p4g,7077
 pdffiller/io/output.py,sha256=QMASWRWmfZGG9DdtlfpWXM3VJAMgWGQwPUzoYp_9FFY,11298
 pdffiller/widgets/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pdffiller/widgets/base.py,sha256=omGVQsQgMa-ALESnUd3_94oVIYScAMl0SPhHC_DG8Lg,3613
 pdffiller/widgets/checkbox.py,sha256=iijStLAsY1G4cljW3a9NxVS_8qxJewFEw-B8jU2aKXk,1711
 pdffiller/widgets/radio.py,sha256=Db9Oc3Q8ge8qqTVPLoz3I1_SJBGyJ8KfA33ixZMr78c,1070
 pdffiller/widgets/text.py,sha256=SiuyBvZPZ6idCmtZ_05zE26iN6Rz67OfOj1fUm98YQI,2397
-python_pdffiller-1.1.2.dist-info/licenses/AUTHORS.rst,sha256=1_hVzMKgmoXvGgrcZC7sIbU_6PvvkB6vwqevAqzrIkQ,205
-python_pdffiller-1.1.2.dist-info/licenses/COPYING,sha256=ADPe-bH2wYq8nFf6EPJyovzTJyl3jSPnm09mGI8FSTo,1074
-python_pdffiller-1.1.2.dist-info/METADATA,sha256=TOlT-uj2UUWfSM9YE93bhc0-cpOoNbmHBTKVqwFAPIo,4164
-python_pdffiller-1.1.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-python_pdffiller-1.1.2.dist-info/entry_points.txt,sha256=RESKKpPPdWl0wDET96ntuFoUydALx9j0mxtbt-MEBjU,49
-python_pdffiller-1.1.2.dist-info/top_level.txt,sha256=5MGWCBFYlu_Ax-I5PgQkV9Xw7O48maPe9z8Qj_yVPL4,10
-python_pdffiller-1.1.2.dist-info/RECORD,,
+python_pdffiller-2.0.0.dist-info/licenses/AUTHORS.rst,sha256=1_hVzMKgmoXvGgrcZC7sIbU_6PvvkB6vwqevAqzrIkQ,205
+python_pdffiller-2.0.0.dist-info/licenses/COPYING,sha256=ADPe-bH2wYq8nFf6EPJyovzTJyl3jSPnm09mGI8FSTo,1074
+python_pdffiller-2.0.0.dist-info/METADATA,sha256=0QGzU481QrZElmH6WwsUetDF_rep_1SWSXXH_zCyeCk,4175
+python_pdffiller-2.0.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+python_pdffiller-2.0.0.dist-info/entry_points.txt,sha256=RESKKpPPdWl0wDET96ntuFoUydALx9j0mxtbt-MEBjU,49
+python_pdffiller-2.0.0.dist-info/top_level.txt,sha256=5MGWCBFYlu_Ax-I5PgQkV9Xw7O48maPe9z8Qj_yVPL4,10
+python_pdffiller-2.0.0.dist-info/RECORD,,

{python_pdffiller-1.1.2.dist-info → python_pdffiller-2.0.0.dist-info}/WHEEL

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

pdffiller/io/custom_pdf_writer.py

@@ -1,143 +0,0 @@
-from pypdf import PageObject, PdfWriter
-from pypdf.constants import AnnotationDictionaryAttributes as AA
-from pypdf.constants import CatalogDictionary
-from pypdf.constants import FieldDictionaryAttributes as FA
-from pypdf.constants import InteractiveFormDictEntries
-from pypdf.constants import PageAttributes as PG
-from pypdf.errors import PyPdfError
-from pypdf.generic import (
-    ArrayObject,
-    DictionaryObject,
-    NameObject,
-    NumberObject,
-    RectangleObject,
-    TextStringObject,
-)
-
-from ..typing import cast, Dict, List, Optional, Tuple, Union
-from .output import PdfFillerOutput
-
-
-class CustomPdfWriter(PdfWriter):  # pylint: disable=abstract-method
-    """Overwrite PdfWriter to by-pass the related to flatten mode."""
-
-    def update_field_values(
-        self,
-        page: Union[PageObject, List[PageObject], None],
-        fields: Dict[str, Union[str, List[str], Tuple[str, str, float]]],
-        flags: FA.FfBits = PdfWriter.FFBITS_NUL,
-        auto_regenerate: Optional[bool] = True,
-        flatten: bool = False,
-    ) -> None:
-        """
-        Update the form field values for a given page from a fields dictionary.
-
-        Copy field texts and values from fields to page.
-        If the field links to a parent object, add the information to the parent.
-
-        Args:
-            page: `PageObject` - references **PDF writer's page** where the
-                annotations and field data will be updated.
-                `List[Pageobject]` - provides list of pages to be processed.
-                `None` - all pages.
-            fields: a Python dictionary of:
-
-                * field names (/T) as keys and text values (/V) as value
-                * field names (/T) as keys and list of text values (/V) for multiple choice list
-                * field names (/T) as keys and tuple of:
-                    * text values (/V)
-                    * font id (e.g. /F1, the font id must exist)
-                    * font size (0 for autosize)
-
-            flags: A set of flags from :class:`~pypdf.constants.FieldDictionaryAttributes.FfBits`.
-
-            auto_regenerate: Set/unset the need_appearances flag;
-                the flag is unchanged if auto_regenerate is None.
-
-            flatten: Whether or not to flatten the annotation. If True, this adds the annotation's
-                appearance stream to the page contents. Note that this option does not remove the
-                annotation itself.
-
-        """
-        if CatalogDictionary.ACRO_FORM not in self._root_object:
-            raise PyPdfError("No /AcroForm dictionary in PDF of PdfWriter Object")
-        af = cast(DictionaryObject, self._root_object[CatalogDictionary.ACRO_FORM])
-        if InteractiveFormDictEntries.Fields not in af:
-            raise PyPdfError("No /Fields dictionary in PDF of PdfWriter Object")
-        if isinstance(auto_regenerate, bool):
-            self.set_need_appearances_writer(auto_regenerate)
-        # Iterate through pages, update field values
-        if page is None:
-            page = list(self.pages)
-        if isinstance(page, list):
-            for p in page:
-                if PG.ANNOTS in p:  # just to prevent warnings
-                    self.update_field_values(p, fields, flags, None, flatten=flatten)
-            return
-        output = PdfFillerOutput()
-        if PG.ANNOTS not in page:
-            output.warning(f"No fields to update on this page {__name__}")
-            return
-        for annotation in page[PG.ANNOTS]:  # type: ignore
-            annotation = cast(DictionaryObject, annotation.get_object())
-            if annotation.get("/Subtype", "") != "/Widget":
-                continue
-            if "/FT" in annotation and "/T" in annotation:
-                parent_annotation = annotation
-            else:
-                parent_annotation = annotation.get(PG.PARENT, DictionaryObject()).get_object()
-
-            for field, value in fields.items():
-                if not (
-                    self._get_qualified_field_name(parent_annotation) == field
-                    or parent_annotation.get("/T", None) == field
-                ):
-                    continue
-                if parent_annotation.get("/FT", None) == "/Ch" and "/I" in parent_annotation:
-                    del parent_annotation["/I"]
-                if flags:
-                    annotation[NameObject(FA.Ff)] = NumberObject(flags)
-                if not (
-                    value is None and flatten
-                ):  # Only change values if given by user and not flattening.
-                    if isinstance(value, list):
-                        lst = ArrayObject(TextStringObject(v) for v in value)
-                        parent_annotation[NameObject(FA.V)] = lst
-                    elif isinstance(value, tuple):
-                        annotation[NameObject(FA.V)] = TextStringObject(
-                            value[0],
-                        )
-                    else:
-                        parent_annotation[NameObject(FA.V)] = TextStringObject(value)
-                if parent_annotation.get(FA.FT) == "/Btn":
-                    # Checkbox button (no /FT found in Radio widgets)
-                    v = NameObject(value)
-                    ap = cast(DictionaryObject, annotation[NameObject(AA.AP)])
-                    normal_ap = cast(DictionaryObject, ap["/N"])
-                    exist = True
-                    if v not in normal_ap:
-                        v = NameObject("/Off")
-                        exist = False
-                    appearance_stream_obj = normal_ap.get(v)
-                    # other cases will be updated through the for loop
-                    annotation[NameObject(AA.AS)] = v
-                    annotation[NameObject(FA.V)] = v
-                    if flatten and appearance_stream_obj is not None and exist:
-                        # We basically copy the entire appearance stream, which should be
-                        # an XObject that is already registered. No need to add font resources.
-                        rct = cast(RectangleObject, annotation[AA.Rect])
-                        self._add_apstream_object(
-                            page, appearance_stream_obj, field, rct[0], rct[1]
-                        )
-                elif parent_annotation.get(FA.FT) == "/Tx" or parent_annotation.get(FA.FT) == "/Ch":
-                    # textbox
-                    if isinstance(value, tuple):
-                        self._update_field_annotation(  # type: ignore[attr-defined] # pylint: disable=no-member
-                            page, parent_annotation, annotation, value[1], value[2], flatten=flatten
-                        )
-                    else:
-                        self._update_field_annotation(  # type: ignore[attr-defined]  # pylint: disable=no-member
-                            page, parent_annotation, annotation, flatten=flatten
-                        )
-                elif annotation.get(FA.FT) == "/Sig":  # deprecated  # not implemented yet
-                    output.warning(f"Signature forms not implemented yet {__name__}")