PyPDFForm 4.8.2__tar.gz → 4.8.3__tar.gz

{pypdfform-4.8.2 → pypdfform-4.8.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyPDFForm
-Version: 4.8.2
+Version: 4.8.3
 Summary: The Python library for PDF forms.
 Author: Jinge Li
 License-Expression: MIT
@@ -20,18 +20,18 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: cryptography<47.0.0,>=46.0.3
+Requires-Dist: cryptography<48.0.0,>=47.0.0
 Requires-Dist: fonttools<5.0.0,>=4.62.1
-Requires-Dist: pikepdf<11.0.0,>=10.5.0
+Requires-Dist: pikepdf<11.0.0,>=10.5.1
 Requires-Dist: pillow<13.0.0,>=12.2.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"
+Requires-Dist: typer<1.0.0,>=0.25.0; extra == "cli"
 Requires-Dist: jsonschema<5.0.0,>=4.26.0; extra == "cli"
 Provides-Extra: dev
 Requires-Dist: black<27.0.0,>=26.3.1; extra == "dev"
-Requires-Dist: coverage<8.0.0,>=7.12.0; extra == "dev"
+Requires-Dist: coverage<8.0.0,>=7.13.5; extra == "dev"
 Requires-Dist: isort<9.0.0,>=8.0.1; extra == "dev"
 Requires-Dist: mike<3.0.0,>=2.1.3; extra == "dev"
 Requires-Dist: mkdocs<2.0.0,>=1.6.1; extra == "dev"
@@ -41,7 +41,7 @@ Requires-Dist: pylint<5.0.0,>=4.0.5; extra == "dev"
 Requires-Dist: pyright<2.0.0,>=1.1.407; 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"
+Requires-Dist: ruff<1.0.0,>=0.15.12; extra == "dev"
 Dynamic: license-file
 
 <p align="center"><img src="https://github.com/chinapandaman/PyPDFForm/raw/master/docs/img/logo.png"></p>

{pypdfform-4.8.2 → pypdfform-4.8.3}/PyPDFForm/__init__.py

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

{pypdfform-4.8.2 → pypdfform-4.8.3}/PyPDFForm/cli/common.py

@@ -77,10 +77,10 @@ def json_file_option(help_text: str):
     )
 
 
-def _cli_bad_parameter(
+def cli_bad_parameter(
     message: str,
     param_hint: str,
-    cause: BaseException,
+    cause: BaseException | None = None,
 ) -> NoReturn:
     """
     Raises a Typer input error with a stable CLI message.
@@ -88,11 +88,15 @@ def _cli_bad_parameter(
     Args:
         message (str): Error message to display to the CLI user.
         param_hint (str): CLI parameter associated with the error.
-        cause (BaseException): Original exception that caused the CLI error.
+        cause (BaseException, optional): Original exception that caused the CLI
+            error. Defaults to None.
 
     Raises:
         typer.BadParameter: Raised with the provided message and parameter hint.
     """
+    if cause is None:
+        raise typer.BadParameter(message, param_hint=param_hint)
+
     raise typer.BadParameter(message, param_hint=param_hint) from cause
 
 
@@ -129,7 +133,7 @@ def load_json_file(data: Path, schema: dict, param_hint: str) -> Any:
         with open(data, "r", encoding="utf-8") as f:
             input_data = json.load(f)
     except (OSError, json.JSONDecodeError) as exc:
-        _cli_bad_parameter(
+        cli_bad_parameter(
             f"Invalid JSON file: {exc}",
             param_hint=param_hint,
             cause=exc,
@@ -140,7 +144,7 @@ def load_json_file(data: Path, schema: dict, param_hint: str) -> Any:
     except ValidationError as exc:
         error_path = _validation_error_path(exc)
         location = f" at {error_path}" if error_path else ""
-        _cli_bad_parameter(
+        cli_bad_parameter(
             f"Invalid JSON file{location}: {exc.message}",
             param_hint=param_hint,
             cause=exc,
@@ -167,7 +171,7 @@ def get_widget(wrapper: PdfWrapper, field: str, param_hint: str) -> Widget:
     try:
         return wrapper.widgets[field]
     except KeyError as exc:
-        _cli_bad_parameter(
+        cli_bad_parameter(
             f"Form field '{field}' does not exist.",
             param_hint=param_hint,
             cause=exc,

{pypdfform-4.8.2 → pypdfform-4.8.3}/PyPDFForm/cli/create.py

@@ -17,7 +17,8 @@ import typer
 from .. import (Annotations, BlankPage, Fields, PdfArray, PdfWrapper,
                 RawElements)
 from .common import (INPUT_PDF, OPTIONAL_OUTPUT_PDF, REQUIRED_OUTPUT_PDF,
-                     create_elements_from_file, json_file_option)
+                     cli_bad_parameter, create_elements_from_file,
+                     json_file_option)
 from .schemas.create import ANNOTATION_SCHEMA, FIELD_SCHEMA, RAW_SCHEMA
 
 create_cli = typer.Typer(
@@ -94,6 +95,13 @@ def extract(
     ] = None,
 ) -> None:
     """Extract pages from an existing PDF."""
+    if start is not None and end is not None and start > end:
+        message = "End page must be greater than or equal to start page."
+        cli_bad_parameter(
+            message,
+            param_hint="--end",
+        )
+
     PdfWrapper(str(pdf), **ctx.obj).pages[slice((start or 1) - 1, end)].write(output)
 
 

pypdfform-4.8.3/PyPDFForm/cli/entry.py

@@ -0,0 +1,37 @@
+# -*- coding: utf-8 -*-
+"""
+Console script entry point for the optional PyPDFForm CLI.
+
+The CLI implementation depends on the optional ``cli`` extra. This lightweight
+wrapper lets the ``pypdfform`` command fail with installation guidance instead
+of an import traceback when those optional dependencies are absent.
+"""
+
+import importlib
+import sys
+
+CLI_DEPENDENCIES = {"jsonschema", "typer"}
+CLI_INSTALL_HINT = "pip install 'PyPDFForm[cli]'"
+
+
+def main() -> None:
+    """
+    Run the PyPDFForm CLI.
+
+    Raises:
+        SystemExit: Raised with exit code 1 when optional CLI dependencies are
+            missing.
+    """
+    try:
+        cli_module = importlib.import_module("PyPDFForm.cli.root")
+    except ModuleNotFoundError as exc:
+        if exc.name in CLI_DEPENDENCIES:
+            print(
+                "PyPDFForm CLI dependencies are not installed. "
+                f"Install them with: {CLI_INSTALL_HINT}",
+                file=sys.stderr,
+            )
+            raise SystemExit(1) from None
+        raise
+
+    getattr(cli_module, "cli_app")()

pypdfform-4.8.2/PyPDFForm/cli/__init__.py → pypdfform-4.8.3/PyPDFForm/cli/root.py

@@ -165,6 +165,3 @@ def fill(
             input_data[k] = input_data[k]["path"]
 
     obj.fill(input_data, flatten=flatten).write(output or pdf)
-
-
-__all__ = ["cli_app"]

{pypdfform-4.8.2 → pypdfform-4.8.3}/PyPDFForm/cli/update.py

@@ -17,9 +17,9 @@ import typer
 
 from .. import PdfWrapper
 from ..lib.constants import PdfVersion
-from .common import (FIELD_NAME, INPUT_PDF, OPTIONAL_OUTPUT_PDF, get_widget,
-                     handle_font_registration, json_file_option,
-                     load_json_file)
+from .common import (FIELD_NAME, INPUT_PDF, OPTIONAL_OUTPUT_PDF,
+                     cli_bad_parameter, get_widget, handle_font_registration,
+                     json_file_option, load_json_file)
 from .schemas.update import FIELD_SCHEMA, RENAME_SCHEMA
 
 update_cli = typer.Typer(
@@ -125,6 +125,13 @@ def rename(
     output: OPTIONAL_OUTPUT_PDF = None,
 ) -> None:
     """Rename form fields from JSON."""
+    if ctx.obj.get("use_full_widget_name"):
+        cli_bad_parameter(
+            "Renaming form fields is not supported when "
+            "--use-full-widget-name is enabled.",
+            param_hint="--use-full-widget-name",
+        )
+
     input_data = load_json_file(data, RENAME_SCHEMA, "--file")
 
     obj = PdfWrapper(str(pdf), **ctx.obj)

{pypdfform-4.8.2 → pypdfform-4.8.3}/PyPDFForm.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyPDFForm
-Version: 4.8.2
+Version: 4.8.3
 Summary: The Python library for PDF forms.
 Author: Jinge Li
 License-Expression: MIT
@@ -20,18 +20,18 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: cryptography<47.0.0,>=46.0.3
+Requires-Dist: cryptography<48.0.0,>=47.0.0
 Requires-Dist: fonttools<5.0.0,>=4.62.1
-Requires-Dist: pikepdf<11.0.0,>=10.5.0
+Requires-Dist: pikepdf<11.0.0,>=10.5.1
 Requires-Dist: pillow<13.0.0,>=12.2.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"
+Requires-Dist: typer<1.0.0,>=0.25.0; extra == "cli"
 Requires-Dist: jsonschema<5.0.0,>=4.26.0; extra == "cli"
 Provides-Extra: dev
 Requires-Dist: black<27.0.0,>=26.3.1; extra == "dev"
-Requires-Dist: coverage<8.0.0,>=7.12.0; extra == "dev"
+Requires-Dist: coverage<8.0.0,>=7.13.5; extra == "dev"
 Requires-Dist: isort<9.0.0,>=8.0.1; extra == "dev"
 Requires-Dist: mike<3.0.0,>=2.1.3; extra == "dev"
 Requires-Dist: mkdocs<2.0.0,>=1.6.1; extra == "dev"
@@ -41,7 +41,7 @@ Requires-Dist: pylint<5.0.0,>=4.0.5; extra == "dev"
 Requires-Dist: pyright<2.0.0,>=1.1.407; 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"
+Requires-Dist: ruff<1.0.0,>=0.15.12; extra == "dev"
 Dynamic: license-file
 
 <p align="center"><img src="https://github.com/chinapandaman/PyPDFForm/raw/master/docs/img/logo.png"></p>

{pypdfform-4.8.2 → pypdfform-4.8.3}/PyPDFForm.egg-info/SOURCES.txt

@@ -11,7 +11,9 @@ PyPDFForm.egg-info/top_level.txt
 PyPDFForm/cli/__init__.py
 PyPDFForm/cli/common.py
 PyPDFForm/cli/create.py
+PyPDFForm/cli/entry.py
 PyPDFForm/cli/inspect.py
+PyPDFForm/cli/root.py
 PyPDFForm/cli/update.py
 PyPDFForm/cli/schemas/__init__.py
 PyPDFForm/cli/schemas/create.py

pypdfform-4.8.3/PyPDFForm.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pypdfform = PyPDFForm.cli.entry:main

{pypdfform-4.8.2 → pypdfform-4.8.3}/PyPDFForm.egg-info/requires.txt

@@ -1,17 +1,17 @@
-cryptography<47.0.0,>=46.0.3
+cryptography<48.0.0,>=47.0.0
 fonttools<5.0.0,>=4.62.1
-pikepdf<11.0.0,>=10.5.0
+pikepdf<11.0.0,>=10.5.1
 pillow<13.0.0,>=12.2.0
 pypdf<7.0.0,>=6.10.1
 reportlab<5.0.0,>=4.4.6
 
 [cli]
-typer<1.0.0,>=0.24.1
+typer<1.0.0,>=0.25.0
 jsonschema<5.0.0,>=4.26.0
 
 [dev]
 black<27.0.0,>=26.3.1
-coverage<8.0.0,>=7.12.0
+coverage<8.0.0,>=7.13.5
 isort<9.0.0,>=8.0.1
 mike<3.0.0,>=2.1.3
 mkdocs<2.0.0,>=1.6.1
@@ -21,4 +21,4 @@ pylint<5.0.0,>=4.0.5
 pyright<2.0.0,>=1.1.407
 pytest<10.0.0,>=9.0.3
 requests<3.0.0,>=2.33.1
-ruff<1.0.0,>=0.14.6
+ruff<1.0.0,>=0.15.12

{pypdfform-4.8.2 → pypdfform-4.8.3}/pyproject.toml

@@ -25,9 +25,9 @@ classifiers = [
 ]
 requires-python = ">=3.10"
 dependencies = [
-    "cryptography>=46.0.3,<47.0.0",
+    "cryptography>=47.0.0,<48.0.0",
     "fonttools>=4.62.1,<5.0.0",
-    "pikepdf>=10.5.0,<11.0.0",
+    "pikepdf>=10.5.1,<11.0.0",
     "pillow>=12.2.0,<13.0.0",
     "pypdf>=6.10.1,<7.0.0",
     "reportlab>=4.4.6,<5.0.0",
@@ -38,10 +38,10 @@ Homepage = "https://github.com/chinapandaman/PyPDFForm"
 Documentation = "https://chinapandaman.github.io/PyPDFForm/"
 
 [project.optional-dependencies]
-cli = ["typer>=0.24.1,<1.0.0", "jsonschema>=4.26.0,<5.0.0"]
+cli = ["typer>=0.25.0,<1.0.0", "jsonschema>=4.26.0,<5.0.0"]
 dev = [
     "black>=26.3.1,<27.0.0",
-    "coverage>=7.12.0,<8.0.0",
+    "coverage>=7.13.5,<8.0.0",
     "isort>=8.0.1,<9.0.0",
     "mike>=2.1.3,<3.0.0",
     "mkdocs>=1.6.1,<2.0.0",
@@ -51,11 +51,11 @@ dev = [
     "pyright>=1.1.407,<2.0.0",
     "pytest>=9.0.3,<10.0.0",
     "requests>=2.33.1,<3.0.0",
-    "ruff>=0.14.6,<1.0.0",
+    "ruff>=0.15.12,<1.0.0",
 ]
 
 [project.scripts]
-pypdfform = "PyPDFForm.cli:cli_app"
+pypdfform = "PyPDFForm.cli.entry:main"
 
 [tool.coverage.run]
 include = ["PyPDFForm/*"]

pypdfform-4.8.2/PyPDFForm.egg-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-pypdfform = PyPDFForm.cli:cli_app