pdfdancer-client-python 0.3.14__py3-none-any.whl → 3.0.0__py3-none-any.whl

pdfdancer/__init__.py

@@ -6,6 +6,7 @@ Provides a clean, Pythonic interface for PDF operations that closely
 mirrors the Java client structure and functionality.
 """
 
+from ._runtime_version import resolve_package_version
 from .exceptions import (
     FontNotFoundException,
     HttpClientException,
@@ -34,7 +35,6 @@ from .models import (
     Orientation,
     PageRef,
     PageSize,
-    Paragraph,
     Path,
     PathGroupInfo,
     PathObjectRef,
@@ -42,32 +42,60 @@ from .models import (
     Point,
     Position,
     PositionMode,
-    RedactResponse,
-    RedactTarget,
-    ReflowPreset,
     ShapeType,
     Size,
     StandardFonts,
-    TextObjectRef,
-    TextStatus,
 )
-from .types import PathGroupObject
 from .page_builder import PageBuilder
-from .paragraph_builder import ParagraphBuilder
-from .path_builder import BezierBuilder, LineBuilder, PathBuilder
-from ._runtime_version import resolve_package_version
-from .text_line_builder import TextLineBuilder
+from .path_builder import BezierBuilder, LineBuilder, PathBuilder, RectangleBuilder
+from .text_editing import (
+    PdfAffineTransform,
+    PdfAffineTransformBuilder,
+    PdfColorRequest,
+    PdfColorSpace,
+    TextDeleteBuilder,
+    TextDeleteRequest,
+    TextEditChangeDiagnostic,
+    TextEditResponse,
+    TextInsertBuilder,
+    TextInsertCaret,
+    TextInsertRequest,
+    TextLayoutMode,
+    TextLayoutProfile,
+    TextLayoutRequest,
+    TextOperationDiagnostic,
+    TextReplaceBuilder,
+    TextReplacementImageRequest,
+    TextReplaceRequest,
+    TextSelectorRequest,
+    TextStyleBuilder,
+    TextStyleNumericFilterRequest,
+    TextStylePatchRequest,
+    TextStyleRequest,
+    TextStyleRunFilterRequest,
+    TextStyleRunsSelectorRequest,
+    TextStyleSelectorRequest,
+    TextStyleSetRequest,
+)
+from .types import (
+    FormFieldObject,
+    FormObject,
+    ImageObject,
+    PathEditSession,
+    PathGroupObject,
+    PathObject,
+    PDFObjectBase,
+)
 
 __version__ = resolve_package_version()
 
 __all__ = [
     "PDFDancer",
-    "ParagraphBuilder",
-    "TextLineBuilder",
     "PageBuilder",
     "PathBuilder",
     "LineBuilder",
     "BezierBuilder",
+    "RectangleBuilder",
     "ObjectRef",
     "PathObjectRef",
     "ModifyPathRequest",
@@ -81,9 +109,7 @@ __all__ = [
     "ImageTransformType",
     "Size",
     "BoundingRect",
-    "Paragraph",
     "FormFieldRef",
-    "TextObjectRef",
     "PageRef",
     "PositionMode",
     "ShapeType",
@@ -91,7 +117,6 @@ __all__ = [
     "StandardFonts",
     "PageSize",
     "Orientation",
-    "TextStatus",
     "FontRecommendation",
     "FontType",
     "PathSegment",
@@ -100,9 +125,12 @@ __all__ = [
     "Path",
     "PathGroupInfo",
     "PathGroupObject",
-    "RedactTarget",
-    "RedactResponse",
-    "ReflowPreset",
+    "PDFObjectBase",
+    "PathObject",
+    "ImageObject",
+    "FormObject",
+    "FormFieldObject",
+    "PathEditSession",
     "PdfDancerException",
     "FontNotFoundException",
     "ValidationException",
@@ -111,10 +139,37 @@ __all__ = [
     "SessionNotFoundException",
     "RateLimitException",
     "set_ssl_verify",
+    "PdfAffineTransform",
+    "PdfAffineTransformBuilder",
+    "PdfColorRequest",
+    "PdfColorSpace",
+    "TextDeleteBuilder",
+    "TextDeleteRequest",
+    "TextEditChangeDiagnostic",
+    "TextEditResponse",
+    "TextInsertBuilder",
+    "TextInsertCaret",
+    "TextInsertRequest",
+    "TextLayoutMode",
+    "TextLayoutProfile",
+    "TextLayoutRequest",
+    "TextOperationDiagnostic",
+    "TextReplaceBuilder",
+    "TextReplaceRequest",
+    "TextReplacementImageRequest",
+    "TextSelectorRequest",
+    "TextStyleBuilder",
+    "TextStyleNumericFilterRequest",
+    "TextStylePatchRequest",
+    "TextStyleRequest",
+    "TextStyleRunFilterRequest",
+    "TextStyleRunsSelectorRequest",
+    "TextStyleSelectorRequest",
+    "TextStyleSetRequest",
 ]
 
-from . import pdfdancer_v1
-from .pdfdancer_v1 import PDFDancer
+from . import pdfdancer_v2
+from .pdfdancer_v2 import PDFDancer
 
 
 def set_ssl_verify(enabled: bool) -> None:
@@ -132,4 +187,4 @@ def set_ssl_verify(enabled: bool) -> None:
         import pdfdancer
         pdfdancer.set_ssl_verify(False)  # Disable SSL verification
     """
-    pdfdancer_v1.DISABLE_SSL_VERIFY = not enabled
+    pdfdancer_v2.DISABLE_SSL_VERIFY = not enabled

pdfdancer/_runtime_version.py

@@ -1,7 +1,9 @@
 from __future__ import annotations
 
-from importlib.metadata import PackageNotFoundError, version as get_package_version
+from importlib.metadata import PackageNotFoundError
+from importlib.metadata import version as get_package_version
 from pathlib import Path
+from typing import Callable, cast
 
 
 def resolve_package_version(default: str = "0.0.0.dev0") -> str:
@@ -13,9 +15,12 @@ def resolve_package_version(default: str = "0.0.0.dev0") -> str:
         pass
 
     try:
-        from setuptools_scm import get_version
+        from setuptools_scm import get_version  # type: ignore[import-not-found]
 
-        return get_version(root=str(Path(__file__).resolve().parents[2]), relative_to=__file__)
+        scm_get_version = cast(Callable[..., str], get_version)
+        return scm_get_version(
+            root=str(Path(__file__).resolve().parents[2]), relative_to=__file__
+        )
     except Exception:
         pass
 

pdfdancer/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.3.14'
-__version_tuple__ = version_tuple = (0, 3, 14)
+__version__ = version = '3.0.0'
+__version_tuple__ = version_tuple = (3, 0, 0)
 
 __commit_id__ = commit_id = None

pdfdancer/image_builder.py

@@ -6,7 +6,7 @@ from typing import TYPE_CHECKING
 from pdfdancer import Image, Position, ValidationException
 
 if TYPE_CHECKING:
-    from .pdfdancer_v1 import PDFDancer
+    from .pdfdancer_v2 import PDFDancer
 
 
 class ImageBuilder:
@@ -25,14 +25,24 @@ class ImageBuilder:
         self._image = Image()
 
     def from_file(self, img_path: Path) -> "ImageBuilder":
+        img_path = Path(img_path)
+        if not img_path.is_file():
+            raise ValidationException(f"Image file not found: {img_path}")
         self._image.data = img_path.read_bytes()
+        if not self._image.data:
+            raise ValidationException("Image file cannot be empty")
+        self._image.format = img_path.suffix.lstrip(".").upper() or None
         return self
 
-    def at(self, page, x, y) -> "ImageBuilder":
+    def at(self, page: int, x: float, y: float) -> "ImageBuilder":
         self._image.position = Position.at_page_coordinates(page, x, y)
         return self
 
     def add(self) -> bool:
+        if self._image.data is None:
+            raise ValidationException("Call from_file() before add()")
+        if self._image.position is None:
+            raise ValidationException("Call at() before add()")
         # noinspection PyProtectedMember
         return self._client._add_image(self._image, self._image.position)
 
@@ -54,13 +64,23 @@ class ImageOnPageBuilder:
         self._page_number = page_number
 
     def from_file(self, img_path: Path) -> "ImageOnPageBuilder":
+        img_path = Path(img_path)
+        if not img_path.is_file():
+            raise ValidationException(f"Image file not found: {img_path}")
         self._image.data = img_path.read_bytes()
+        if not self._image.data:
+            raise ValidationException("Image file cannot be empty")
+        self._image.format = img_path.suffix.lstrip(".").upper() or None
         return self
 
-    def at(self, x, y) -> "ImageOnPageBuilder":
+    def at(self, x: float, y: float) -> "ImageOnPageBuilder":
         self._image.position = Position.at_page_coordinates(self._page_number, x, y)
         return self
 
     def add(self) -> bool:
+        if self._image.data is None:
+            raise ValidationException("Call from_file() before add()")
+        if self._image.position is None:
+            raise ValidationException("Call at() before add()")
         # noinspection PyProtectedMember
         return self._client._add_image(self._image, self._image.position)