PyPDFForm 4.6.0__tar.gz → 4.6.2__tar.gz

{pypdfform-4.6.0 → pypdfform-4.6.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyPDFForm
-Version: 4.6.0
+Version: 4.6.2
 Summary: The Python library for PDF forms.
 Author: Jinge Li
 License-Expression: MIT
@@ -29,9 +29,8 @@ Requires-Dist: reportlab<5.0.0,>=4.4.6
 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<8.0.0,>=7.0.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: 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"
@@ -48,7 +47,7 @@ Dynamic: license-file
 <p align="center">
     <a href="https://pypi.org/project/PyPDFForm/"><img src="https://img.shields.io/pypi/v/pypdfform?label=version&color=magenta"></a>
     <a href="https://chinapandaman.github.io/PyPDFForm/"><img src="https://img.shields.io/github/v/release/chinapandaman/pypdfform?label=docs&color=cyan"></a>
-    <a href="https://codecov.io/gh/chinapandaman/PyPDFForm"><img src="https://img.shields.io/codecov/c/github/chinapandaman/pypdfform"/></a>
+    <a href="https://github.com/chinapandaman/PyPDFForm/actions/workflows/python-package.yml"><img src="https://img.shields.io/badge/coverage-100%25-green"></a>
     <a href="https://github.com/chinapandaman/PyPDFForm/raw/master/LICENSE"><img src="https://img.shields.io/github/license/chinapandaman/pypdfform?label=license&color=orange"></a>
     <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/pypi/pyversions/pypdfform?label=python&color=gold"></a>
     <a href="https://pepy.tech/projects/pypdfform"><img src="https://static.pepy.tech/badge/pypdfform/month"></a>
@@ -103,7 +102,8 @@ The official documentation can be found on [the GitHub page](https://chinapandam
 
 ## Other Resources
 
-[Chicago Python User Group - Dec 14, 2023](https://youtu.be/8t1RdAKwr9w?si=TLgumBNXv9H8szSn)
+* [(WIP) Video Tutorials](https://youtube.com/playlist?list=PLNz_PBu1QA-gzYg5BvyOO98q15u5Xve1L&si=8MWasKEckBzY-NRQ)
+* [Chicago Python User Group - Dec 14, 2023](https://youtu.be/8t1RdAKwr9w?si=TLgumBNXv9H8szSn)
 
 ## Star History
 

{pypdfform-4.6.0 → pypdfform-4.6.2}/PyPDFForm/__init__.py

@@ -20,7 +20,7 @@ The library supports various PDF form features, including:
 PyPDFForm aims to simplify PDF form manipulation, making it accessible to developers of all skill levels.
 """
 
-__version__ = "4.6.0"
+__version__ = "4.6.2"
 
 from .annotations import Annotations
 from .assets.blank import BlankPage

{pypdfform-4.6.0 → pypdfform-4.6.2}/PyPDFForm/annotations/base.py

@@ -11,6 +11,11 @@ Classes:
 
 from dataclasses import dataclass
 
+from pypdf.generic import (ArrayObject, DictionaryObject, FloatObject,
+                           NameObject, TextStringObject)
+
+from ..constants import Annot, Contents, Rect, Subtype, Type
+
 
 @dataclass
 class Annotation:
@@ -41,12 +46,26 @@ class Annotation:
         """
         Gets properties specific to the annotation type.
 
-        This method should be implemented by subclasses to return a dictionary
-        containing PDF properties and their values that are unique to that
-        specific type of annotation. These properties are used when creating
-        the annotation's entry in the PDF document.
+        This method constructs the base dictionary containing PDF properties
+        and their values that are common to all types of annotations.
+        These properties are used when creating the annotation's entry in
+        the PDF document.
 
         Returns:
             dict: A dictionary of PDF properties specific to the annotation type.
         """
-        raise NotImplementedError
+        return DictionaryObject(
+            {
+                NameObject(Type): NameObject(Annot),
+                NameObject(Subtype): NameObject(getattr(self, "_annotation_type")),
+                NameObject(Rect): ArrayObject(
+                    [
+                        FloatObject(self.x),
+                        FloatObject(self.y),
+                        FloatObject(self.x + self.width),
+                        FloatObject(self.y + self.height),
+                    ]
+                ),
+                NameObject(Contents): TextStringObject(self.contents),
+            }
+        )

{pypdfform-4.6.0 → pypdfform-4.6.2}/PyPDFForm/annotations/link.py

@@ -37,15 +37,14 @@ class LinkAnnotation(Annotation):
 
     def get_specific_properties(self) -> dict:
         """
-        Gets properties specific to the link annotation type.
+        Gets properties specific to the link annotation.
 
-        This method returns a dictionary containing PDF properties and their
-        values that are unique to a link annotation, perforated with the URI action.
+        This method extends the base properties with the URI action.
 
         Returns:
             dict: A dictionary of PDF properties specific to the link annotation.
         """
-        result = {}
+        result = super().get_specific_properties()
         if self.uri is not None:
             result[NameObject(A)] = DictionaryObject(
                 {

{pypdfform-4.6.0 → pypdfform-4.6.2}/PyPDFForm/annotations/text.py

@@ -51,13 +51,13 @@ class TextAnnotation(Annotation):
         """
         Gets properties specific to the text annotation.
 
-        This method includes the title (author) and the icon name for the
-        text annotation if they are provided.
+        This method extends the base properties with the title (author)
+        and the icon name for the text annotation if they are provided.
 
         Returns:
             dict: A dictionary of PDF properties specific to the text annotation.
         """
-        result = {}
+        result = super().get_specific_properties()
         if self.title is not None:
             result[NameObject(T)] = TextStringObject(self.title)
         if self.icon is not None:

{pypdfform-4.6.0 → pypdfform-4.6.2}/PyPDFForm/annotations/text_markup.py

@@ -32,26 +32,31 @@ class TextMarkupAnnotation(Annotation):
         """
         Gets properties specific to the text markup annotation.
 
-        This method calculates the `QuadPoints` for the markup based on the
-        annotation's position and dimensions.
+        This method extends the base properties with the `QuadPoints` for
+        the markup based on the annotation's position and dimensions.
 
         Returns:
-            dict: A dictionary containing the `/QuadPoints` property.
+            dict: A dictionary of PDF properties specific to the text markup annotation.
         """
-        return {
-            NameObject("/QuadPoints"): ArrayObject(
-                [
-                    FloatObject(self.x),
-                    FloatObject(self.y),
-                    FloatObject(self.x + self.width),
-                    FloatObject(self.y),
-                    FloatObject(self.x),
-                    FloatObject(self.y + self.height),
-                    FloatObject(self.x + self.width),
-                    FloatObject(self.y + self.height),
-                ]
-            )
-        }
+        result = super().get_specific_properties()
+        result.update(
+            {
+                NameObject("/QuadPoints"): ArrayObject(
+                    [
+                        FloatObject(self.x),
+                        FloatObject(self.y),
+                        FloatObject(self.x + self.width),
+                        FloatObject(self.y),
+                        FloatObject(self.x),
+                        FloatObject(self.y + self.height),
+                        FloatObject(self.x + self.width),
+                        FloatObject(self.y + self.height),
+                    ]
+                ),
+            }
+        )
+
+        return result
 
 
 @dataclass

{pypdfform-4.6.0 → pypdfform-4.6.2}/PyPDFForm/hooks.py

@@ -342,6 +342,74 @@ def flatten_field(annot: DictionaryObject, val: bool) -> None:
     _update_field_flag(annot, READ_ONLY, val)
 
 
+def update_field_x(annot: DictionaryObject, val: float) -> None:
+    """
+    Updates the X-coordinate (horizontal position) of a form field annotation.
+
+    This function modifies the 'Rect' entry of the annotation dictionary to change
+    the starting X-coordinate of the field and adjusts the ending X-coordinate
+    accordingly to maintain the field's width.
+
+    Args:
+        annot (DictionaryObject): The annotation dictionary for the form field.
+        val (float): The new X-coordinate for the left edge of the field.
+    """
+    if isinstance(val, float):
+        diff = val - annot[Rect][0]
+        annot[NameObject(Rect)][0] = FloatObject(val)
+        annot[NameObject(Rect)][2] = FloatObject(annot[NameObject(Rect)][2] + diff)
+
+
+def update_field_y(annot: DictionaryObject, val: float) -> None:
+    """
+    Updates the Y-coordinate (vertical position) of a form field annotation.
+
+    This function modifies the 'Rect' entry of the annotation dictionary to change
+    the starting Y-coordinate of the field and adjusts the ending Y-coordinate
+    accordingly to maintain the field's height.
+
+    Args:
+        annot (DictionaryObject): The annotation dictionary for the form field.
+        val (float): The new Y-coordinate for the bottom edge of the field.
+    """
+    if isinstance(val, float):
+        diff = val - annot[Rect][1]
+        annot[NameObject(Rect)][1] = FloatObject(val)
+        annot[NameObject(Rect)][3] = FloatObject(annot[NameObject(Rect)][3] + diff)
+
+
+def update_field_width(annot: DictionaryObject, val: float) -> None:
+    """
+    Updates the width of a form field annotation.
+
+    This function modifies the 'Rect' entry of the annotation dictionary to set
+    the new width of the field, adjusting the rightmost coordinate while keeping
+    the leftmost coordinate fixed.
+
+    Args:
+        annot (DictionaryObject): The annotation dictionary for the form field.
+        val (float): The new width of the field.
+    """
+    if isinstance(val, float):
+        annot[NameObject(Rect)][2] = FloatObject(annot[Rect][0] + val)
+
+
+def update_field_height(annot: DictionaryObject, val: float) -> None:
+    """
+    Updates the height of a form field annotation.
+
+    This function modifies the 'Rect' entry of the annotation dictionary to set
+    the new height of the field, adjusting the topmost coordinate while keeping
+    the bottommost coordinate fixed.
+
+    Args:
+        annot (DictionaryObject): The annotation dictionary for the form field.
+        val (float): The new height of the field.
+    """
+    if isinstance(val, float):
+        annot[NameObject(Rect)][3] = FloatObject(annot[Rect][1] + val)
+
+
 def update_field_tooltip(annot: DictionaryObject, val: str) -> None:
     """
     Updates the tooltip (alternate field name) of a form field annotation.

{pypdfform-4.6.0 → pypdfform-4.6.2}/PyPDFForm/middleware/base.py

@@ -22,6 +22,10 @@ class Widget:
     """
 
     SET_ATTR_TRIGGER_HOOK_MAP = {
+        "x": "update_field_x",
+        "y": "update_field_y",
+        "width": "update_field_width",
+        "height": "update_field_height",
         "readonly": "flatten_field",
         "required": "update_field_required",
         "hidden": "update_field_hidden",
@@ -47,8 +51,11 @@ class Widget:
             value (Any): The initial value of the widget. Defaults to None.
         """
         super().__init__()
+        self.attr_set_tracker = {}
+
         self._name = name
         self._value = value
+
         self.tooltip: Optional[str] = None
         self.readonly: Optional[bool] = None
         self.required: Optional[bool] = None
@@ -74,7 +81,8 @@ class Widget:
         Set an attribute on the widget.
 
         This method overrides the default __setattr__ method to
-        trigger hooks when certain attributes are set.
+        trigger hooks when certain attributes are set. It also
+        tracks the attributes that have been set.
 
         Args:
             name (str): The name of the attribute.
@@ -82,6 +90,14 @@ class Widget:
         """
         if name in self.SET_ATTR_TRIGGER_HOOK_MAP and value is not None:
             self.hooks_to_trigger.append((self.SET_ATTR_TRIGGER_HOOK_MAP[name], value))
+
+        if (
+            hasattr(self, "attr_set_tracker")
+            and name in self.__dict__
+            and value is not None
+        ):
+            self.attr_set_tracker[name] = value
+
         super().__setattr__(name, value)
 
     @property

{pypdfform-4.6.0 → pypdfform-4.6.2}/PyPDFForm/template.py

@@ -13,12 +13,11 @@ from io import BytesIO
 from typing import Dict, List, cast
 
 from pypdf import PdfReader, PdfWriter
-from pypdf.generic import (ArrayObject, DictionaryObject, FloatObject,
-                           NameObject, TextStringObject)
+from pypdf.generic import ArrayObject, DictionaryObject, NameObject
 
 from .annotations import AnnotationTypes
 from .constants import (COMB, MULTILINE, READ_ONLY, REQUIRED, WIDGET_TYPES,
-                        Annot, Annots, Contents, Rect, Subtype, Type)
+                        Annots)
 from .middleware.checkbox import Checkbox
 from .middleware.dropdown import Dropdown
 from .middleware.radio import Radio
@@ -149,7 +148,12 @@ def _populate_common_properties(widget: dict, _widget: WIDGET_TYPES) -> None:
     _widget.__dict__["required"] = check_field_flag(widget, REQUIRED)
     _widget.__dict__["hidden"] = get_field_hidden(widget)
 
-    _widget.x, _widget.y, _widget.width, _widget.height = get_field_rect(widget)
+    (
+        _widget.__dict__["x"],
+        _widget.__dict__["y"],
+        _widget.__dict__["width"],
+        _widget.__dict__["height"],
+    ) = get_field_rect(widget)
 
 
 def _populate_text_properties(widget: dict, _widget: Text) -> None:
@@ -196,10 +200,10 @@ def _handle_radio_widget(
     field_rect = get_field_rect(widget)
 
     if key not in results:
-        _widget.x = []
-        _widget.y = []
-        _widget.width = []
-        _widget.height = []
+        _widget.__dict__["x"] = []
+        _widget.__dict__["y"] = []
+        _widget.__dict__["width"] = []
+        _widget.__dict__["height"] = []
         results[key] = _widget
 
     radio = cast(Radio, results[key])
@@ -211,9 +215,9 @@ def _handle_radio_widget(
     if isinstance(radio.y, list):
         radio.y.append(field_rect[1])
     if isinstance(radio.width, list):
-        radio.width.append(field_rect[2])
+        radio.__dict__["width"].append(field_rect[2])
     if isinstance(radio.height, list):
-        radio.height.append(field_rect[3])
+        radio.__dict__["height"].append(field_rect[3])
 
     if get_radio_value(widget):
         radio.value = radio.number_of_options - 1
@@ -333,35 +337,6 @@ def _group_annotations_by_page(
     return result
 
 
-def _create_annotation_object(annotation: AnnotationTypes) -> DictionaryObject:
-    """
-    Creates a PDF dictionary object for an annotation.
-
-    Args:
-        annotation (AnnotationTypes): The annotation object to convert.
-
-    Returns:
-        DictionaryObject: The PDF dictionary object representing the annotation.
-    """
-    annot = DictionaryObject(
-        {
-            NameObject(Type): NameObject(Annot),
-            NameObject(Subtype): NameObject(getattr(annotation, "_annotation_type")),
-            NameObject(Rect): ArrayObject(
-                [
-                    FloatObject(annotation.x),
-                    FloatObject(annotation.y),
-                    FloatObject(annotation.x + annotation.width),
-                    FloatObject(annotation.y + annotation.height),
-                ]
-            ),
-            NameObject(Contents): TextStringObject(annotation.contents),
-        }
-    )
-    annot.update(**annotation.get_specific_properties())
-    return annot
-
-
 def create_annotations(
     template: bytes,
     annotations: List[AnnotationTypes],
@@ -393,7 +368,7 @@ def create_annotations(
 
         page_annotations = ArrayObject([])
         for annotation in annotations_by_page[page_num]:
-            page_annotations.append(_create_annotation_object(annotation))
+            page_annotations.append(annotation.get_specific_properties())
 
         if Annots in page:
             page[NameObject(Annots)] += page_annotations

{pypdfform-4.6.0 → pypdfform-4.6.2}/PyPDFForm/utils.py

@@ -183,7 +183,6 @@ def merge_two_pdfs(pdf: bytes, other: bytes) -> bytes:
     output = PdfWriter()
     output.append(merged_no_widgets)
 
-    # TODO: refactor duplicate logic with copy_watermark_widgets
     widgets_to_copy = {}
     for i, page in enumerate(pdf_file.pages):
         widgets_to_copy[i] = []

{pypdfform-4.6.0 → pypdfform-4.6.2}/PyPDFForm/wrapper.py

@@ -199,11 +199,9 @@ class PdfWrapper:
         # update key preserve old key attrs
         for k, v in new_widgets.items():
             if k in self._key_update_tracker:
-                for name, value in self.widgets[
-                    self._key_update_tracker[k]
-                ].__dict__.items():
-                    if not name.startswith("_"):
-                        setattr(v, name, value)
+                old_widget = self.widgets[self._key_update_tracker[k]]
+                for name in old_widget.attr_set_tracker:
+                    setattr(v, name, getattr(old_widget, name, None))
         self._key_update_tracker = {}
 
         self.widgets = new_widgets

{pypdfform-4.6.0 → pypdfform-4.6.2}/PyPDFForm.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyPDFForm
-Version: 4.6.0
+Version: 4.6.2
 Summary: The Python library for PDF forms.
 Author: Jinge Li
 License-Expression: MIT
@@ -29,9 +29,8 @@ Requires-Dist: reportlab<5.0.0,>=4.4.6
 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<8.0.0,>=7.0.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: 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"
@@ -48,7 +47,7 @@ Dynamic: license-file
 <p align="center">
     <a href="https://pypi.org/project/PyPDFForm/"><img src="https://img.shields.io/pypi/v/pypdfform?label=version&color=magenta"></a>
     <a href="https://chinapandaman.github.io/PyPDFForm/"><img src="https://img.shields.io/github/v/release/chinapandaman/pypdfform?label=docs&color=cyan"></a>
-    <a href="https://codecov.io/gh/chinapandaman/PyPDFForm"><img src="https://img.shields.io/codecov/c/github/chinapandaman/pypdfform"/></a>
+    <a href="https://github.com/chinapandaman/PyPDFForm/actions/workflows/python-package.yml"><img src="https://img.shields.io/badge/coverage-100%25-green"></a>
     <a href="https://github.com/chinapandaman/PyPDFForm/raw/master/LICENSE"><img src="https://img.shields.io/github/license/chinapandaman/pypdfform?label=license&color=orange"></a>
     <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/pypi/pyversions/pypdfform?label=python&color=gold"></a>
     <a href="https://pepy.tech/projects/pypdfform"><img src="https://static.pepy.tech/badge/pypdfform/month"></a>
@@ -103,7 +102,8 @@ The official documentation can be found on [the GitHub page](https://chinapandam
 
 ## Other Resources
 
-[Chicago Python User Group - Dec 14, 2023](https://youtu.be/8t1RdAKwr9w?si=TLgumBNXv9H8szSn)
+* [(WIP) Video Tutorials](https://youtube.com/playlist?list=PLNz_PBu1QA-gzYg5BvyOO98q15u5Xve1L&si=8MWasKEckBzY-NRQ)
+* [Chicago Python User Group - Dec 14, 2023](https://youtu.be/8t1RdAKwr9w?si=TLgumBNXv9H8szSn)
 
 ## Star History
 

{pypdfform-4.6.0 → pypdfform-4.6.2}/PyPDFForm.egg-info/requires.txt

@@ -8,9 +8,8 @@ reportlab<5.0.0,>=4.4.6
 [dev]
 black<27.0.0,>=25.11.0
 coverage<8.0.0,>=7.12.0
-isort<8.0.0,>=7.0.0
+isort<9.0.0,>=7.0.0
 jsonschema<5.0.0,>=4.25.1
-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

{pypdfform-4.6.0 → pypdfform-4.6.2}/README.md

@@ -5,7 +5,7 @@
 <p align="center">
     <a href="https://pypi.org/project/PyPDFForm/"><img src="https://img.shields.io/pypi/v/pypdfform?label=version&color=magenta"></a>
     <a href="https://chinapandaman.github.io/PyPDFForm/"><img src="https://img.shields.io/github/v/release/chinapandaman/pypdfform?label=docs&color=cyan"></a>
-    <a href="https://codecov.io/gh/chinapandaman/PyPDFForm"><img src="https://img.shields.io/codecov/c/github/chinapandaman/pypdfform"/></a>
+    <a href="https://github.com/chinapandaman/PyPDFForm/actions/workflows/python-package.yml"><img src="https://img.shields.io/badge/coverage-100%25-green"></a>
     <a href="https://github.com/chinapandaman/PyPDFForm/raw/master/LICENSE"><img src="https://img.shields.io/github/license/chinapandaman/pypdfform?label=license&color=orange"></a>
     <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/pypi/pyversions/pypdfform?label=python&color=gold"></a>
     <a href="https://pepy.tech/projects/pypdfform"><img src="https://static.pepy.tech/badge/pypdfform/month"></a>
@@ -60,7 +60,8 @@ The official documentation can be found on [the GitHub page](https://chinapandam
 
 ## Other Resources
 
-[Chicago Python User Group - Dec 14, 2023](https://youtu.be/8t1RdAKwr9w?si=TLgumBNXv9H8szSn)
+* [(WIP) Video Tutorials](https://youtube.com/playlist?list=PLNz_PBu1QA-gzYg5BvyOO98q15u5Xve1L&si=8MWasKEckBzY-NRQ)
+* [Chicago Python User Group - Dec 14, 2023](https://youtu.be/8t1RdAKwr9w?si=TLgumBNXv9H8szSn)
 
 ## Star History
 

{pypdfform-4.6.0 → pypdfform-4.6.2}/pyproject.toml

@@ -43,9 +43,8 @@ Documentation = "https://chinapandaman.github.io/PyPDFForm/"
 dev = [
     "black>=25.11.0,<27.0.0",
     "coverage>=7.12.0,<8.0.0",
-    "isort>=7.0.0,<8.0.0",
+    "isort>=7.0.0,<9.0.0",
     "jsonschema>=4.25.1,<5.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",

{pypdfform-4.6.0 → pypdfform-4.6.2}/tests/test_functional.py

@@ -7,7 +7,6 @@ import pytest
 from jsonschema import ValidationError, validate
 
 from PyPDFForm import Annotations, BlankPage, Fields, PdfArray, PdfWrapper
-from PyPDFForm.annotations.base import Annotation
 from PyPDFForm.constants import DA, UNIQUE_SUFFIX_LENGTH, T, V
 from PyPDFForm.deprecation import deprecation_notice
 from PyPDFForm.middleware.base import Widget
@@ -789,17 +788,6 @@ def test_merge(template_stream):
                 assert field[V] == f"test_3_{int(page / 3 - 0.5)}"
 
 
-def test_base_annotation_get_specific_properties_not_implemented():
-    annotation = Annotation(1, 100, 100)
-    try:
-        annotation.get_specific_properties()
-        pytest.fail(
-            reason="base annotation shouldn't have get_specific_properties implemented."
-        )
-    except NotImplementedError:
-        pass
-
-
 def test_annotate(template_stream, pdf_samples, request):
     expected_path = os.path.join(pdf_samples, "test_annotate.pdf")
     with open(expected_path, "rb+") as f: