PyPDFForm 5.5.5__tar.gz → 6.0.0__tar.gz

{pypdfform-5.5.5 → pypdfform-6.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyPDFForm
-Version: 5.5.5
+Version: 6.0.0
 Summary: The Python library & CLI for PDF forms.
 Author: Jinge Li
 License-Expression: MIT
@@ -12,16 +12,16 @@ Classifier: Intended Audience :: Developers
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
-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: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Topic :: File Formats
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Text Processing
 Classifier: Topic :: Utilities
-Requires-Python: >=3.10
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: cryptography<51.0.0,>=50.0.0

{pypdfform-5.5.5 → pypdfform-6.0.0}/PyPDFForm/__init__.py

@@ -16,9 +16,7 @@ PyPDFForm aims to make PDF form automation straightforward whether it is used
 from Python code or from the command line.
 """
 
-import logging
-
-__version__ = "5.5.5"
+__version__ = "6.0.0"
 
 from .lib.annotations import Annotations
 from .lib.assets.blank import BlankPage
@@ -28,13 +26,6 @@ from .lib.types import PdfArray
 from .lib.widgets import Fields
 from .lib.wrapper import PdfWrapper
 
-# TODO: figure out why `Annotation sizes differ:`
-for logger in [
-    logging.getLogger(name) for name in getattr(logging.root.manager, "loggerDict")
-]:
-    if "pypdf" in logger.name:
-        logger.setLevel(logging.ERROR)
-
 __all__ = [
     "PdfWrapper",
     "PdfArray",

{pypdfform-5.5.5 → pypdfform-6.0.0}/PyPDFForm/cli/root.py

@@ -108,14 +108,6 @@ def main(
             help="Generate form field appearance streams.",
         ),
     ] = False,
-    preserve_metadata: Annotated[
-        bool,
-        typer.Option(
-            "--preserve-metadata",
-            help="Preserve input PDF metadata.",
-            hidden=True,
-        ),
-    ] = False,
     use_full_widget_name: Annotated[
         bool,
         typer.Option(
@@ -138,15 +130,12 @@ def main(
             field appearances.
         generate_appearance_streams (bool): Whether to generate form field
             appearance streams while handling PDFs.
-        preserve_metadata (bool): Deprecated compatibility option. Input PDF
-            metadata is preserved automatically.
         use_full_widget_name (bool): Whether widget lookups should use full
             form field names.
     """
     ctx.obj = {
         "need_appearances": need_appearances,
         "generate_appearance_streams": generate_appearance_streams,
-        "preserve_metadata": preserve_metadata,
         "use_full_widget_name": use_full_widget_name,
     }
 
@@ -163,10 +152,10 @@ def fill(
         Path | None, data_file_option("YAML or JSON file with form field values.")
     ] = None,
     output: OPTIONAL_OUTPUT_PDF = None,
-    flatten: Annotated[
+    readonly: Annotated[
         bool,
-        typer.Option("--flatten", help="Flatten form fields after filling."),
-    ] = None,
+        typer.Option("--readonly", help="Make form fields read-only when filling."),
+    ] = False,
 ) -> None:
     """
     Fill an existing PDF form from a data file or command-line options.
@@ -187,8 +176,8 @@ def fill(
             options in ``ctx.args``. Defaults to None.
         output (Path, optional): Output PDF path. If omitted, the input PDF is
             overwritten. Defaults to None.
-        flatten (bool, optional): Whether to flatten form fields after filling.
-            Defaults to None.
+        readonly (bool): Whether to make form fields read-only when filling.
+            Defaults to False.
     """
     obj = PdfWrapper(str(pdf), **ctx.obj)
 
@@ -226,4 +215,4 @@ def fill(
             )
             input_data[k] = input_data[k]["path"]
 
-    obj.fill(input_data, flatten=flatten).write(output or pdf)
+    obj.fill(input_data, readonly=readonly).write(output or pdf)

{pypdfform-5.5.5 → pypdfform-6.0.0}/PyPDFForm/lib/filler.py

@@ -5,7 +5,7 @@ Module containing functions to fill PDF forms.
 This module provides the core functionality for filling PDF forms programmatically.
 It includes functions for handling various form field types, such as text fields,
 checkboxes, radio buttons, dropdowns, images, and signatures. The module also
-supports flattening the filled form to prevent further modifications.
+supports making the filled form read-only to prevent further modifications.
 """
 
 from io import BytesIO
@@ -15,7 +15,7 @@ from pypdf import PdfWriter
 from pypdf.generic import DictionaryObject
 
 from .constants import Annots
-from .hooks import flatten_field
+from .hooks import update_field_readonly
 from .image import get_draw_image_resolutions, get_image_dimensions
 from .middleware import WIDGET_TYPES
 from .middleware.checkbox import Checkbox
@@ -84,12 +84,12 @@ def update_widget(
     radio_button_tracker: Dict[str, int],
     images_to_draw_page: list,
     need_appearances: bool,
-    flatten: bool,
+    readonly: bool,
 ) -> bool:
     """Updates a single widget's value and handles its properties.
 
     This function updates the value of a single PDF form widget based on its type. It sets
-    the read-only flag first when flattening is requested, skips value updates when the
+    the read-only flag first when requested, skips value updates when the
     middleware value is ``None``, tracks radio option indices within each group, and
     prepares images or signatures for later drawing instead of writing image data directly
     into the annotation.
@@ -101,13 +101,13 @@ def update_widget(
         radio_button_tracker (Dict[str, int]): A tracker for radio button groups to manage their indices.
         images_to_draw_page (list): A list to store image data for the current page.
         need_appearances (bool): If True, skips updating appearance streams for certain fields.
-        flatten (bool): Whether to flatten the widget to prevent further editing.
+        readonly (bool): Whether to make the widget read-only to prevent further editing.
 
     Returns:
         bool: True if an image or signature was prepared for drawing, False otherwise.
     """
-    if flatten:
-        flatten_field(annot, True)
+    if readonly:
+        update_field_readonly(annot, True)
     if widget.value is None:
         return False
 
@@ -137,7 +137,7 @@ def handle_image_drawing(
     """Merges prepared images and signatures with the filled PDF.
 
     This function takes the filled PDF and a dictionary of images to draw (from signatures
-    or image fields), flattens that page-indexed structure into watermark drawing
+    or image fields), combines that page-indexed structure into watermark drawing
     instructions, and merges those image watermarks into the PDF.
 
     Args:
@@ -161,7 +161,7 @@ def fill(
     widgets: Dict[str, WIDGET_TYPES],
     need_appearances: bool,
     use_full_widget_name: bool,
-    flatten: bool = False,
+    readonly: bool = False,
 ) -> tuple:
     """Fills a PDF template with the given widgets.
 
@@ -181,7 +181,7 @@ def fill(
             behavior for certain fields.
         use_full_widget_name (bool): Whether to use the full widget name when looking up widgets
                                       in the `widgets` dictionary.
-        flatten (bool): Whether to flatten the filled PDF. Defaults to False.
+        readonly (bool): Whether to make form fields read-only. Defaults to False.
 
     Returns:
         tuple: A tuple containing the filled PDF as bytes and the image-drawn
@@ -211,7 +211,7 @@ def fill(
                 radio_button_tracker,
                 images_to_draw[page_num + 1],
                 need_appearances,
-                flatten,
+                readonly,
             )
 
     with BytesIO() as f:

{pypdfform-5.5.5 → pypdfform-6.0.0}/PyPDFForm/lib/hooks.py

@@ -4,9 +4,10 @@ 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. 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.
+of checkbox and radio button widgets. It also provides functions for changing the
+editability of 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.
 """
 
 import sys
@@ -362,10 +363,10 @@ def update_dropdown_choices(annot: DictionaryObject, val: list) -> None:
     )
 
 
-def flatten_field(annot: DictionaryObject, val: bool) -> None:
+def update_field_readonly(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.
+    Sets or unsets the ReadOnly flag on a form field annotation,
+    making it read-only 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
@@ -373,7 +374,7 @@ def flatten_field(annot: DictionaryObject, val: bool) -> None:
 
     Args:
         annot (DictionaryObject): The annotation dictionary.
-        val (bool): True to flatten (make read-only), False to unflatten (make editable).
+        val (bool): True to make the field read-only, False to make it editable.
     """
     _update_field_flag(annot, READ_ONLY, val)
 

{pypdfform-5.5.5 → pypdfform-6.0.0}/PyPDFForm/lib/middleware/base.py

@@ -42,7 +42,7 @@ class Widget:
             "y": "update_field_y",
             "width": "update_field_width",
             "height": "update_field_height",
-            "readonly": "flatten_field",
+            "readonly": "update_field_readonly",
             "required": "update_field_required",
             "hidden": "update_field_hidden",
             "tooltip": "update_field_tooltip",

{pypdfform-5.5.5 → pypdfform-6.0.0}/PyPDFForm/lib/utils.py

@@ -31,7 +31,7 @@ from .constants import (
 
 def remove_all_widgets(pdf: bytes) -> bytes:
     """
-    Removes all widgets (form fields) from a PDF, effectively flattening the form.
+    Removes all widgets (form fields) from a PDF.
 
     This function takes a PDF as a bytes stream, removes all of its interactive
     form field annotations from each page, and returns the modified PDF as a

{pypdfform-5.5.5 → pypdfform-6.0.0}/PyPDFForm/lib/wrapper.py

@@ -37,7 +37,6 @@ from .adapter import (
     fp_or_f_obj_or_stream_to_stream,
 )
 from .coordinate import generate_coordinate_grid
-from .deprecation import deprecation_notice
 from .egress import (
     appearance_streams_handler,
     rebuild_acroform_fields,
@@ -109,8 +108,6 @@ class PdfWrapper:
                 - `use_full_widget_name` (bool): Whether to use the full widget name when filling the form.
                 - `need_appearances` (bool): Whether to set the `NeedAppearances` flag in the PDF's AcroForm dictionary.
                 - `generate_appearance_streams` (bool): Whether to explicitly generate appearance streams for all form fields using pikepdf.
-                - `preserve_metadata` (bool): Deprecated compatibility attribute;
-                  input PDF metadata is preserved automatically.
                 - `title` (str | None): The title stored in the PDF's document
                   metadata. A non-None value replaces the existing title; None
                   preserves it.
@@ -121,7 +118,6 @@ class PdfWrapper:
         ("use_full_widget_name", False),
         ("need_appearances", False),
         ("generate_appearance_streams", False),
-        ("preserve_metadata", False),
         ("title", None),
     ]
 
@@ -137,9 +133,7 @@ class PdfWrapper:
         The template is normalized to bytes and existing widgets are loaded immediately.
         The title and document-open JavaScript remain in the PDF stream and are read
         lazily when their properties are accessed. A non-None `title` keyword updates
-        the title in the PDF stream; None leaves the template's title unchanged. The
-        deprecated `preserve_metadata` keyword is accepted for backward compatibility
-        and emits a deprecation warning. Enabling
+        the title in the PDF stream; None leaves the template's title unchanged. Enabling
         `generate_appearance_streams` also enables `need_appearances`.
 
         Args:
@@ -167,10 +161,6 @@ class PdfWrapper:
 
         # sets attrs from kwargs
         for attr, default in self.USER_PARAMS:
-            if attr == "preserve_metadata" and attr in kwargs:
-                deprecation_notice("", "preserve_metadata").emit_notice(
-                    self, "__init__"
-                )
             setattr(self, attr, kwargs.get(attr, default))
 
         if getattr(self, "generate_appearance_streams") is True:
@@ -676,7 +666,8 @@ class PdfWrapper:
                 are form field names and values are the data to fill the fields with.
                 Values can be strings, booleans, integers, file-like objects, or bytes.
             **kwargs: Additional keyword arguments:
-                - `flatten` (bool): Whether to flatten the form after filling, making the fields read-only (default: False).
+                - `readonly` (bool): Whether to make form fields read-only when filling (default: False).
+                  False does not make existing read-only fields editable.
 
         Returns:
             PdfWrapper: The `PdfWrapper` object, allowing for method chaining.
@@ -691,7 +682,7 @@ class PdfWrapper:
             self.widgets,
             need_appearances=getattr(self, "need_appearances"),
             use_full_widget_name=getattr(self, "use_full_widget_name"),
-            flatten=kwargs.get("flatten", False),
+            readonly=kwargs.get("readonly", False),
         )
 
         if image_drawn_stream is not None:

{pypdfform-5.5.5 → pypdfform-6.0.0}/PyPDFForm.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyPDFForm
-Version: 5.5.5
+Version: 6.0.0
 Summary: The Python library & CLI for PDF forms.
 Author: Jinge Li
 License-Expression: MIT
@@ -12,16 +12,16 @@ Classifier: Intended Audience :: Developers
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
-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: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Topic :: File Formats
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Text Processing
 Classifier: Topic :: Utilities
-Requires-Python: >=3.10
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: cryptography<51.0.0,>=50.0.0

{pypdfform-5.5.5 → pypdfform-6.0.0}/pyproject.toml

@@ -17,17 +17,17 @@ classifiers = [
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
-    "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
     "Topic :: File Formats",
     "Topic :: Software Development :: Libraries :: Python Modules",
     "Topic :: Text Processing",
     "Topic :: Utilities",
 ]
-requires-python = ">=3.10"
+requires-python = ">=3.11"
 dependencies = [
     "cryptography>=50.0.0,<51.0.0",
     "fonttools>=4.63.0,<5.0.0",
@@ -104,14 +104,14 @@ select = [
     "PT",
     "PERF",
     "Q",
-    "R",
+    "RET",
     "RSE",
     "SLF",
     "SLOT",
     "SIM",
     "T10",
     "TRY",
-    "TCH",
+    "TC",
     "YTT",
     "W",
     "UP007",

{pypdfform-5.5.5 → pypdfform-6.0.0}/tests/test_create_widget.py

@@ -311,13 +311,13 @@ def test_create_checkbox_persist_old_widgets_fill(
 
 
 @pytest.mark.requires_zlib_over_zlib_ng
-def test_create_widget_sejda_fill_flatten_before(sejda_template, pdf_samples, request):
+def test_create_widget_sejda_fill_readonly_before(sejda_template, pdf_samples, request):
     expected_path = os.path.join(
-        pdf_samples, "widget", "test_create_widget_sejda_fill_flatten_before.pdf"
+        pdf_samples, "widget", "test_create_widget_sejda_fill_readonly_before.pdf"
     )
     with open(expected_path, "rb+") as f:
         obj = PdfWrapper(sejda_template)
-        obj.fill(obj.sample_data, flatten=True).bulk_create_fields(
+        obj.fill(obj.sample_data, readonly=True).bulk_create_fields(
             [
                 Fields.TextField(
                     name="new_text_field_widget",
@@ -345,9 +345,9 @@ def test_create_widget_sejda_fill_flatten_before(sejda_template, pdf_samples, re
 
 
 @pytest.mark.requires_zlib_over_zlib_ng
-def test_create_widget_sejda_fill_flatten_after(sejda_template, pdf_samples, request):
+def test_create_widget_sejda_fill_readonly_after(sejda_template, pdf_samples, request):
     expected_path = os.path.join(
-        pdf_samples, "widget", "test_create_widget_sejda_fill_flatten_after.pdf"
+        pdf_samples, "widget", "test_create_widget_sejda_fill_readonly_after.pdf"
     )
     with open(expected_path, "rb+") as f:
         obj = PdfWrapper(sejda_template)
@@ -366,7 +366,7 @@ def test_create_widget_sejda_fill_flatten_after(sejda_template, pdf_samples, req
                     font_color=(0, 0, 1),
                 )
             ]
-        ).fill(obj.sample_data, flatten=True)
+        ).fill(obj.sample_data, readonly=True)
         assert obj.schema["properties"]["new_text_field_widget"]["type"] == "string"
 
         request.config.results["expected_path"] = expected_path

{pypdfform-5.5.5 → pypdfform-6.0.0}/tests/test_dropdown.py

@@ -37,9 +37,9 @@ def test_dropdown_not_specified(sample_template_with_dropdown):
     )
 
 
-def test_dropdown_one_flatten(sample_template_with_dropdown, pdf_samples, request):
+def test_dropdown_one_readonly(sample_template_with_dropdown, pdf_samples, request):
     expected_path = os.path.join(
-        pdf_samples, "dropdown", "test_dropdown_one_flatten.pdf"
+        pdf_samples, "dropdown", "test_dropdown_one_readonly.pdf"
     )
     with open(expected_path, "rb+") as f:
         obj = PdfWrapper(sample_template_with_dropdown).fill(
@@ -53,7 +53,7 @@ def test_dropdown_one_flatten(sample_template_with_dropdown, pdf_samples, reques
                 "radio_1": 1,
                 "dropdown_1": 0,
             },
-            flatten=True,
+            readonly=True,
         )
 
         request.config.results["expected_path"] = expected_path
@@ -87,11 +87,11 @@ def test_dropdown_alignment(dropdown_alignment, pdf_samples, request):
 
 
 @pytest.mark.requires_zlib_over_zlib_ng
-def test_dropdown_alignment_flatten_then_unflatten(
+def test_dropdown_alignment_readonly_then_editable(
     dropdown_alignment, pdf_samples, request
 ):
     expected_path = os.path.join(
-        pdf_samples, "dropdown", "test_dropdown_alignment_flatten_then_unflatten.pdf"
+        pdf_samples, "dropdown", "test_dropdown_alignment_readonly_then_editable.pdf"
     )
     with open(expected_path, "rb+") as f:
         obj = PdfWrapper(dropdown_alignment).fill(
@@ -100,7 +100,7 @@ def test_dropdown_alignment_flatten_then_unflatten(
                 "dropdown_center": 1,
                 "dropdown_right": 2,
             },
-            flatten=True,
+            readonly=True,
         )
         obj.widgets["dropdown_center"].readonly = False
 
@@ -138,11 +138,11 @@ def test_dropdown_alignment_sejda(dropdown_alignment_sejda, pdf_samples, request
         assert obj.read() == expected
 
 
-def test_dropdown_alignment_sejda_flatten(
+def test_dropdown_alignment_sejda_readonly(
     dropdown_alignment_sejda, pdf_samples, request
 ):
     expected_path = os.path.join(
-        pdf_samples, "dropdown", "test_dropdown_alignment_sejda_flatten.pdf"
+        pdf_samples, "dropdown", "test_dropdown_alignment_sejda_readonly.pdf"
     )
     with open(
         expected_path,
@@ -154,7 +154,7 @@ def test_dropdown_alignment_sejda_flatten(
                 "dropdown_center": 1,
                 "dropdown_right": 2,
             },
-            flatten=True,
+            readonly=True,
         )
 
         request.config.results["expected_path"] = expected_path
@@ -166,13 +166,13 @@ def test_dropdown_alignment_sejda_flatten(
         assert obj.read() == expected
 
 
-def test_dropdown_alignment_sejda_flatten_then_unflatten(
+def test_dropdown_alignment_sejda_readonly_then_editable(
     dropdown_alignment_sejda, pdf_samples, request
 ):
     expected_path = os.path.join(
         pdf_samples,
         "dropdown",
-        "test_dropdown_alignment_sejda_flatten_then_unflatten.pdf",
+        "test_dropdown_alignment_sejda_readonly_then_editable.pdf",
     )
     with open(
         expected_path,
@@ -184,7 +184,7 @@ def test_dropdown_alignment_sejda_flatten_then_unflatten(
                 "dropdown_center": 1,
                 "dropdown_right": 2,
             },
-            flatten=True,
+            readonly=True,
         )
         obj.widgets["dropdown_center"].readonly = False
 

{pypdfform-5.5.5 → pypdfform-6.0.0}/tests/test_extract_middleware_attributes.py

@@ -73,7 +73,7 @@ def test_addition_operator_3_times_values(template_stream, data_dict):
 
 
 def test_field_readonly(pdf_samples):
-    obj = PdfWrapper(os.path.join(pdf_samples, "test_fill_flatten_then_unflatten.pdf"))
+    obj = PdfWrapper(os.path.join(pdf_samples, "test_fill_readonly_then_editable.pdf"))
 
     for k, v in obj.widgets.items():
         if k in ["test_2", "check_3"]:
@@ -83,7 +83,7 @@ def test_field_readonly(pdf_samples):
 
 
 def test_field_readonly_sejda(pdf_samples):
-    obj = PdfWrapper(os.path.join(pdf_samples, "test_fill_sejda_flatten.pdf"))
+    obj = PdfWrapper(os.path.join(pdf_samples, "test_fill_sejda_readonly.pdf"))
 
     for v in obj.widgets.values():
         assert v.readonly

{pypdfform-5.5.5 → pypdfform-6.0.0}/tests/test_fill_max_length_text_field.py

@@ -63,11 +63,12 @@ def test_fill_comb_text_field_all_chars(
         assert obj.read() == expected
 
 
-def test_fill_comb_text_field_all_chars_flatten(
+def test_fill_comb_text_field_all_chars_readonly(
     sample_template_with_comb_text_field, max_length_expected_directory, request
 ):
     expected_path = os.path.join(
-        max_length_expected_directory, "test_fill_comb_text_field_all_chars_flatten.pdf"
+        max_length_expected_directory,
+        "test_fill_comb_text_field_all_chars_readonly.pdf",
     )
     with open(
         expected_path,
@@ -81,7 +82,7 @@ def test_fill_comb_text_field_all_chars_flatten(
                 "Awesomeness": True,
                 "Gender": 0,
             },
-            flatten=True,
+            readonly=True,
         )
 
         request.config.results["expected_path"] = expected_path

{pypdfform-5.5.5 → pypdfform-6.0.0}/tests/test_functional.py

@@ -121,10 +121,10 @@ def test_write_io(template_stream):
     assert PdfWrapper(buff.read()).widgets.keys() == obj.widgets.keys()
 
 
-def test_fill_flatten_then_unflatten(template_stream, pdf_samples, data_dict, request):
-    expected_path = os.path.join(pdf_samples, "test_fill_flatten_then_unflatten.pdf")
+def test_fill_readonly_then_editable(template_stream, pdf_samples, data_dict, request):
+    expected_path = os.path.join(pdf_samples, "test_fill_readonly_then_editable.pdf")
     with open(expected_path, "rb+") as f:
-        obj = PdfWrapper(template_stream).fill(data_dict, flatten=True)
+        obj = PdfWrapper(template_stream).fill(data_dict, readonly=True)
         obj.widgets["test_2"].readonly = False
         obj.widgets["check_3"].readonly = False
 
@@ -178,11 +178,11 @@ def test_fill_with_customized_widgets(
 
 
 @pytest.mark.requires_zlib_over_zlib_ng
-def test_fill_with_customized_widgets_flatten(
+def test_fill_with_customized_widgets_readonly(
     template_stream, pdf_samples, sample_font_stream, data_dict, request
 ):
     expected_path = os.path.join(
-        pdf_samples, "test_fill_with_customized_widgets_flatten.pdf"
+        pdf_samples, "test_fill_with_customized_widgets_readonly.pdf"
     )
     with open(
         expected_path,
@@ -198,7 +198,7 @@ def test_fill_with_customized_widgets_flatten(
         obj.widgets["test_2"].font_color = (0, 1, 0)
         obj.fill(
             data_dict,
-            flatten=True,
+            readonly=True,
         )
 
         request.config.results["expected_path"] = expected_path
@@ -230,10 +230,10 @@ def test_fill_with_varied_int_values(template_stream, pdf_samples, request):
         assert obj.read() == expected
 
 
-def test_fill_radiobutton_flatten(
+def test_fill_radiobutton_readonly(
     template_with_radiobutton_stream, pdf_samples, request
 ):
-    expected_path = os.path.join(pdf_samples, "test_fill_radiobutton_flatten.pdf")
+    expected_path = os.path.join(pdf_samples, "test_fill_radiobutton_readonly.pdf")
     with open(
         expected_path,
         "rb+",
@@ -244,7 +244,7 @@ def test_fill_radiobutton_flatten(
                 "radio_2": 1,
                 "radio_3": 2,
             },
-            flatten=True,
+            readonly=True,
         )
 
         request.config.results["expected_path"] = expected_path
@@ -256,11 +256,11 @@ def test_fill_radiobutton_flatten(
         assert obj.read() == expected
 
 
-def test_fill_radiobutton_flatten_then_unflatten(
+def test_fill_radiobutton_readonly_then_editable(
     template_with_radiobutton_stream, pdf_samples, request
 ):
     expected_path = os.path.join(
-        pdf_samples, "test_fill_radiobutton_flatten_then_unflatten.pdf"
+        pdf_samples, "test_fill_radiobutton_readonly_then_editable.pdf"
     )
     with open(
         expected_path,
@@ -272,7 +272,7 @@ def test_fill_radiobutton_flatten_then_unflatten(
                 "radio_2": 1,
                 "radio_3": 2,
             },
-            flatten=True,
+            readonly=True,
         )
         obj.widgets["radio_2"].readonly = False
 
@@ -302,15 +302,15 @@ def test_fill_sejda(sejda_template, pdf_samples, sejda_data, request):
         assert obj.read() == expected
 
 
-def test_fill_sejda_flatten(sejda_template, pdf_samples, sejda_data, request):
-    expected_path = os.path.join(pdf_samples, "test_fill_sejda_flatten.pdf")
+def test_fill_sejda_readonly(sejda_template, pdf_samples, sejda_data, request):
+    expected_path = os.path.join(pdf_samples, "test_fill_sejda_readonly.pdf")
     with open(
         expected_path,
         "rb+",
     ) as f:
         obj = PdfWrapper(sejda_template).fill(
             sejda_data,
-            flatten=True,
+            readonly=True,
         )
 
         request.config.results["expected_path"] = expected_path
@@ -322,11 +322,11 @@ def test_fill_sejda_flatten(sejda_template, pdf_samples, sejda_data, request):
         assert obj.read() == expected
 
 
-def test_fill_sejda_flatten_then_unflatten(
+def test_fill_sejda_readonly_then_editable(
     sejda_template, pdf_samples, sejda_data, request
 ):
     expected_path = os.path.join(
-        pdf_samples, "test_fill_sejda_flatten_then_unflatten.pdf"
+        pdf_samples, "test_fill_sejda_readonly_then_editable.pdf"
     )
     with open(
         expected_path,
@@ -334,7 +334,7 @@ def test_fill_sejda_flatten_then_unflatten(
     ) as f:
         obj = PdfWrapper(sejda_template).fill(
             sejda_data,
-            flatten=True,
+            readonly=True,
         )
         obj.widgets["buyer_name"].readonly = False
         obj.widgets["at_future_date"].readonly = False

{pypdfform-5.5.5 → pypdfform-6.0.0}/tests/test_paragraph.py

@@ -25,16 +25,16 @@ def test_fill_sejda_complex(
         assert obj.read() == expected
 
 
-def test_fill_sejda_complex_flatten(
+def test_fill_sejda_complex_readonly(
     sejda_template_complex, sejda_complex_data, pdf_samples, request
 ):
     expected_path = os.path.join(
-        pdf_samples, "paragraph", "test_fill_sejda_complex_flatten.pdf"
+        pdf_samples, "paragraph", "test_fill_sejda_complex_readonly.pdf"
     )
     with open(expected_path, "rb+") as f:
         obj = PdfWrapper(sejda_template_complex).fill(
             sejda_complex_data,
-            flatten=True,
+            readonly=True,
         )
 
         request.config.results["expected_path"] = expected_path