PyPDFForm 5.5.3__tar.gz → 5.5.4__tar.gz

{pypdfform-5.5.3 → pypdfform-5.5.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyPDFForm
-Version: 5.5.3
+Version: 5.5.4
 Summary: The Python library & CLI for PDF forms.
 Author: Jinge Li
 License-Expression: MIT

{pypdfform-5.5.3 → pypdfform-5.5.4}/PyPDFForm/__init__.py

@@ -18,7 +18,7 @@ from Python code or from the command line.
 
 import logging
 
-__version__ = "5.5.3"
+__version__ = "5.5.4"
 
 from .lib.annotations import Annotations
 from .lib.assets.blank import BlankPage

{pypdfform-5.5.3 → pypdfform-5.5.4}/PyPDFForm/lib/egress.py

@@ -28,7 +28,7 @@ from .constants import (
 from .template import get_widget_key
 
 
-@lru_cache(maxsize=128)
+@lru_cache(maxsize=8)
 def appearance_streams_handler(pdf: bytes, generate_appearance_streams: bool) -> bytes:
     """
     Handles appearance streams and the /NeedAppearances flag for a PDF form.

{pypdfform-5.5.3 → pypdfform-5.5.4}/PyPDFForm/lib/font.py

@@ -66,7 +66,7 @@ from .raw.text import RawText
 from .watermark import create_watermarks_and_draw
 
 
-@lru_cache(maxsize=128)
+@lru_cache(maxsize=8)
 def validate_font(font_name: str, ttf_stream: bytes) -> bool:
     """
     Validates a TrueType font stream.
@@ -212,7 +212,7 @@ def temporary_font_registration(
                 del _fonts[rl_name]
 
 
-@lru_cache(maxsize=128)
+@lru_cache(maxsize=8)
 def _get_watermark_with_font(ttf_stream: bytes) -> bytes:
     """
     Creates a watermark PDF with a single space character using the specified font.
@@ -235,7 +235,7 @@ def _get_watermark_with_font(ttf_stream: bytes) -> bytes:
         )[0]
 
 
-@lru_cache(maxsize=128)
+@lru_cache(maxsize=8)
 def _compress_ttf(ttf_stream: bytes) -> bytes:
     """
     Compresses a TrueType font stream for embedding in a PDF.
@@ -361,7 +361,7 @@ def register_font_acroform(
         return f.read(), new_font_name
 
 
-@lru_cache(maxsize=128)
+@lru_cache(maxsize=8)
 def _get_base_font_name(ttf_stream: bytes) -> str:
     """
     Extracts the base font name from a TrueType font stream.
@@ -402,7 +402,6 @@ def _get_new_font_name(fonts: dict) -> str:
     return f"{FONT_NAME_PREFIX}{n}"
 
 
-@lru_cache(maxsize=128)
 def get_all_available_fonts(pdf: bytes) -> dict:
     """
     Retrieves all available fonts from a PDF document's AcroForm.

{pypdfform-5.5.3 → pypdfform-5.5.4}/PyPDFForm/lib/image.py

@@ -16,7 +16,7 @@ from PIL import Image
 from .constants import Rect
 
 
-@lru_cache(maxsize=128)
+@lru_cache(maxsize=8)
 def rotate_image(image_stream: bytes, rotation: float | int) -> bytes:
     """
     Rotates an image by a specified angle in degrees.
@@ -49,13 +49,12 @@ def rotate_image(image_stream: bytes, rotation: float | int) -> bytes:
     return result
 
 
-@lru_cache(maxsize=128)
 def get_image_dimensions(image_stream: bytes) -> Tuple[float, float]:
     """
     Retrieves the width and height of an image from its byte stream.
 
-    This cached function uses the PIL library to open the image from the provided
-    byte stream and returns its dimensions (width and height) as a tuple of floats.
+    This function uses the PIL library to open the image from the provided byte
+    stream and returns its dimensions (width and height) as a tuple of floats.
 
     Args:
         image_stream (bytes): The image data as bytes.

{pypdfform-5.5.3 → pypdfform-5.5.4}/PyPDFForm/lib/template.py

@@ -53,7 +53,6 @@ from .patterns import (
 from .utils import extract_widget_property, find_pattern_match
 
 
-@lru_cache(maxsize=128)
 def get_metadata(pdf: bytes) -> dict:
     """
     Retrieves the metadata of a PDF.
@@ -85,13 +84,12 @@ def get_title(pdf: bytes) -> str | None:
     return get_metadata(pdf).get(Title)
 
 
-@lru_cache(maxsize=128)
 def get_on_open_javascript(pdf: bytes) -> str | None:
     """
     Retrieves the JavaScript configured to run when a PDF is opened.
 
-    Results are cached by PDF stream. Only a document-catalog `/OpenAction`
-    whose action type is JavaScript is returned.
+    Only a document-catalog `/OpenAction` whose action type is JavaScript is
+    returned.
 
     Args:
         pdf (bytes): The PDF stream to inspect for a document-open action.
@@ -201,7 +199,7 @@ def build_widgets(
     return deepcopy(_build_widget_cache(pdf_stream, use_full_widget_name))
 
 
-@lru_cache(maxsize=128)
+@lru_cache(maxsize=8)
 def _build_widget_cache(
     pdf_stream: bytes,
     use_full_widget_name: bool,
@@ -379,7 +377,6 @@ def _handle_radio_widget(
         radio.value = radio.number_of_options - 1
 
 
-@lru_cache(maxsize=128)
 def get_widgets_by_page(pdf: bytes) -> Dict[int, List[dict]]:
     """
     Retrieves widgets from a PDF stream, organized by page number.

{pypdfform-5.5.3 → pypdfform-5.5.4}/PyPDFForm/lib/utils.py

@@ -12,7 +12,6 @@ It includes functions for:
 """
 
 from collections.abc import Callable
-from functools import lru_cache
 from io import BytesIO
 from secrets import choice
 from string import ascii_letters, digits, punctuation
@@ -30,7 +29,6 @@ from .constants import (
 )
 
 
-@lru_cache(maxsize=128)
 def remove_all_widgets(pdf: bytes) -> bytes:
     """
     Removes all widgets (form fields) from a PDF, effectively flattening the form.

{pypdfform-5.5.3 → pypdfform-5.5.4}/PyPDFForm/lib/watermark.py

@@ -22,7 +22,7 @@ from .constants import Annots
 from .patterns import get_widget_key
 
 
-@lru_cache(maxsize=128)
+@lru_cache(maxsize=8)
 def _get_image_reader(image_stream: bytes) -> ImageReader:
     """
     Creates a cached ReportLab image reader for an image byte stream.

{pypdfform-5.5.3 → pypdfform-5.5.4}/PyPDFForm/lib/widgets/base.py

@@ -18,9 +18,9 @@ from dataclasses import dataclass
 from functools import lru_cache
 from inspect import signature
 from io import BytesIO
-from typing import Any, List, Optional
+from typing import List, Optional
 
-from pypdf import PdfReader
+from pypdf import PageObject, PdfReader
 from reportlab.lib.colors import Color
 from reportlab.pdfgen.canvas import Canvas
 
@@ -107,7 +107,7 @@ class Widget:
                 self.hook_params.append((each, kwargs.get(each)))
 
     @staticmethod
-    @lru_cache(maxsize=128)
+    @lru_cache(maxsize=8)
     def _get_default_field_flags(acro_form_class: type, acro_form_func: str) -> tuple:
         """
         Retrieves the default field flags for a ReportLab AcroForm method.
@@ -173,12 +173,13 @@ class Widget:
         getattr(canvas.acroForm, self.ACRO_FORM_FUNC)(**self.acro_form_params)
 
     @staticmethod
-    def create_watermark_canvas(page: Any) -> tuple[BytesIO, Canvas]:
+    def create_watermark_canvas(page: PageObject) -> tuple[BytesIO, Canvas]:
         """
         Creates a PDF canvas sized to a source page.
 
         Args:
-            page (Any): The source PDF page whose media box defines the canvas size.
+            page (PageObject): The source PDF page whose media box defines the
+                canvas size.
 
         Returns:
             tuple[BytesIO, Canvas]: The in-memory stream and its PDF canvas.

{pypdfform-5.5.3 → pypdfform-5.5.4}/PyPDFForm/lib/widgets/image.py

@@ -10,13 +10,14 @@ action.
 """
 
 from dataclasses import dataclass
-from typing import Any, List, Type
+from typing import Type
 
 from pypdf import PdfWriter
 from pypdf.generic import (
     ArrayObject,
     DictionaryObject,
     FloatObject,
+    IndirectObject,
     NameObject,
     NumberObject,
     TextStringObject,
@@ -65,7 +66,7 @@ class ImageWidget(SignatureWidget):
     """
 
     @staticmethod
-    def _build_annotation(out: PdfWriter, widget: SignatureWidget) -> Any:
+    def _build_annotation(out: PdfWriter, widget: SignatureWidget) -> IndirectObject:
         """
         Constructs an image-import widget annotation owned by a PDF writer.
 
@@ -82,7 +83,8 @@ class ImageWidget(SignatureWidget):
                 convert into a PDF annotation.
 
         Returns:
-            Any: The writer-owned indirect reference to the widget annotation.
+            IndirectObject: The writer-owned indirect reference to the widget
+                annotation.
         """
         width = float(widget.optional_parameters["width"])
         height = float(widget.optional_parameters["height"])
@@ -152,30 +154,6 @@ class ImageWidget(SignatureWidget):
             annotation
         )
 
-    @staticmethod
-    def bulk_watermarks(widgets: List[SignatureWidget], stream: bytes) -> List[bytes]:
-        """
-        Constructs image widgets in page-aligned carrier PDFs.
-
-        Each image field is built as a push-button annotation whose JavaScript
-        action invokes `buttonImportIcon()` in viewers that support Acrobat
-        JavaScript. A single border-only appearance stream is reused for the
-        normal, rollover, and pressed states. It has a transparent interior and
-        the same dark-gray, one-point solid border as the signature widget.
-        ``build_widget_watermarks`` packages the annotations by source page.
-
-        Args:
-            widgets (List[SignatureWidget]): Image widgets to construct.
-            stream (bytes): Source PDF used to determine page count and page size.
-
-        Returns:
-            List[bytes]: Page-aligned PDF streams containing the constructed
-            image annotations.
-        """
-        return ImageWidget.build_widget_watermarks(
-            widgets, stream, ImageWidget._build_annotation
-        )
-
 
 @dataclass
 class ImageField(SignatureField):

{pypdfform-5.5.3 → pypdfform-5.5.4}/PyPDFForm/lib/widgets/signature.py

@@ -17,13 +17,14 @@ from __future__ import annotations
 from collections import defaultdict
 from dataclasses import dataclass
 from io import BytesIO
-from typing import Any, Callable, List, Optional, Type
+from typing import Callable, List, Optional, Type
 
 from pypdf import PdfReader, PdfWriter
 from pypdf.generic import (
     ArrayObject,
     DictionaryObject,
     FloatObject,
+    IndirectObject,
     NameObject,
     NumberObject,
     StreamObject,
@@ -121,7 +122,7 @@ class SignatureWidget:
     def build_widget_watermarks(
         widgets: List[SignatureWidget],
         stream: bytes,
-        annotation_builder: Callable[[PdfWriter, SignatureWidget], Any],
+        annotation_builder: Callable[[PdfWriter, SignatureWidget], IndirectObject],
     ) -> List[bytes]:
         """
         Builds page-aligned carrier PDFs from widget annotation objects.
@@ -246,7 +247,7 @@ class SignatureWidget:
         )
 
     @staticmethod
-    def _build_annotation(out: PdfWriter, widget: SignatureWidget) -> Any:
+    def _build_annotation(out: PdfWriter, widget: SignatureWidget) -> IndirectObject:
         """
         Constructs a signature widget annotation owned by a PDF writer.
 
@@ -262,7 +263,8 @@ class SignatureWidget:
                 to convert into a PDF annotation.
 
         Returns:
-            Any: The writer-owned indirect reference to the widget annotation.
+            IndirectObject: The writer-owned indirect reference to the widget
+                annotation.
         """
         width = float(widget.optional_parameters["width"])
         height = float(widget.optional_parameters["height"])
@@ -308,29 +310,25 @@ class SignatureWidget:
             annotation
         )
 
-    @staticmethod
-    def bulk_watermarks(widgets: List[SignatureWidget], stream: bytes) -> List[bytes]:
+    @classmethod
+    def bulk_watermarks(
+        cls, widgets: List[SignatureWidget], stream: bytes
+    ) -> List[bytes]:
         """
-        Constructs signature widgets in page-aligned carrier PDFs.
+        Constructs widgets in page-aligned carrier PDFs.
 
-        Each widget is represented by a `/Sig` annotation with a transparent
-        interior and a dark-gray, one-point solid border. Its normal appearance
-        stream contains only that border. The annotation and appearance are
-        created in the carrier PDF's writer, so they do not retain references
-        to another PDF. ``build_widget_watermarks`` then packages the
-        annotations by source page.
+        Each annotation is constructed by the concrete widget class's
+        ``_build_annotation`` implementation, then ``build_widget_watermarks``
+        packages the annotations by source page.
 
         Args:
-            widgets (List[SignatureWidget]): Signature widgets to construct.
+            widgets (List[SignatureWidget]): Widgets to construct.
             stream (bytes): Source PDF used to determine page count and page size.
 
         Returns:
-            List[bytes]: Page-aligned PDF streams containing the constructed
-            signature annotations.
+            List[bytes]: Page-aligned PDF streams containing the constructed widgets.
         """
-        return SignatureWidget.build_widget_watermarks(
-            widgets, stream, SignatureWidget._build_annotation
-        )
+        return cls.build_widget_watermarks(widgets, stream, cls._build_annotation)
 
 
 @dataclass

{pypdfform-5.5.3 → pypdfform-5.5.4}/PyPDFForm/lib/wrapper.py

@@ -280,7 +280,7 @@ class PdfWrapper:
         return self._available_fonts
 
     @staticmethod
-    @lru_cache(maxsize=128)
+    @lru_cache(maxsize=8)
     def _get_page_streams_with_widgets(stream: bytes) -> tuple[bytes, ...]:
         """
         Extracts page streams while preserving the original page widgets.
@@ -330,8 +330,7 @@ class PdfWrapper:
         """
         Gets the title stored in the PDF's document metadata.
 
-        The title is read lazily from the current PDF stream. Metadata extraction
-        is cached for each distinct stream.
+        The title is read lazily from the current PDF stream.
 
         Returns:
             str | None: The current document title, or None when no title exists.
@@ -472,8 +471,7 @@ class PdfWrapper:
         Gets the JavaScript stored in the PDF's document-open action.
 
         The script is read lazily from the current PDF stream, including an existing
-        JavaScript `/OpenAction` in the input template. Extraction is cached for each
-        distinct stream.
+        JavaScript `/OpenAction` in the input template.
 
         Returns:
             str | None: The current document-open JavaScript, or None when the PDF

{pypdfform-5.5.3 → pypdfform-5.5.4}/PyPDFForm.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyPDFForm
-Version: 5.5.3
+Version: 5.5.4
 Summary: The Python library & CLI for PDF forms.
 Author: Jinge Li
 License-Expression: MIT