Add new core functionality and enhance existing tasks

- Add editpdf_task.py for PDF editing capabilities with text, image, svg, and bottom elements
- Add helpers.py with type definitions and constants for font families, styles, and layers
- Add pagenumbers_task.py for adding page numbers to PDFs
- Add pdftojpg_task.py for PDF to JPEG conversion
- Add validate_pdfa_task.py for PDF/A validation
- Update abstract_task_element.py with enhanced element handling
- Update ilovepdf_api.py with improved API interactions
- Update task.py with new task management features
- Update existing tasks (imagepdf, office_pdf, rotate, sign, watermark) with enhancements
- Update sign module with improved signer and signer_file classes
- Update validators with bool, choice, and string validators

Author: daniel-crombie

ilovepdf/__init__.py

@@ -2,14 +2,17 @@
 
 from . import exceptions
 from .compress_task import CompressTask
+from .editpdf_task import EditPdfTask
 from .extract_task import ExtractTask
 from .file import File
 from .htmltopdf_task import HtmlToPdfTask
 from .ilovepdf_api import Ilovepdf
 from .imagepdf_task import ImagePdfTask
 from .merge_task import MergeTask
 from .office_pdf_task import OfficePdfTask
+from .pagenumbers_task import PageNumbersTask
 from .pdfocr_task import PdfOcrTask
+from .pdftojpg_task import PdfToJpgTask
 from .pdftopdfa_task import PdfToPdfATask
 from .protect_task import ProtectTask
 from .repair_task import RepairTask
@@ -18,6 +21,7 @@
 from .split_task import SplitTask
 from .task import Task
 from .unlock_task import UnlockTask
+from .validate_pdfa_task import ValidatePdfATask
 from .watermark_task import WatermarkTask
 
 __all__ = [
@@ -40,4 +44,8 @@
     "SplitTask",
     "UnlockTask",
     "WatermarkTask",
+    "PdfToJpgTask",
+    "PageNumbersTask",
+    "ValidatePdfATask",
+    "EditPdfTask",
 ]

ilovepdf/abstract_task_element.py

@@ -4,14 +4,14 @@
 for API requests.
 """
 
-from typing import Any, Dict, Sequence
+from collections.abc import Sequence
+from typing import Any
 
 from ilovepdf.exceptions import MissingPayloadFieldError
 
-Payload = Dict[str, Any]
+Payload = dict[str, Any]
 
 
-# pylint: disable=too-few-public-methods
 class AbstractTaskElement:
     """Base class for task elements that can be serialized to an API payload.
 
@@ -51,7 +51,7 @@ def attr1(self, value: str):
 
     def __init__(self) -> None:
         self._payload: Payload = self._get_default_payload()
-        # self._payload: Payload = self._DEFAULT_PAYLOAD.copy()
+
         for key in self._LIST_ATTRS:
             if key in self._payload:
                 self._payload[key] = list(self._payload[key])
@@ -188,7 +188,7 @@ def _serialize_lists(cls, data: Payload) -> Payload:
             if key not in data:
                 continue
             items = data[key]
-            if not isinstance(items, Sequence) or isinstance(items, (str, bytes)):
+            if not isinstance(items, Sequence) or isinstance(items, str | bytes):
                 continue
             serialized = []
             for item in items: