PyPDFForm 4.7.9__tar.gz → 4.8.0__tar.gz

{pypdfform-4.7.9 → pypdfform-4.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyPDFForm
-Version: 4.7.9
+Version: 4.8.0
 Summary: The Python library for PDF forms.
 Author: Jinge Li
 License-Expression: MIT
@@ -21,26 +21,26 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: cryptography<47.0.0,>=46.0.3
-Requires-Dist: fonttools<5.0.0,>=4.60.1
+Requires-Dist: fonttools<5.0.0,>=4.62.1
 Requires-Dist: pikepdf<11.0.0,>=10.5.0
 Requires-Dist: pillow<13.0.0,>=12.0.0
-Requires-Dist: pypdf<7.0.0,>=6.9.0
+Requires-Dist: pypdf<7.0.0,>=6.10.1
 Requires-Dist: reportlab<5.0.0,>=4.4.6
 Provides-Extra: cli
 Requires-Dist: typer<1.0.0,>=0.24.1; extra == "cli"
 Provides-Extra: dev
 Requires-Dist: black<27.0.0,>=25.11.0; extra == "dev"
 Requires-Dist: coverage<8.0.0,>=7.12.0; extra == "dev"
-Requires-Dist: isort<9.0.0,>=7.0.0; extra == "dev"
-Requires-Dist: jsonschema<5.0.0,>=4.25.1; extra == "dev"
+Requires-Dist: isort<9.0.0,>=8.0.1; extra == "dev"
+Requires-Dist: jsonschema<5.0.0,>=4.26.0; extra == "dev"
 Requires-Dist: mike<3.0.0,>=2.1.3; extra == "dev"
 Requires-Dist: mkdocs<2.0.0,>=1.6.1; extra == "dev"
 Requires-Dist: mkdocs-material<10.0.0,>=9.7.0; extra == "dev"
 Requires-Dist: pudb<2026.0.0,>=2025.1.3; extra == "dev"
 Requires-Dist: pylint<5.0.0,>=4.0.3; extra == "dev"
 Requires-Dist: pyright<2.0.0,>=1.1.407; extra == "dev"
-Requires-Dist: pytest<10.0.0,>=9.0.1; extra == "dev"
-Requires-Dist: requests<3.0.0,>=2.32.5; extra == "dev"
+Requires-Dist: pytest<10.0.0,>=9.0.3; extra == "dev"
+Requires-Dist: requests<3.0.0,>=2.33.1; extra == "dev"
 Requires-Dist: ruff<1.0.0,>=0.14.6; extra == "dev"
 Dynamic: license-file
 

{pypdfform-4.7.9 → pypdfform-4.8.0}/PyPDFForm/__init__.py

@@ -22,7 +22,7 @@ PyPDFForm aims to simplify PDF form manipulation, making it accessible to develo
 
 import logging
 
-__version__ = "4.7.9"
+__version__ = "4.8.0"
 
 from .lib.annotations import Annotations
 from .lib.assets.blank import BlankPage

{pypdfform-4.7.9 → pypdfform-4.8.0}/PyPDFForm/cli/__init__.py

@@ -6,16 +6,35 @@ It defines the CLI application using Typer, providing commands for
 interacting with PyPDFForm functionality from the terminal.
 """
 
+import json
 from typing import Annotated
 
 import typer
 
-from .. import __version__
+from .. import PdfWrapper, Widgets, __version__
+from .coordinate import coordinate_cli
+from .create import create_cli
+from .inspect import inspect_cli
 from .update import update_cli
 
 cli_app = typer.Typer(
     context_settings={"help_option_names": ["--help", "-h"]}, no_args_is_help=True
 )
+cli_app.add_typer(
+    coordinate_cli,
+    name="coordinate",
+    help="Subcommands for interacting with PDF coordinates and dimensions.",
+)
+cli_app.add_typer(
+    create_cli,
+    name="create",
+    help="Subcommands for creating elements on PDF forms.",
+)
+cli_app.add_typer(
+    inspect_cli,
+    name="inspect",
+    help="Subcommands for inspecting PDF forms.",
+)
 cli_app.add_typer(
     update_cli,
     name="update",
@@ -114,7 +133,7 @@ def use_full_widget_name_callback(ctx: typer.Context, value: bool) -> None:
     ctx.obj["use_full_widget_name"] = value
 
 
-@cli_app.callback(invoke_without_command=True, help="Welcome to the PyPDFForm CLI!")
+@cli_app.callback(invoke_without_command=True, help="PyPDFForm command-line interface.")
 def main(
     version: Annotated[  # pylint: disable=W0613
         bool,
@@ -123,7 +142,7 @@ def main(
             "-v",
             callback=version_callback,
             is_eager=True,
-            help="Show current version of the CLI and exit.",
+            help="Show the current version of the CLI and exit.",
         ),
     ] = False,
     need_appearances: Annotated[  # pylint: disable=W0613
@@ -147,7 +166,7 @@ def main(
         typer.Option(
             "--preserve-metadata",
             callback=preserve_metadata_callback,
-            help="Preserve PDF metadata in output.",
+            help="Preserve PDF metadata in the output.",
         ),
     ] = False,
     use_full_widget_name: Annotated[  # pylint: disable=W0613
@@ -163,4 +182,48 @@ def main(
     ...
 
 
+@cli_app.command(no_args_is_help=True)
+def fill(
+    ctx: typer.Context,
+    pdf: Annotated[str, typer.Argument(help="Path to the input PDF file.")],
+    data: Annotated[
+        str,
+        typer.Option(
+            "--file",
+            "-f",
+            help="Path to the JSON file representing the filling data.",
+        ),
+    ],
+    output: Annotated[
+        str,
+        typer.Option(
+            "--output",
+            "-o",
+            help="Path to save the output PDF. Defaults to the original path if not specified.",
+        ),
+    ] = None,
+    flatten: Annotated[
+        bool,
+        typer.Option(
+            "--flatten", help="Whether to flatten the filled PDF form or not."
+        ),
+    ] = None,
+) -> None:
+    """
+    Fill a PDF form.
+    """
+    with open(data, "r", encoding="utf-8") as f:
+        input_data = json.load(f)
+
+    obj = PdfWrapper(pdf, **ctx.obj)
+    for k, each in obj.widgets.items():
+        if k in input_data and isinstance(each, (Widgets.Image, Widgets.Signature)):
+            each.preserve_aspect_ratio = input_data.get(k, {}).get(
+                "preserve_aspect_ratio", each.preserve_aspect_ratio
+            )
+            input_data[k] = input_data[k]["path"]
+
+    obj.fill(input_data, flatten=flatten).write(output or pdf)
+
+
 __all__ = ["cli_app"]

pypdfform-4.8.0/PyPDFForm/cli/coordinate.py

@@ -0,0 +1,165 @@
+# -*- coding: utf-8 -*-
+"""
+CLI commands for interacting with PDF coordinates.
+
+This module provides command-line interface commands for working with
+PDF coordinates and dimensions, such as generating a coordinate grid view.
+"""
+
+import json
+from typing import Annotated
+
+import typer
+
+from .. import PdfWrapper
+
+coordinate_cli = typer.Typer(
+    context_settings={"help_option_names": ["--help", "-h"]}, no_args_is_help=True
+)
+
+
+@coordinate_cli.command(no_args_is_help=True)
+def grid(
+    ctx: typer.Context,
+    pdf: Annotated[str, typer.Argument(help="Path to the input PDF file.")],
+    output: Annotated[
+        str,
+        typer.Option(
+            "--output",
+            "-o",
+            help="Path to save the output PDF. Defaults to the original path if not specified.",
+        ),
+    ] = None,
+    red: Annotated[
+        float,
+        typer.Option(
+            "--red",
+            "-r",
+            help="Red channel of the RGB color.",
+        ),
+    ] = None,
+    green: Annotated[
+        float,
+        typer.Option(
+            "--green",
+            "-g",
+            help="Green channel of the RGB color.",
+        ),
+    ] = None,
+    blue: Annotated[
+        float,
+        typer.Option(
+            "--blue",
+            "-b",
+            help="Blue channel of the RGB color.",
+        ),
+    ] = None,
+    margin: Annotated[
+        float,
+        typer.Option(
+            "--margin",
+            "-m",
+            help="Margin of the grid view in points.",
+        ),
+    ] = None,
+) -> None:
+    """
+    Generate a coordinate grid view for a PDF.
+    """
+    params = {}
+    if any(
+        [
+            red is not None,
+            green is not None,
+            blue is not None,
+        ]
+    ):
+        params["color"] = (red or 0, green or 0, blue or 0)
+
+    if margin is not None:
+        params["margin"] = int(margin) if margin.is_integer() else margin
+    PdfWrapper(pdf, **ctx.obj).generate_coordinate_grid(**params).write(output or pdf)
+
+
+@coordinate_cli.command(no_args_is_help=True)
+def inspect(
+    ctx: typer.Context,
+    pdf: Annotated[str, typer.Argument(help="Path to the input PDF file.")],
+    field: Annotated[
+        str, typer.Option("--field", "-f", help="Name of the form field to inspect.")
+    ],
+) -> None:
+    """
+    Inspect the page number, coordinates, and dimensions of a form field's rectangular bounding box.
+    """
+    f = PdfWrapper(pdf, **ctx.obj).widgets[field]
+
+    print(
+        json.dumps(
+            {
+                "page_number": f.page_number,
+                "x": f.x,
+                "y": f.y,
+                "width": f.width,
+                "height": f.height,
+            }
+        )
+    )
+
+
+@coordinate_cli.command(no_args_is_help=True)
+def modify(
+    ctx: typer.Context,
+    pdf: Annotated[str, typer.Argument(help="Path to the input PDF file.")],
+    field: Annotated[
+        str, typer.Option("--field", "-f", help="Name of the form field to modify.")
+    ],
+    output: Annotated[
+        str,
+        typer.Option(
+            "--output",
+            "-o",
+            help="Path to save the output PDF. Defaults to the original path if not specified.",
+        ),
+    ] = None,
+    x: Annotated[
+        float,
+        typer.Option(
+            "--x",
+            help="New x coordinate.",
+        ),
+    ] = None,
+    y: Annotated[
+        float,
+        typer.Option(
+            "--y",
+            help="New y coordinate.",
+        ),
+    ] = None,
+    width: Annotated[
+        float,
+        typer.Option(
+            "--width",
+            help="New width.",
+        ),
+    ] = None,
+    height: Annotated[
+        float,
+        typer.Option(
+            "--height",
+            help="New height.",
+        ),
+    ] = None,
+) -> None:
+    """
+    Modify the coordinates and dimensions of a form field's rectangular bounding box.
+    """
+    obj = PdfWrapper(pdf, **ctx.obj)
+    f = obj.widgets[field]
+
+    f.x = x if x is not None else f.x
+    f.y = y if y is not None else f.y
+    f.width = width if width is not None else f.width
+    f.height = height if height is not None else f.height
+
+    obj.write(output or pdf)

pypdfform-4.8.0/PyPDFForm/cli/create.py

@@ -0,0 +1,169 @@
+# -*- coding: utf-8 -*-
+"""
+CLI module for creating PDF form fields.
+
+This module provides command-line interfaces to create various types of PDF form fields
+(such as text fields, checkboxes, radio buttons, dropdowns, signatures, and images)
+in an existing PDF. It aims to mimic the field creation features available via the
+Python API as described in the preparation documentation.
+"""
+
+import json
+from typing import Annotated
+
+import typer
+
+from .. import BlankPage, Fields, PdfWrapper, RawElements
+
+create_cli = typer.Typer(
+    context_settings={"help_option_names": ["--help", "-h"]}, no_args_is_help=True
+)
+
+
+def _create_elements_from_file(
+    pdf: str,
+    data: str,
+    element_map: dict,
+    method_name: str,
+    ctx: typer.Context,
+    output: str = None,
+) -> None:
+    """
+    Create PDF elements from a JSON file.
+
+    Args:
+        pdf: Path to the input PDF file.
+        data: Path to the JSON file containing element parameters.
+        element_map: Mapping of element type names to element classes.
+        method_name: Name of the method to call on PdfWrapper (e.g., "bulk_create_fields", "draw").
+        ctx: Typer context containing configuration options.
+        output: Path to save the output PDF. Defaults to the original path if not specified.
+    """
+    with open(data, "r", encoding="utf-8") as f:
+        input_data = json.load(f)
+
+    obj = PdfWrapper(pdf, **ctx.obj)
+    ungrouped_input = []
+    registered_font = {}
+    for k, v in input_data.items():
+        for each in v:
+            if "font" in each:
+                if each["font"] not in registered_font:
+                    font_name = f"new_font_{len(registered_font)}"
+                    obj.register_font(font_name, each["font"])
+                    registered_font[each["font"]] = font_name
+                each["font"] = registered_font[each["font"]]
+            ungrouped_input.append(element_map[k](**each))
+
+    getattr(obj, method_name)(ungrouped_input).write(output or pdf)
+
+
+@create_cli.command(no_args_is_help=True)
+def field(
+    ctx: typer.Context,
+    pdf: Annotated[str, typer.Argument(help="Path to the input PDF file.")],
+    data: Annotated[
+        str,
+        typer.Option(
+            "--file",
+            "-f",
+            help="Path to the JSON file representing the field creation parameters.",
+        ),
+    ],
+    output: Annotated[
+        str,
+        typer.Option(
+            "--output",
+            "-o",
+            help="Path to save the output PDF. Defaults to the original path if not specified.",
+        ),
+    ] = None,
+) -> None:
+    """
+    Create PDF form fields.
+    """
+    field_map = {
+        "text": Fields.TextField,
+        "check": Fields.CheckBoxField,
+        "radio": Fields.RadioGroup,
+        "dropdown": Fields.DropdownField,
+        "image": Fields.ImageField,
+        "signature": Fields.SignatureField,
+    }
+    _create_elements_from_file(pdf, data, field_map, "bulk_create_fields", ctx, output)
+
+
+@create_cli.command(no_args_is_help=True)
+def raw(
+    ctx: typer.Context,
+    pdf: Annotated[str, typer.Argument(help="Path to the input PDF file.")],
+    data: Annotated[
+        str,
+        typer.Option(
+            "--file",
+            "-f",
+            help="Path to the JSON file representing the draw parameters.",
+        ),
+    ],
+    output: Annotated[
+        str,
+        typer.Option(
+            "--output",
+            "-o",
+            help="Path to save the output PDF. Defaults to the original path if not specified.",
+        ),
+    ] = None,
+) -> None:
+    """
+    Draw raw PDF elements.
+    """
+    raw_element_map = {
+        "text": RawElements.RawText,
+        "image": RawElements.RawImage,
+        "line": RawElements.RawLine,
+        "rectangle": RawElements.RawRectangle,
+        "circle": RawElements.RawCircle,
+        "ellipse": RawElements.RawEllipse,
+    }
+    _create_elements_from_file(pdf, data, raw_element_map, "draw", ctx, output)
+
+
+@create_cli.command(no_args_is_help=True)
+def blank(
+    ctx: typer.Context,
+    output: Annotated[
+        str,
+        typer.Option(
+            "--output",
+            "-o",
+            help="Path to save the output PDF.",
+        ),
+    ],
+    count: Annotated[
+        int, typer.Option("--count", "-c", help="Number of blank pages.")
+    ] = None,
+    width: Annotated[
+        float,
+        typer.Option(
+            "--width",
+            help="Width of the blank PDF.",
+        ),
+    ] = None,
+    height: Annotated[
+        float, typer.Option("--height", help="Height of the blank PDF.")
+    ] = None,
+) -> None:
+    """
+    Create a new blank PDF.
+    """
+    params = {}
+    if width is not None:
+        params["width"] = width
+    if height is not None:
+        params["height"] = height
+
+    obj = BlankPage(**params)
+    if count is not None and count > 1:
+        obj = BlankPage(**params) * count
+
+    PdfWrapper(obj, **ctx.obj).write(output)

pypdfform-4.8.0/PyPDFForm/cli/inspect.py

@@ -0,0 +1,53 @@
+# -*- coding: utf-8 -*-
+"""
+CLI commands for inspecting PDF form field data.
+
+This module provides command-line interface commands for extracting
+information from PDF forms. Features include generating a JSON schema
+describing the form fields, inspecting the current filled data of a
+PDF form, and generating sample data for filling a form.
+"""
+
+import json
+from typing import Annotated
+
+import typer
+
+from .. import PdfWrapper
+
+inspect_cli = typer.Typer(
+    context_settings={"help_option_names": ["--help", "-h"]}, no_args_is_help=True
+)
+
+
+@inspect_cli.command(no_args_is_help=True)
+def schema(
+    ctx: typer.Context,
+    pdf: Annotated[str, typer.Argument(help="Path to the input PDF file.")],
+) -> None:
+    """
+    Generate a JSON schema that describes a PDF form.
+    """
+    print(json.dumps(PdfWrapper(pdf, **ctx.obj).schema))
+
+
+@inspect_cli.command(no_args_is_help=True)
+def data(
+    ctx: typer.Context,
+    pdf: Annotated[str, typer.Argument(help="Path to the input PDF file.")],
+) -> None:
+    """
+    Inspect the current filled data of a PDF form.
+    """
+    print(json.dumps(PdfWrapper(pdf, **ctx.obj).data))
+
+
+@inspect_cli.command(no_args_is_help=True)
+def sample(
+    ctx: typer.Context,
+    pdf: Annotated[str, typer.Argument(help="Path to the input PDF file.")],
+) -> None:
+    """
+    Generate sample data for filling a PDF form.
+    """
+    print(json.dumps(PdfWrapper(pdf, **ctx.obj).sample_data))

{pypdfform-4.7.9 → pypdfform-4.8.0}/PyPDFForm/cli/update.py

@@ -1,12 +1,11 @@
 # -*- coding: utf-8 -*-
-# TODO: fix this docstring
 """
-CLI commands for updating PDF metadata.
+CLI commands for updating PDFs.
 
 This module provides command-line interface commands for modifying
-PDF file metadata such as title, author, subject, and other properties.
+PDF files, such as updating metadata or other elements.
 These commands allow users to update PDF documents directly from
-the terminal without needing to use Python code.
+the terminal without needing to write Python code.
 
 The commands in this module wrap the functionality provided by
 the PdfWrapper class, exposing it through a Typer-based CLI for
@@ -27,20 +26,20 @@ update_cli = typer.Typer(
 @update_cli.command(no_args_is_help=True)
 def title(
     ctx: typer.Context,
-    pdf: Annotated[str, typer.Argument(help="The local path to a PDF.")],
+    pdf: Annotated[str, typer.Argument(help="Path to the input PDF file.")],
     new_title: Annotated[
-        str, typer.Option("--title", "-t", help="The new title for the PDF.")
+        str, typer.Option("--title", "-t", help="The new title for the PDF file.")
     ],
     output: Annotated[
         str,
         typer.Option(
             "--output",
             "-o",
-            help="The location to save the PDF to. Defaults to the original path if unspecified.",
+            help="Path to save the output PDF. Defaults to the original path if not specified.",
         ),
     ] = None,
 ) -> None:
     """
-    Update the title of a PDF.
+    Update the title of a PDF file.
     """
     PdfWrapper(pdf, title=new_title, **ctx.obj).write(output or pdf)

{pypdfform-4.7.9 → pypdfform-4.8.0}/PyPDFForm/lib/middleware/base.py

@@ -62,6 +62,7 @@ class Widget:
         self.hooks_to_trigger: list = []
 
         # coordinate & dimension
+        self.page_number: Optional[int] = None
         self.x: Optional[float | List[float]] = None
         self.y: Optional[float | List[float]] = None
         self.width: Optional[float | List[float]] = None

{pypdfform-4.7.9 → pypdfform-4.8.0}/PyPDFForm/lib/template.py

@@ -73,28 +73,32 @@ def build_widgets(
     """
     results = {}
 
-    for widgets in get_widgets_by_page(pdf_stream).values():
+    for page_num, widgets in get_widgets_by_page(pdf_stream).items():
         for widget in widgets:
-            _process_widget(widget, use_full_widget_name, results)
+            _process_widget(widget, page_num, use_full_widget_name, results)
 
     return results
 
 
 def _process_widget(
-    widget: dict, use_full_widget_name: bool, results: Dict[str, WIDGET_TYPES]
+    widget: dict,
+    page_number: int,
+    use_full_widget_name: bool,
+    results: Dict[str, WIDGET_TYPES],
 ) -> None:
     """
     Processes a single widget and adds it to the results dictionary.
 
     Args:
         widget (dict): The widget dictionary from the PDF.
+        page_number (int): The 1-indexed page number the widget appears on.
         use_full_widget_name (bool): Whether to use the full widget name.
         results (Dict[str, WIDGET_TYPES]): The dictionary of widgets being built.
     """
     key = get_widget_key(widget, use_full_widget_name)
     _widget = construct_widget(widget, key)
     if _widget is not None:
-        _populate_common_properties(widget, _widget)
+        _populate_common_properties(widget, page_number, _widget)
 
         if isinstance(_widget, Text):
             _populate_text_properties(widget, _widget)
@@ -111,15 +115,19 @@ def _process_widget(
             results[key] = _widget
 
 
-def _populate_common_properties(widget: dict, _widget: WIDGET_TYPES) -> None:
+def _populate_common_properties(
+    widget: dict, page_number: int, _widget: WIDGET_TYPES
+) -> None:
     """
     Populates common properties for a widget.
 
     Args:
         widget (dict): The widget dictionary from the PDF.
+        page_number (int): The 1-indexed page number the widget appears on.
         _widget (WIDGET_TYPES): The widget object to populate.
     """
     # widget property extractions don't trigger hooks in this function
+    _widget.__dict__["page_number"] = page_number
     _widget.__dict__["tooltip"] = extract_widget_property(
         widget, WIDGET_DESCRIPTION_PATTERNS, None, str
     )

{pypdfform-4.7.9 → pypdfform-4.8.0}/PyPDFForm.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyPDFForm
-Version: 4.7.9
+Version: 4.8.0
 Summary: The Python library for PDF forms.
 Author: Jinge Li
 License-Expression: MIT
@@ -21,26 +21,26 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: cryptography<47.0.0,>=46.0.3
-Requires-Dist: fonttools<5.0.0,>=4.60.1
+Requires-Dist: fonttools<5.0.0,>=4.62.1
 Requires-Dist: pikepdf<11.0.0,>=10.5.0
 Requires-Dist: pillow<13.0.0,>=12.0.0
-Requires-Dist: pypdf<7.0.0,>=6.9.0
+Requires-Dist: pypdf<7.0.0,>=6.10.1
 Requires-Dist: reportlab<5.0.0,>=4.4.6
 Provides-Extra: cli
 Requires-Dist: typer<1.0.0,>=0.24.1; extra == "cli"
 Provides-Extra: dev
 Requires-Dist: black<27.0.0,>=25.11.0; extra == "dev"
 Requires-Dist: coverage<8.0.0,>=7.12.0; extra == "dev"
-Requires-Dist: isort<9.0.0,>=7.0.0; extra == "dev"
-Requires-Dist: jsonschema<5.0.0,>=4.25.1; extra == "dev"
+Requires-Dist: isort<9.0.0,>=8.0.1; extra == "dev"
+Requires-Dist: jsonschema<5.0.0,>=4.26.0; extra == "dev"
 Requires-Dist: mike<3.0.0,>=2.1.3; extra == "dev"
 Requires-Dist: mkdocs<2.0.0,>=1.6.1; extra == "dev"
 Requires-Dist: mkdocs-material<10.0.0,>=9.7.0; extra == "dev"
 Requires-Dist: pudb<2026.0.0,>=2025.1.3; extra == "dev"
 Requires-Dist: pylint<5.0.0,>=4.0.3; extra == "dev"
 Requires-Dist: pyright<2.0.0,>=1.1.407; extra == "dev"
-Requires-Dist: pytest<10.0.0,>=9.0.1; extra == "dev"
-Requires-Dist: requests<3.0.0,>=2.32.5; extra == "dev"
+Requires-Dist: pytest<10.0.0,>=9.0.3; extra == "dev"
+Requires-Dist: requests<3.0.0,>=2.33.1; extra == "dev"
 Requires-Dist: ruff<1.0.0,>=0.14.6; extra == "dev"
 Dynamic: license-file
 

{pypdfform-4.7.9 → pypdfform-4.8.0}/PyPDFForm.egg-info/SOURCES.txt

@@ -9,6 +9,9 @@ PyPDFForm.egg-info/entry_points.txt
 PyPDFForm.egg-info/requires.txt
 PyPDFForm.egg-info/top_level.txt
 PyPDFForm/cli/__init__.py
+PyPDFForm/cli/coordinate.py
+PyPDFForm/cli/create.py
+PyPDFForm/cli/inspect.py
 PyPDFForm/cli/update.py
 PyPDFForm/lib/__init__.py
 PyPDFForm/lib/adapter.py

{pypdfform-4.7.9 → pypdfform-4.8.0}/PyPDFForm.egg-info/requires.txt

@@ -1,8 +1,8 @@
 cryptography<47.0.0,>=46.0.3
-fonttools<5.0.0,>=4.60.1
+fonttools<5.0.0,>=4.62.1
 pikepdf<11.0.0,>=10.5.0
 pillow<13.0.0,>=12.0.0
-pypdf<7.0.0,>=6.9.0
+pypdf<7.0.0,>=6.10.1
 reportlab<5.0.0,>=4.4.6
 
 [cli]
@@ -11,14 +11,14 @@ typer<1.0.0,>=0.24.1
 [dev]
 black<27.0.0,>=25.11.0
 coverage<8.0.0,>=7.12.0
-isort<9.0.0,>=7.0.0
-jsonschema<5.0.0,>=4.25.1
+isort<9.0.0,>=8.0.1
+jsonschema<5.0.0,>=4.26.0
 mike<3.0.0,>=2.1.3
 mkdocs<2.0.0,>=1.6.1
 mkdocs-material<10.0.0,>=9.7.0
 pudb<2026.0.0,>=2025.1.3
 pylint<5.0.0,>=4.0.3
 pyright<2.0.0,>=1.1.407
-pytest<10.0.0,>=9.0.1
-requests<3.0.0,>=2.32.5
+pytest<10.0.0,>=9.0.3
+requests<3.0.0,>=2.33.1
 ruff<1.0.0,>=0.14.6

{pypdfform-4.7.9 → pypdfform-4.8.0}/pyproject.toml

@@ -26,10 +26,10 @@ classifiers = [
 requires-python = ">=3.10"
 dependencies = [
     "cryptography>=46.0.3,<47.0.0",
-    "fonttools>=4.60.1,<5.0.0",
+    "fonttools>=4.62.1,<5.0.0",
     "pikepdf>=10.5.0,<11.0.0",
     "pillow>=12.0.0,<13.0.0",
-    "pypdf>=6.9.0,<7.0.0",
+    "pypdf>=6.10.1,<7.0.0",
     "reportlab>=4.4.6,<5.0.0",
 ]
 
@@ -42,16 +42,16 @@ cli = ["typer>=0.24.1,<1.0.0"]
 dev = [
     "black>=25.11.0,<27.0.0",
     "coverage>=7.12.0,<8.0.0",
-    "isort>=7.0.0,<9.0.0",
-    "jsonschema>=4.25.1,<5.0.0",
+    "isort>=8.0.1,<9.0.0",
+    "jsonschema>=4.26.0,<5.0.0",
     "mike>=2.1.3,<3.0.0",
     "mkdocs>=1.6.1,<2.0.0",
     "mkdocs-material>=9.7.0,<10.0.0",
     "pudb>=2025.1.3,<2026.0.0",
     "pylint>=4.0.3,<5.0.0",
     "pyright>=1.1.407,<2.0.0",
-    "pytest>=9.0.1,<10.0.0",
-    "requests>=2.32.5,<3.0.0",
+    "pytest>=9.0.3,<10.0.0",
+    "requests>=2.33.1,<3.0.0",
     "ruff>=0.14.6,<1.0.0",
 ]
 
@@ -139,4 +139,5 @@ include = ["PyPDFForm*"]
 [tool.pytest.ini_options]
 markers = [
     "posix_only", # mainly because of zlib vs zlib-ng
+    "cli_test",
 ]

{pypdfform-4.7.9 → pypdfform-4.8.0}/tests/test_bulk_create_fields.py

@@ -62,6 +62,21 @@ def test_bulk_create_fields_stress_max(pdf_samples, request):
             obj += PdfWrapper(os.path.join(pdf_samples, "dummy.pdf"))
         obj.bulk_create_fields(fields)
 
+        prefix_to_page = {
+            "text_": 1,
+            "check_": 2,
+            "dropdown_": 3,
+            "radio_": 4,
+            "image_": 5,
+            "signature_": 6,
+        }
+
+        for k, v in obj.widgets.items():
+            for each, page in prefix_to_page.items():
+                if k.startswith(each):
+                    assert v.page_number == page
+                    break
+
         request.config.results["expected_path"] = expected_path
         request.config.results["stream"] = obj.read()
 

pypdfform-4.8.0/tests/test_cli.py

@@ -0,0 +1,71 @@
+# -*- coding: utf-8 -*-
+
+import pytest
+from typer.testing import CliRunner
+
+from PyPDFForm import __version__
+from PyPDFForm.cli import cli_app
+
+runner = CliRunner()
+
+
+@pytest.mark.cli_test
+def test_root_command():
+    result = runner.invoke(cli_app)
+    assert result.exit_code == 2
+
+    assert "PyPDFForm command-line interface." in result.output
+    assert "Usage:" in result.output
+    assert "main" not in result.output
+
+
+@pytest.mark.cli_test
+def test_root_command_with_version():
+    long = runner.invoke(cli_app, ["--version"])
+    short = runner.invoke(cli_app, ["-v"])
+
+    assert long.exit_code == 0
+    assert short.exit_code == 0
+
+    assert long.output == f"v{__version__}\n"
+    assert long.output == short.output
+
+
+@pytest.mark.cli_test
+def test_fill_command():
+    result = runner.invoke(cli_app, ["fill"])
+    assert result.exit_code == 2
+
+    assert "Usage:" in result.output
+
+
+@pytest.mark.cli_test
+def test_coordinate_command():
+    result = runner.invoke(cli_app, ["coordinate"])
+    assert result.exit_code == 2
+
+    assert "Usage:" in result.output
+
+
+@pytest.mark.cli_test
+def test_create_command():
+    result = runner.invoke(cli_app, ["create"])
+    assert result.exit_code == 2
+
+    assert "Usage:" in result.output
+
+
+@pytest.mark.cli_test
+def test_inspect_command():
+    result = runner.invoke(cli_app, ["inspect"])
+    assert result.exit_code == 2
+
+    assert "Usage:" in result.output
+
+
+@pytest.mark.cli_test
+def test_update_command():
+    result = runner.invoke(cli_app, ["update"])
+    assert result.exit_code == 2
+
+    assert "Usage:" in result.output

{pypdfform-4.7.9 → pypdfform-4.8.0}/tests/test_functional.py

@@ -747,31 +747,37 @@ def test_widget_coord_resolution():
         ]
     )
 
+    assert obj.widgets["text"].page_number == 1
     assert obj.widgets["text"].x == 50
     assert obj.widgets["text"].y == 100
     assert obj.widgets["text"].width == 200
     assert obj.widgets["text"].height == 150
 
+    assert obj.widgets["check"].page_number == 1
     assert obj.widgets["check"].x == 150
     assert obj.widgets["check"].y == 200
     assert obj.widgets["check"].width == 60
     assert obj.widgets["check"].height == 60
 
+    assert obj.widgets["radio"].page_number == 1
     assert obj.widgets["radio"].x == [400, 500, 600]
     assert obj.widgets["radio"].y == [450, 550, 650]
     assert obj.widgets["radio"].width == 10
     assert obj.widgets["radio"].height == 10
 
+    assert obj.widgets["dropdown"].page_number == 1
     assert obj.widgets["dropdown"].x == 400
     assert obj.widgets["dropdown"].y == 100
     assert obj.widgets["dropdown"].width == 250
     assert obj.widgets["dropdown"].height == 200
 
+    assert obj.widgets["image"].page_number == 1
     assert obj.widgets["image"].x == 300
     assert obj.widgets["image"].y == 400
     assert obj.widgets["image"].width == 400
     assert obj.widgets["image"].height == 300
 
+    assert obj.widgets["signature"].page_number == 1
     assert obj.widgets["signature"].x == 500
     assert obj.widgets["signature"].y == 600
     assert obj.widgets["signature"].width == 600

pypdfform-4.7.9/tests/test_cli.py

@@ -1,35 +0,0 @@
-# -*- coding: utf-8 -*-
-
-from typer.testing import CliRunner
-
-from PyPDFForm import __version__
-from PyPDFForm.cli import cli_app
-
-runner = CliRunner()
-
-
-def test_root_command():
-    result = runner.invoke(cli_app)
-    assert result.exit_code == 2
-
-    assert "Welcome to the PyPDFForm CLI!" in result.output
-    assert "Usage:" in result.output
-    assert "main" not in result.output
-
-
-def test_root_command_with_version():
-    long = runner.invoke(cli_app, ["--version"])
-    short = runner.invoke(cli_app, ["-v"])
-
-    assert long.exit_code == 0
-    assert short.exit_code == 0
-
-    assert long.output == f"v{__version__}\n"
-    assert long.output == short.output
-
-
-def test_update_command():
-    result = runner.invoke(cli_app, ["update"])
-    assert result.exit_code == 2
-
-    assert "Usage:" in result.output