pdfdancer-client-python 0.2.2__tar.gz → 0.2.4__tar.gz

{pdfdancer_client_python-0.2.2 → pdfdancer_client_python-0.2.4}/.gitignore

@@ -6,3 +6,4 @@ dist/
 src/pdfdancer_python.egg-info
 .aider*
 src/pdfdancer_client_python.egg-info
+/logs/

{pdfdancer_client_python-0.2.2 → pdfdancer_client_python-0.2.4}/CLAUDE.md

@@ -46,7 +46,7 @@ client._delete(paragraphs[0])
 client._move(images[0], new_position)
 
 # Builder pattern (mirrors Java ParagraphBuilder)
-paragraph = (client.paragraph_builder()
+paragraph = (client._paragraph_builder()
              .from_string("Text content")
              .with_font(Font("Arial", 12))
              .with_position(Position.at_page_coordinates(0, 100, 200))

{pdfdancer_client_python-0.2.2/src/pdfdancer_client_python.egg-info → pdfdancer_client_python-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pdfdancer-client-python
-Version: 0.2.2
+Version: 0.2.4
 Summary: Python client for PDFDancer API
 Author-email: "The Famous Cat Ltd." <hi@thefamouscat.com>
 License: MIT
@@ -63,7 +63,7 @@ client._delete(paragraphs[0])
 client._move(images[0], Position.at_page_coordinates(0, 100, 200))
 
 # Builder pattern (mirrors Java ParagraphBuilder)
-paragraph = (client.paragraph_builder()
+paragraph = (client._paragraph_builder()
              .from_string("Hello World")
              .with_font(Font("Arial", 12))
              .with_color(Color(255, 0, 0))
@@ -141,25 +141,26 @@ result = client.modify_text_line(ref, "new text")
 ```
 
 ### Builder Pattern
+
 ```python
 # Java: client.paragraphBuilder()
-builder = client.paragraph_builder()
+builder = client._paragraph_builder()
 
 # Fluent interface (mirrors Java ParagraphBuilder)
 paragraph = (builder
-    .from_string("Text content")           # Java: fromString()
-    .with_font(Font("Arial", 12))          # Java: withFont()
-    .with_color(Color(255, 0, 0))          # Java: withColor()
-    .with_line_spacing(1.5)                # Java: withLineSpacing()
-    .with_position(position)               # Java: withPosition()
-    .build())                              # Java: build()
+             .from_string("Text content")  # Java: fromString()
+             .with_font(Font("Arial", 12))  # Java: withFont()
+             .with_color(Color(255, 0, 0))  # Java: withColor()
+             .with_line_spacing(1.5)  # Java: withLineSpacing()
+             .with_position(position)  # Java: withPosition()
+             .build())  # Java: build()
 
 # Font file registration (Java: withFont(File, double))
 paragraph = (builder
-    .with_font_file("custom.ttf", 14.0)    # Java: withFont(File, double)
-    .from_string("Custom font text")
-    .with_position(position)
-    .build())
+             .with_font_file("custom.ttf", 14.0)  # Java: withFont(File, double)
+             .from_string("Custom font text")
+             .with_position(position)
+             .build())
 ```
 
 ### Position API

{pdfdancer_client_python-0.2.2 → pdfdancer_client_python-0.2.4}/README.md

@@ -37,7 +37,7 @@ client._delete(paragraphs[0])
 client._move(images[0], Position.at_page_coordinates(0, 100, 200))
 
 # Builder pattern (mirrors Java ParagraphBuilder)
-paragraph = (client.paragraph_builder()
+paragraph = (client._paragraph_builder()
              .from_string("Hello World")
              .with_font(Font("Arial", 12))
              .with_color(Color(255, 0, 0))
@@ -115,25 +115,26 @@ result = client.modify_text_line(ref, "new text")
 ```
 
 ### Builder Pattern
+
 ```python
 # Java: client.paragraphBuilder()
-builder = client.paragraph_builder()
+builder = client._paragraph_builder()
 
 # Fluent interface (mirrors Java ParagraphBuilder)
 paragraph = (builder
-    .from_string("Text content")           # Java: fromString()
-    .with_font(Font("Arial", 12))          # Java: withFont()
-    .with_color(Color(255, 0, 0))          # Java: withColor()
-    .with_line_spacing(1.5)                # Java: withLineSpacing()
-    .with_position(position)               # Java: withPosition()
-    .build())                              # Java: build()
+             .from_string("Text content")  # Java: fromString()
+             .with_font(Font("Arial", 12))  # Java: withFont()
+             .with_color(Color(255, 0, 0))  # Java: withColor()
+             .with_line_spacing(1.5)  # Java: withLineSpacing()
+             .with_position(position)  # Java: withPosition()
+             .build())  # Java: build()
 
 # Font file registration (Java: withFont(File, double))
 paragraph = (builder
-    .with_font_file("custom.ttf", 14.0)    # Java: withFont(File, double)
-    .from_string("Custom font text")
-    .with_position(position)
-    .build())
+             .with_font_file("custom.ttf", 14.0)  # Java: withFont(File, double)
+             .from_string("Custom font text")
+             .with_position(position)
+             .build())
 ```
 
 ### Position API

{pdfdancer_client_python-0.2.2 → pdfdancer_client_python-0.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pdfdancer-client-python"
-version = "0.2.2"
+version = "0.2.4"
 description = "Python client for PDFDancer API"
 readme = "README.md"
 authors = [

{pdfdancer_client_python-0.2.2 → pdfdancer_client_python-0.2.4}/src/pdfdancer/pdfdancer_v1.py

@@ -6,6 +6,7 @@ Provides session-based PDF manipulation operations with strict validation.
 """
 
 import json
+import os
 from pathlib import Path
 from typing import List, Optional, Union, BinaryIO
 
@@ -116,11 +117,39 @@ class PDFDancer:
     @classmethod
     def open(cls,
              pdf_data: Union[bytes, Path, str, BinaryIO],
-             token: str,
-             base_url: str = "http://localhost:8080",
+             token: Optional[str] = None,
+             base_url: Optional[str] = None,
              timeout: float = 30.0) -> "PDFDancer":
+        """
+        Create a client session, falling back to environment variables when needed.
+
+        Args:
+            pdf_data: PDF payload supplied directly or via filesystem handles.
+            token: Override for the API token; falls back to `PDFDANCER_TOKEN` environement variable.
+            base_url: Override for the API base URL; falls back to `PDFDANCER_BASE_URL`
+                or defaults to `https://api.pdfdancer.com`.
+            timeout: HTTP read timeout in seconds.
+
+        Returns:
+            A ready-to-use `PDFDancer` client instance.
+        """
+        resolved_token = token.strip() if token and token.strip() else None
+        if resolved_token is None:
+            env_token = os.getenv("PDFDANCER_TOKEN")
+            resolved_token = env_token.strip() if env_token and env_token.strip() else None
+
+        if resolved_token is None:
+            raise ValidationException(
+                "Missing PDFDancer API token. Pass a token via the `token` argument "
+                "or set the PDFDANCER_TOKEN environment variable."
+            )
+
+        env_base_url = os.getenv("PDFDANCER_BASE_URL")
+        resolved_base_url = base_url or (env_base_url.strip() if env_base_url and env_base_url.strip() else None)
+        if resolved_base_url is None:
+            resolved_base_url = "https://api.pdfdancer.com"
 
-        return PDFDancer(token, pdf_data, base_url, timeout)
+        return PDFDancer(resolved_token, pdf_data, resolved_base_url, timeout)
 
     def __init__(self, token: str, pdf_data: Union[bytes, Path, str, BinaryIO],
                  base_url: str, read_timeout: float = 0):
@@ -236,6 +265,22 @@ class PDFDancer:
             # If JSON parsing fails, return response content or status
             return response.text or f"HTTP {response.status_code}"
 
+    def _handle_authentication_error(self, response: Optional[requests.Response]) -> None:
+        """
+        Translate authentication failures into a clear, actionable validation error.
+        """
+        if response is None:
+            return
+
+        if response.status_code in (401, 403):
+            details = self._extract_error_message(response)
+            raise ValidationException(
+                "Authentication with the PDFDancer API failed. "
+                "Confirm that your API token is valid, has not expired, and is supplied via "
+                "the `token` argument or the PDFDANCER_TOKEN environment variable. "
+                f"Server response: {details}"
+            )
+
     def _create_session(self) -> str:
         """
         Creates a new PDF processing session by uploading the PDF data.
@@ -251,6 +296,7 @@ class PDFDancer:
                 timeout=self._read_timeout if self._read_timeout > 0 else None
             )
 
+            self._handle_authentication_error(response)
             response.raise_for_status()
             session_id = response.text.strip()
 
@@ -260,6 +306,7 @@ class PDFDancer:
             return session_id
 
         except requests.exceptions.RequestException as e:
+            self._handle_authentication_error(getattr(e, 'response', None))
             error_message = self._extract_error_message(getattr(e, 'response', None))
             raise HttpClientException(f"Failed to create session: {error_message}",
                                       response=getattr(e, 'response', None), cause=e) from None
@@ -293,10 +340,12 @@ class PDFDancer:
                 except (json.JSONDecodeError, KeyError):
                     pass
 
+            self._handle_authentication_error(response)
             response.raise_for_status()
             return response
 
         except requests.exceptions.RequestException as e:
+            self._handle_authentication_error(getattr(e, 'response', None))
             error_message = self._extract_error_message(getattr(e, 'response', None))
             raise HttpClientException(f"API request failed: {error_message}", response=getattr(e, 'response', None),
                                       cause=e) from None
@@ -811,7 +860,7 @@ class PDFDancer:
 
     # Builder Pattern Support
 
-    def paragraph_builder(self) -> 'ParagraphBuilder':
+    def _paragraph_builder(self) -> 'ParagraphBuilder':
         """
         Creates a new ParagraphBuilder for fluent paragraph construction.
         Returns:

{pdfdancer_client_python-0.2.2 → pdfdancer_client_python-0.2.4/src/pdfdancer_client_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pdfdancer-client-python
-Version: 0.2.2
+Version: 0.2.4
 Summary: Python client for PDFDancer API
 Author-email: "The Famous Cat Ltd." <hi@thefamouscat.com>
 License: MIT
@@ -63,7 +63,7 @@ client._delete(paragraphs[0])
 client._move(images[0], Position.at_page_coordinates(0, 100, 200))
 
 # Builder pattern (mirrors Java ParagraphBuilder)
-paragraph = (client.paragraph_builder()
+paragraph = (client._paragraph_builder()
              .from_string("Hello World")
              .with_font(Font("Arial", 12))
              .with_color(Color(255, 0, 0))
@@ -141,25 +141,26 @@ result = client.modify_text_line(ref, "new text")
 ```
 
 ### Builder Pattern
+
 ```python
 # Java: client.paragraphBuilder()
-builder = client.paragraph_builder()
+builder = client._paragraph_builder()
 
 # Fluent interface (mirrors Java ParagraphBuilder)
 paragraph = (builder
-    .from_string("Text content")           # Java: fromString()
-    .with_font(Font("Arial", 12))          # Java: withFont()
-    .with_color(Color(255, 0, 0))          # Java: withColor()
-    .with_line_spacing(1.5)                # Java: withLineSpacing()
-    .with_position(position)               # Java: withPosition()
-    .build())                              # Java: build()
+             .from_string("Text content")  # Java: fromString()
+             .with_font(Font("Arial", 12))  # Java: withFont()
+             .with_color(Color(255, 0, 0))  # Java: withColor()
+             .with_line_spacing(1.5)  # Java: withLineSpacing()
+             .with_position(position)  # Java: withPosition()
+             .build())  # Java: build()
 
 # Font file registration (Java: withFont(File, double))
 paragraph = (builder
-    .with_font_file("custom.ttf", 14.0)    # Java: withFont(File, double)
-    .from_string("Custom font text")
-    .with_position(position)
-    .build())
+             .with_font_file("custom.ttf", 14.0)  # Java: withFont(File, double)
+             .from_string("Custom font text")
+             .with_position(position)
+             .build())
 ```
 
 ### Position API

{pdfdancer_client_python-0.2.2 → pdfdancer_client_python-0.2.4}/src/pdfdancer_client_python.egg-info/SOURCES.txt

@@ -5,7 +5,6 @@ pyproject.toml
 release.py
 requirements-dev.txt
 requirements.txt
-test.py
 .github/workflows/ci.yml
 docs/openapi.yml
 src/pdfdancer/__init__.py
@@ -21,6 +20,7 @@ src/pdfdancer_client_python.egg-info/dependency_links.txt
 src/pdfdancer_client_python.egg-info/requires.txt
 src/pdfdancer_client_python.egg-info/top_level.txt
 tests/__init__.py
+tests/test_authentication.py
 tests/test_models.py
 tests/test_openapi_compliance.py
 tests/e2e/__init__.py

pdfdancer_client_python-0.2.4/tests/test_authentication.py

@@ -0,0 +1,36 @@
+import requests
+import pytest
+
+from pdfdancer import ValidationException
+from pdfdancer.pdfdancer_v1 import PDFDancer
+
+
+def test_open_without_token_reports_actionable_message():
+    with pytest.raises(ValidationException) as exc_info:
+        PDFDancer.open(pdf_data=b"%PDF", token="")
+
+    message = str(exc_info.value)
+    assert "Missing PDFDancer API token" in message
+    assert "PDFDANCER_TOKEN" in message
+
+
+def test_create_session_unauthorized_reports_guidance(monkeypatch):
+    class FakeResponse:
+        status_code = 401
+        text = "Unauthorized"
+
+        def json(self):
+            return {"message": "Unauthorized"}
+
+    def fake_post(self, *args, **kwargs):
+        return FakeResponse()
+
+    monkeypatch.setattr(requests.Session, "post", fake_post)
+
+    with pytest.raises(ValidationException) as exc_info:
+        PDFDancer(token="bad-token", pdf_data=b"%PDF", base_url="https://api.example.com")
+
+    message = str(exc_info.value)
+    assert "Authentication with the PDFDancer API failed" in message
+    assert "Server response: Unauthorized" in message
+    assert "PDFDANCER_TOKEN" in message

pdfdancer_client_python-0.2.2/test.py

@@ -1,455 +0,0 @@
-"""
-Comprehensive test showcasing all PDFDancer Python API features.
-This file demonstrates the complete functionality of the pdfdancer library.
-"""
-
-from pathlib import Path
-
-from pdfdancer import (
-    ClientV1, Font, Position, Color, Image, Paragraph, ObjectType,
-    Point, BoundingRect, PositionMode, ShapeType,
-    FontNotFoundException
-)
-
-
-# noinspection PyUnusedLocal
-def find_operations(client):
-    """Test all find operations for different object types."""
-    # Find all paragraphs
-    paragraphs = client._find_paragraphs()
-
-    # Find images
-    images = client._find_images()
-
-    # Find forms
-    forms = client._find_form_x_objects()
-
-    # Find paths
-    paths = client._find_paths()
-
-    # Find text lines
-    text_lines = client._find_text_lines()
-
-    # Find with specific object type and position
-    specific_position = Position.at_page_coordinates(0, 100, 100)
-    paragraphs_at_pos = client._find(ObjectType.PARAGRAPH, specific_position)
-
-    return paragraphs, text_lines  # Keep only what's needed for object_manipulation
-
-
-# noinspection PyUnusedLocal
-def page_management(client):
-    """Test page management operations."""
-    # Get all pages
-    pages = client.get_pages()
-
-    # Get specific page
-    first_page = None
-    if pages:
-        first_page = client._get_page(0)
-
-
-# noinspection PyUnusedLocal
-def position_system(client):
-    """Test position and coordinate system operations."""
-    # Different ways to create positions
-    page_pos = Position.at_page(0)
-    coord_pos = Position.at_page_coordinates(0, 50, 100)
-
-    # Position manipulation
-    moved_pos = coord_pos.copy()
-    moved_pos.move_x(25.0)
-    moved_pos.move_y(15.0)
-
-    # Point and BoundingRect
-    point = Point(10.0, 20.0)
-    bounding_rect = BoundingRect(0.0, 0.0, 100.0, 50.0)
-
-
-# noinspection PyUnusedLocal
-def font_management(client):
-    """Test font creation and management operations."""
-    # Create fonts
-    arial_font = Font("Arial", 12.0)
-    times_font = Font("Times New Roman", 14.0)
-
-    # Find fonts in document
-    found_fonts = None
-    try:
-        found_fonts = client.find_fonts("Arial", 12)
-    except FontNotFoundException as e:
-        pass
-    except Exception as e:
-        pass
-
-
-# noinspection PyUnusedLocal
-def color_system(client):
-    """Test color creation and management operations."""
-    # Create colors
-    red_color = Color(255, 0, 0)
-    blue_color = Color(0, 0, 255, 128)  # With alpha
-
-
-# noinspection PyUnusedLocal
-def paragraph_operations(client):
-    """Test paragraph builder and manipulation operations."""
-    arial_font = Font("Arial", 12.0)
-    arial_font_large = Font("Arial", 14.0)  # Use Arial instead of Times New Roman
-    red_color = Color(255, 0, 0)
-    blue_color = Color(0, 0, 255, 128)
-
-    # Basic paragraph creation
-    basic_paragraph = (client.paragraph_builder()
-                       .from_string("Basic paragraph with default settings")
-                       .with_font(arial_font)
-                       .with_position(Position.at_page_coordinates(0, 50, 200))
-                       .build())
-    client._add_paragraph(basic_paragraph)
-
-    # Advanced paragraph with all features
-    advanced_paragraph = (client.paragraph_builder()
-                          .from_string("Advanced paragraph\nwith multiple lines\nand styling", red_color)
-                          .with_font(arial_font_large)
-                          .with_line_spacing(1.5)
-                          .with_color(blue_color)
-                          .with_position(Position.at_page_coordinates(0, 50, 250))
-                          .build())
-    client._add_paragraph(advanced_paragraph)
-
-
-# noinspection PyUnusedLocal
-def object_manipulation(client, paragraphs, text_lines):
-    """Test object manipulation operations including delete, move, and modify."""
-    arial_font = Font("Arial", 14.0)  # Use Arial instead of Times New Roman
-    red_color = Color(255, 0, 0)
-
-    if paragraphs:
-        # Delete operation
-        first_paragraph = paragraphs[0]
-        client._delete(first_paragraph)
-
-        # Move operation (if we have more paragraphs)
-        if len(paragraphs) > 1:
-            second_paragraph = paragraphs[1]
-            new_position = Position.at_page_coordinates(0, 100, 300)
-            client._move(second_paragraph, new_position)
-
-        # Modify operations
-        if len(paragraphs) > 2:
-            third_paragraph = paragraphs[2]
-
-            # Modify with new paragraph object
-            modified_paragraph = Paragraph(
-                position=Position.at_page_coordinates(0, 50, 350),
-                text_lines=["Modified paragraph text"],
-                font=arial_font,
-                color=red_color
-            )
-            client._modify_paragraph(third_paragraph, modified_paragraph)
-
-            # Modify with just text
-            if len(paragraphs) > 3:
-                fourth_paragraph = paragraphs[3]
-                client._modify_paragraph(fourth_paragraph, "Simple text modification")
-
-    # Text line modification
-    if text_lines:
-        client.modify_text_line(text_lines[0], "Modified text line")
-
-
-# noinspection PyUnusedLocal
-def text_line_operations(client):
-    """Test text line specific operations and showcases."""
-    # Find all text lines in document
-    all_text_lines = client._find_text_lines()
-
-    # Find text lines at specific position
-    specific_position = Position.at_page_coordinates(0, 100, 100)
-    text_lines_at_position = client._find_text_lines(specific_position)
-
-    # Find text lines on entire page
-    page_position = Position.at_page(0)
-    text_lines_on_page = client._find_text_lines(page_position)
-
-    # Demonstrate text line modification if text lines are found
-    modified_text_line = None
-    if all_text_lines:
-        first_text_line = all_text_lines[0]
-
-        # Get text line properties via ObjectRef
-        text_line_id = first_text_line.get_internal_id()
-        text_line_type = first_text_line.get_type()
-        text_line_position = first_text_line.get_position()
-
-        # Modify text line content
-        client.modify_text_line(first_text_line, "Modified text line content")
-        modified_text_line = first_text_line
-
-        # Demonstrate position modification for text lines
-        if len(all_text_lines) > 1:
-            second_text_line = all_text_lines[1]
-            new_position = Position.at_page_coordinates(0, 120, 150)
-            client._move(second_text_line, new_position)
-
-
-# noinspection PyUnusedLocal
-def form_operations(client):
-    """Test form handling operations."""
-    # Find all forms in document
-    all_forms = client._find_form_x_objects()
-
-    # Find forms at specific position
-    specific_position = Position.at_page_coordinates(0, 150, 200)
-    forms_at_position = client._find_form_x_objects(specific_position)
-
-    # Find forms on entire page
-    page_position = Position.at_page(0)
-    forms_on_page = client._find_form_x_objects(page_position)
-
-    # Demonstrate form manipulation if forms are found
-    manipulated_form = None
-    if all_forms:
-        first_form = all_forms[0]
-
-        # Get form properties via ObjectRef
-        form_id = first_form.get_internal_id()
-        form_type = first_form.get_type()
-        form_position = first_form.get_position()
-
-        # Demonstrate position modification for forms
-        if len(all_forms) > 1:
-            second_form = all_forms[1]
-            new_position = Position.at_page_coordinates(0, 180, 250)
-            client._move(second_form, new_position)
-            manipulated_form = second_form
-
-        # Demonstrate deletion (use last form to preserve others for testing)
-        if len(all_forms) > 2:
-            last_form = all_forms[-1]
-            client._delete(last_form)
-
-
-# noinspection PyUnusedLocal
-def path_operations(client):
-    """Test path handling operations."""
-    # Find all paths in document
-    all_paths = client._find_paths()
-
-    # Find paths at specific position
-    specific_position = Position.at_page_coordinates(0, 100, 150)
-    paths_at_position = client._find_paths(specific_position)
-
-    # Find paths on entire page
-    page_position = Position.at_page(0)
-    paths_on_page = client._find_paths(page_position)
-
-    # Demonstrate path manipulation if paths are found
-    manipulated_path = None
-    if all_paths:
-        first_path = all_paths[0]
-
-        # Get path properties via ObjectRef
-        path_id = first_path.get_internal_id()
-        path_type = first_path.get_type()
-        path_position = first_path.get_position()
-
-        # Demonstrate position modification for paths
-        if len(all_paths) > 1:
-            second_path = all_paths[1]
-            new_position = Position.at_page_coordinates(0, 120, 180)
-            client._move(second_path, new_position)
-            manipulated_path = second_path
-
-        # Demonstrate deletion (use last path to preserve others for testing)
-        if len(all_paths) > 2:
-            last_path = all_paths[-1]
-            client._delete(last_path)
-
-
-# noinspection PyUnusedLocal
-def register_font_operations(client):
-    """Test font registration operations using JetBrainsMono-Regular.ttf."""
-    # Register font using file path
-    font_path = Path("tests/fixtures/JetBrainsMono-Regular.ttf")
-    registered_font_name = client.register_font(font_path)
-
-    # Create a Font object using the registered font
-    jetbrains_font = Font(registered_font_name, 14.0)
-
-    # Use the registered font in a paragraph
-    paragraph_with_custom_font = (client.paragraph_builder()
-                                  .from_string("This text uses JetBrains Mono font")
-                                  .with_font(jetbrains_font)
-                                  .with_position(Position.at_page_coordinates(0, 50, 450))
-                                  .build())
-    client._add_paragraph(paragraph_with_custom_font)
-
-    # Register font using bytes (alternative method)
-    with open(font_path, 'rb') as f:
-        font_bytes = f.read()
-    registered_font_name_bytes = client.register_font(font_bytes)
-
-    # Create another Font object using the bytes-registered font
-    jetbrains_font_bytes = Font(registered_font_name_bytes, 16.0)
-
-
-# noinspection PyUnusedLocal
-def image_operations(client):
-    """Test image handling operations using logo-80.png."""
-    # Load actual image file
-    image_path = Path("tests/fixtures/logo-80.png")
-    with open(image_path, 'rb') as f:
-        image_bytes = f.read()
-
-    # Create image object with real image data
-    logo_image = Image(
-        position=Position.at_page_coordinates(0, 200, 400),
-        format="image/png",
-        width=80.0,
-        height=80.0,
-        data=image_bytes
-    )
-
-    # Add image to PDF
-    client._add_image(logo_image)
-
-    # Find images in document
-    found_images = client._find_images()
-
-    # Demonstrate image manipulation if images are found
-    if found_images:
-        first_image = found_images[0]
-
-        # Get image properties via ObjectRef
-        image_id = first_image.get_internal_id()
-        image_type = first_image.get_type()
-        image_position = first_image.get_position()
-
-        # Move image to a new position
-        new_image_position = Position.at_page_coordinates(0, 250, 450)
-        client._move(first_image, new_image_position)
-
-
-# noinspection PyUnusedLocal
-def objectref_operations(client, paragraphs):
-    """Test ObjectRef operations."""
-    if paragraphs and len(paragraphs) > 1:  # Use remaining paragraphs after deletion
-        obj_ref = paragraphs[1]
-        internal_id = obj_ref.get_internal_id()
-        obj_type = obj_ref.get_type()
-        position = obj_ref.get_position()
-        obj_dict = obj_ref.to_dict()
-
-        # Set new position
-        new_ref_position = Position.at_page_coordinates(0, 75, 125)
-        obj_ref.set_position(new_ref_position)
-        updated_position = obj_ref.get_position()
-
-
-# noinspection PyUnusedLocal
-def enumerations(client):
-    """Test enumeration demonstrations."""
-    object_types = list(ObjectType)
-    position_modes = list(PositionMode)
-    shape_types = list(ShapeType)
-
-
-# noinspection PyUnusedLocal
-def error_handling(client):
-    """Test error handling demonstration."""
-    exception_caught = None
-    try:
-        # This might trigger a font not found error
-        client.find_fonts("NonExistentFont", 12)
-    except FontNotFoundException as e:
-        exception_caught = e
-    except Exception as e:
-        exception_caught = e
-
-
-# noinspection PyUnusedLocal
-def pdf_operations(client):
-    """Test PDF operations."""
-    # Get PDF data
-    pdf_data = client.get_pdf_file()
-
-    # Save PDF (original functionality + comprehensive output)
-    output_path = "comprehensive_output.pdf"
-    client.save_pdf(output_path)
-    client.save_pdf("output.pdf")  # Keep original output file
-
-    # Verify file exists
-    file_exists = Path(output_path).exists()
-    file_size = Path(output_path).stat().st_size if file_exists else 0
-
-
-def context_management():
-    """Test context manager capabilities."""
-    with open("jwt-token-mlahr-20250829-160417.txt", "r", encoding="utf-8") as f:
-        token = f.read()
-
-        # Context manager automatically handles session lifecycle
-        with ClientV1(token=token, pdf_data="tests/fixtures/ObviouslyAwesome.pdf") as client:
-            paragraphs = client.find_paragraphs()
-
-            # Builder pattern works seamlessly inside context (original functionality preserved)
-            paragraph = (client.paragraph_builder()
-                         .from_string("Context managed")
-                         .with_font(Font("Arial", 12))
-                         .with_position(Position.at_page_coordinates(0, 50, 10))
-                         .build())
-
-            client._add_paragraph(paragraph)
-
-            return len(paragraphs)
-
-
-def advanced_positioning():
-    """Test advanced positioning features."""
-    # Create positions using different methods
-    positions = [
-        Position.at_page(0),
-        Position.at_page_coordinates(1, 100, 200),
-        Position.at_page_coordinates(2, 150, 250)
-    ]
-
-    modified_positions = []
-    for pos in positions:
-        # Demonstrate position copying and modification
-        copied_pos = pos.copy()
-        copied_pos.move_x(25).move_y(35)
-        modified_positions.append(copied_pos)
-
-    return positions, modified_positions
-
-
-def main():
-    """Main function demonstrating all API features."""
-    with open("jwt-token-mlahr-20250829-160417.txt", "r", encoding="utf-8") as f:
-        token = f.read()
-
-        with ClientV1(token=token, pdf_data="tests/fixtures/ObviouslyAwesome.pdf", read_timeout=30.0) as client:
-            # Execute all test operations
-            paragraphs, text_lines = find_operations(client)
-            page_management(client)
-            position_system(client)
-            font_management(client)
-            register_font_operations(client)
-            color_system(client)
-            paragraph_operations(client)
-            object_manipulation(client, paragraphs, text_lines)
-            text_line_operations(client)
-            form_operations(client)
-            path_operations(client)
-            image_operations(client)
-            objectref_operations(client, paragraphs)
-            enumerations(client)
-            error_handling(client)
-            pdf_operations(client)
-
-
-if __name__ == "__main__":
-    main()
-    context_management()
-    advanced_positioning()