PyPDFForm 4.7.10__tar.gz → 4.8.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyPDFForm
-Version: 4.7.10
+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<6.10.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.10 → 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.10"
+__version__ = "4.8.0"
 
 from .lib.annotations import Annotations
 from .lib.assets.blank import BlankPage

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

@@ -6,12 +6,15 @@ 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(
@@ -22,6 +25,16 @@ cli_app.add_typer(
     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",
@@ -169,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.10 → pypdfform-4.8.0}/PyPDFForm.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyPDFForm
-Version: 4.7.10
+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<6.10.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.10 → pypdfform-4.8.0}/PyPDFForm.egg-info/SOURCES.txt

@@ -10,6 +10,8 @@ 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.10 → 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<6.10.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.10 → 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,<6.10.0", # TODO: revert this
+    "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",
 ]
 

{pypdfform-4.7.10 → pypdfform-4.8.0}/tests/test_cli.py

@@ -31,6 +31,14 @@ def test_root_command_with_version():
     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"])
@@ -39,6 +47,22 @@ def test_coordinate_command():
     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"])

pypdfform-4.7.10/PyPDFForm/cli/coordinate.py

@@ -1,80 +0,0 @@
-# -*- 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.
-"""
-
-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)