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

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

@@ -38,12 +38,12 @@ The client is a pure manual implementation that closely mirrors the Java client:
 client = ClientV1(token="jwt-token", pdf_data="document.pdf")
 
 # Find operations (mirrors Java findParagraphs, findImages, etc.)
-paragraphs = client.find_paragraphs(position)
-images = client.find_images(position)
+paragraphs = client._find_paragraphs(position)
+images = client._find_images(position)
 
 # Manipulation operations (mirrors Java delete, move, etc.)
-client.delete(paragraphs[0])
-client.move(images[0], new_position)
+client._delete(paragraphs[0])
+client._move(images[0], new_position)
 
 # Builder pattern (mirrors Java ParagraphBuilder)
 paragraph = (client.paragraph_builder()

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

@@ -1,19 +1,18 @@
 Metadata-Version: 2.4
 Name: pdfdancer-client-python
-Version: 0.1.2
+Version: 0.2.2
 Summary: Python client for PDFDancer API
-Author-email: TFC <info@example.com>
+Author-email: "The Famous Cat Ltd." <hi@thefamouscat.com>
 License: MIT
-Project-URL: Homepage, https://github.com/tfc/pdfdancer-python
-Project-URL: Repository, https://github.com/tfc/pdfdancer-python.git
+Project-URL: Homepage, https://www.pdfdancer.com/
+Project-URL: Repository, https://github.com/MenschMachine/pdfdancer-client-python
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
 Description-Content-Type: text/markdown
 Requires-Dist: requests>=2.25.0
 Requires-Dist: pydantic>=1.8.0
@@ -60,8 +59,8 @@ paragraphs = client.find_paragraphs(None)
 images = client.find_images(Position.at_page(0))
 
 # Manipulation operations (mirrors Java client methods)
-client.delete(paragraphs[0])
-client.move(images[0], Position.at_page_coordinates(0, 100, 200))
+client._delete(paragraphs[0])
+client._move(images[0], Position.at_page_coordinates(0, 100, 200))
 
 # Builder pattern (mirrors Java ParagraphBuilder)
 paragraph = (client.paragraph_builder()
@@ -71,7 +70,7 @@ paragraph = (client.paragraph_builder()
              .with_position(Position.at_page(0))
              .build())
 
-client.add_paragraph(paragraph)
+client._add_paragraph(paragraph)
 
 # Save result (mirrors Java savePDF)
 client.save_pdf("output.pdf")
@@ -85,7 +84,7 @@ from pdfdancer import ClientV1
 # Automatic resource management
 with ClientV1(token="jwt-token", pdf_data="input.pdf") as client:
     paragraphs = client.find_paragraphs(None)
-    client.delete(paragraphs[0])
+    client._delete(paragraphs[0])
     client.save_pdf("output.pdf")
     # Session automatically cleaned up
 ```
@@ -105,37 +104,39 @@ client = ClientV1(token="jwt-token", pdf_data=pdf_file, base_url="https://api.se
 ```
 
 ### Find Operations
+
 ```python
 # Generic find (Java: client.find())
-objects = client.find(ObjectType.PARAGRAPH, position)
+objects = client._find(ObjectType.PARAGRAPH, position)
 
 # Specific finders (Java: client.findParagraphs(), etc.)
-paragraphs = client.find_paragraphs(position)
-images = client.find_images(position)
-forms = client.find_forms(position)
-paths = client.find_paths(position)
-text_lines = client.find_text_lines(position)
+paragraphs = client._find_paragraphs(position)
+images = client._find_images(position)
+forms = client._find_form_x_objects(position)
+paths = client._find_paths(position)
+text_lines = client._find_text_lines(position)
 
 # Page operations (Java: client.getPages(), client.getPage())
 pages = client.get_pages()
-page = client.get_page(1)  # 1-based indexing
+page = client._get_page(1)  # 1-based indexing
 ```
 
 ### Manipulation Operations
+
 ```python
 # Delete (Java: client.delete(), client.deletePage())
-result = client.delete(object_ref)
-result = client.delete_page(page_ref)
+result = client._delete(object_ref)
+result = client._delete_page(page_ref)
 
 # Move (Java: client.move())
-result = client.move(object_ref, new_position)
+result = client._move(object_ref, new_position)
 
 # Add (Java: client.addImage(), client.addParagraph())
-result = client.add_image(image, position)
-result = client.add_paragraph(paragraph)
+result = client._add_image(image, position)
+result = client._add_paragraph(paragraph)
 
 # Modify (Java: client.modifyParagraph(), client.modifyTextLine())
-result = client.modify_paragraph(ref, new_paragraph)
+result = client._modify_paragraph(ref, new_paragraph)
 result = client.modify_text_line(ref, "new text")
 ```
 
@@ -171,8 +172,8 @@ position = Position.at_page(0)
 position = Position.at_page_coordinates(0, 100, 200)
 
 # Coordinate access (Java: position.getX(), position.getY())
-x = position.get_x()
-y = position.get_y()
+x = position.x()
+y = position.y()
 
 # Movement (Java: position.moveX(), position.moveY())
 position.move_x(50.0)

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

@@ -33,8 +33,8 @@ paragraphs = client.find_paragraphs(None)
 images = client.find_images(Position.at_page(0))
 
 # Manipulation operations (mirrors Java client methods)
-client.delete(paragraphs[0])
-client.move(images[0], Position.at_page_coordinates(0, 100, 200))
+client._delete(paragraphs[0])
+client._move(images[0], Position.at_page_coordinates(0, 100, 200))
 
 # Builder pattern (mirrors Java ParagraphBuilder)
 paragraph = (client.paragraph_builder()
@@ -44,7 +44,7 @@ paragraph = (client.paragraph_builder()
              .with_position(Position.at_page(0))
              .build())
 
-client.add_paragraph(paragraph)
+client._add_paragraph(paragraph)
 
 # Save result (mirrors Java savePDF)
 client.save_pdf("output.pdf")
@@ -58,7 +58,7 @@ from pdfdancer import ClientV1
 # Automatic resource management
 with ClientV1(token="jwt-token", pdf_data="input.pdf") as client:
     paragraphs = client.find_paragraphs(None)
-    client.delete(paragraphs[0])
+    client._delete(paragraphs[0])
     client.save_pdf("output.pdf")
     # Session automatically cleaned up
 ```
@@ -78,37 +78,39 @@ client = ClientV1(token="jwt-token", pdf_data=pdf_file, base_url="https://api.se
 ```
 
 ### Find Operations
+
 ```python
 # Generic find (Java: client.find())
-objects = client.find(ObjectType.PARAGRAPH, position)
+objects = client._find(ObjectType.PARAGRAPH, position)
 
 # Specific finders (Java: client.findParagraphs(), etc.)
-paragraphs = client.find_paragraphs(position)
-images = client.find_images(position)
-forms = client.find_forms(position)
-paths = client.find_paths(position)
-text_lines = client.find_text_lines(position)
+paragraphs = client._find_paragraphs(position)
+images = client._find_images(position)
+forms = client._find_form_x_objects(position)
+paths = client._find_paths(position)
+text_lines = client._find_text_lines(position)
 
 # Page operations (Java: client.getPages(), client.getPage())
 pages = client.get_pages()
-page = client.get_page(1)  # 1-based indexing
+page = client._get_page(1)  # 1-based indexing
 ```
 
 ### Manipulation Operations
+
 ```python
 # Delete (Java: client.delete(), client.deletePage())
-result = client.delete(object_ref)
-result = client.delete_page(page_ref)
+result = client._delete(object_ref)
+result = client._delete_page(page_ref)
 
 # Move (Java: client.move())
-result = client.move(object_ref, new_position)
+result = client._move(object_ref, new_position)
 
 # Add (Java: client.addImage(), client.addParagraph())
-result = client.add_image(image, position)
-result = client.add_paragraph(paragraph)
+result = client._add_image(image, position)
+result = client._add_paragraph(paragraph)
 
 # Modify (Java: client.modifyParagraph(), client.modifyTextLine())
-result = client.modify_paragraph(ref, new_paragraph)
+result = client._modify_paragraph(ref, new_paragraph)
 result = client.modify_text_line(ref, "new text")
 ```
 
@@ -144,8 +146,8 @@ position = Position.at_page(0)
 position = Position.at_page_coordinates(0, 100, 200)
 
 # Coordinate access (Java: position.getX(), position.getY())
-x = position.get_x()
-y = position.get_y()
+x = position.x()
+y = position.y()
 
 # Movement (Java: position.moveX(), position.moveY())
 position.move_x(50.0)

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

@@ -4,22 +4,21 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pdfdancer-client-python"
-version = "0.1.2"
+version = "0.2.2"
 description = "Python client for PDFDancer API"
 readme = "README.md"
 authors = [
-    { name = "TFC", email = "info@example.com" }
+    { name = "The Famous Cat Ltd.", email = "hi@thefamouscat.com" }
 ]
 license = { text = "MIT" }
 classifiers = [
     "Development Status :: 4 - Beta",
     "Intended Audience :: Developers",
     "License :: OSI Approved :: MIT License",
-    "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.8",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
 ]
 dependencies = [
     "requests>=2.25.0",
@@ -37,8 +36,8 @@ dev = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/tfc/pdfdancer-python"
-Repository = "https://github.com/tfc/pdfdancer-python.git"
+Homepage = "https://www.pdfdancer.com/"
+Repository = "https://github.com/MenschMachine/pdfdancer-client-python"
 
 [tool.setuptools.packages.find]
 where = ["src"]

{pdfdancer_client_python-0.1.2 → pdfdancer_client_python-0.2.2}/release.py

@@ -6,11 +6,12 @@ A tool to bump version and upload to PyPI.
 """
 
 import argparse
+import glob
 import re
 import subprocess
 import sys
 from pathlib import Path
-from typing import List, Optional
+from typing import List
 
 
 class ReleaseError(Exception):
@@ -142,7 +143,12 @@ class PyPIUploader:
         if include_e2e:
             test_path = "tests/"
         else:
-            test_path = "tests/test_client_v1.py tests/test_models.py tests/test_paragraph_builder.py"
+            # Collect all test files except those in e2e/
+            test_files = [
+                f for f in glob.glob("tests/**/*.py", recursive=True)
+                if "e2e" not in f
+            ]
+            test_path = " ".join(test_files)
 
         self.run_command([str(self.python_exe), "-m", "pytest"] + test_path.split() + ["-v"])
         print("All tests passed")
@@ -263,4 +269,4 @@ def main():
 
 
 if __name__ == "__main__":
-    main()
+    main()

{pdfdancer_client_python-0.1.2 → pdfdancer_client_python-0.2.2}/src/pdfdancer/__init__.py

@@ -6,20 +6,19 @@ Provides a clean, Pythonic interface for PDF operations that closely
 mirrors the Java client structure and functionality.
 """
 
-from .client_v1 import ClientV1
 from .exceptions import (
     PdfDancerException, FontNotFoundException, ValidationException,
     HttpClientException, SessionException
 )
 from .models import (
-    ObjectRef, Position, ObjectType, Font, Color, Image, BoundingRect, Paragraph,
+    ObjectRef, Position, ObjectType, Font, Color, Image, BoundingRect, Paragraph, FormFieldRef,
     PositionMode, ShapeType, Point
 )
 from .paragraph_builder import ParagraphBuilder
 
 __version__ = "1.0.0"
 __all__ = [
-    "ClientV1",
+    "PDFDancer",
     "ParagraphBuilder",
     "ObjectRef",
     "Position",
@@ -29,6 +28,7 @@ __all__ = [
     "Image",
     "BoundingRect",
     "Paragraph",
+    "FormFieldRef",
     "PositionMode",
     "ShapeType",
     "Point",
@@ -38,3 +38,5 @@ __all__ = [
     "HttpClientException",
     "SessionException"
 ]
+
+from .pdfdancer_v1 import PDFDancer

pdfdancer_client_python-0.2.2/src/pdfdancer/image_builder.py

@@ -0,0 +1,30 @@
+from pathlib import Path
+
+from pdfdancer import ValidationException, Image, Position
+
+
+class ImageBuilder:
+
+    def __init__(self, client: 'PDFDancer'):
+        """
+        Initialize the image builder with a client reference.
+
+        Args:
+            client: The PDFDancer instance for font registration
+        """
+        if client is None:
+            raise ValidationException("Client cannot be null")
+
+        self._client = client
+        self._image = Image()
+
+    def from_file(self, img_path: Path) -> 'ImageBuilder':
+        self._image.data = img_path.read_bytes()
+        return self
+
+    def at(self, page, x, y) -> 'ImageBuilder':
+        self._image.position = Position.at_page_coordinates(page, x, y)
+        return self
+
+    def add(self) -> bool:
+        return self._client._add_image(self._image, self._image.position)

{pdfdancer_client_python-0.1.2 → pdfdancer_client_python-0.2.2}/src/pdfdancer/models.py

@@ -10,12 +10,16 @@ from typing import Optional, List, Any
 
 class ObjectType(Enum):
     """Object type enumeration matching the Java ObjectType."""
+    FORM_FIELD = "FORM_FIELD"
     IMAGE = "IMAGE"
     FORM_X_OBJECT = "FORM_X_OBJECT"
     PATH = "PATH"
     PARAGRAPH = "PARAGRAPH"
     TEXT_LINE = "TEXT_LINE"
     PAGE = "PAGE"
+    TEXT_FIELD = "TEXT_FIELD"
+    CHECK_BOX = "CHECK_BOX"
+    RADIO_BUTTON = "RADIO_BUTTON"
 
 
 class PositionMode(Enum):
@@ -74,6 +78,7 @@ class Position:
     mode: Optional[PositionMode] = None
     bounding_rect: Optional[BoundingRect] = None
     text_starts_with: Optional[str] = None
+    name: Optional[str] = None
 
     @staticmethod
     def at_page(page_index: int) -> 'Position':
@@ -93,7 +98,17 @@ class Position:
         position.at_coordinates(Point(x, y))
         return position
 
-    def at_coordinates(self, point: Point) -> None:
+    @staticmethod
+    def by_name(name: str) -> 'Position':
+        """
+        Creates a position specification for finding objects by name.
+        Equivalent to Position.byName() in Java.
+        """
+        position = Position()
+        position.name = name
+        return position
+
+    def at_coordinates(self, point: Point) -> 'Position':
         """
         Sets the position to a specific point location.
         Equivalent to Position.set() in Java.
@@ -101,7 +116,7 @@ class Position:
         self.mode = PositionMode.CONTAINS
         self.shape = ShapeType.POINT
         self.bounding_rect = BoundingRect(point.x, point.y, 0, 0)
-        return self;
+        return self
 
     def with_text_starts(self, text: str) -> 'Position':
         self.text_starts_with = text
@@ -110,20 +125,20 @@ class Position:
     def move_x(self, x_offset: float) -> 'Position':
         """Move the position horizontally by the specified offset."""
         if self.bounding_rect:
-            self.at_coordinates(Point(self.get_x() + x_offset, self.get_y()))
+            self.at_coordinates(Point(self.x() + x_offset, self.y()))
         return self
 
     def move_y(self, y_offset: float) -> 'Position':
         """Move the position vertically by the specified offset."""
         if self.bounding_rect:
-            self.at_coordinates(Point(self.get_x(), self.get_y() + y_offset))
+            self.at_coordinates(Point(self.x(), self.y() + y_offset))
         return self
 
-    def get_x(self) -> Optional[float]:
+    def x(self) -> Optional[float]:
         """Returns the X coordinate of this position."""
         return self.bounding_rect.get_x() if self.bounding_rect else None
 
-    def get_y(self) -> Optional[float]:
+    def y(self) -> Optional[float]:
         """Returns the Y coordinate of this position."""
         return self.bounding_rect.get_y() if self.bounding_rect else None
 
@@ -269,6 +284,8 @@ class FindRequest:
             "pageIndex": position.page_index,
             "textStartsWith": position.text_starts_with
         }
+        if position.name:
+            result["name"] = position.name
         if position.shape:
             result["shape"] = position.shape.value
         if position.mode:
@@ -420,3 +437,38 @@ class ModifyTextRequest:
             },
             "newTextLine": self.new_text
         }
+
+
+@dataclass
+class ChangeFormFieldRequest:
+    object_ref: ObjectRef
+    value: str
+
+    def to_dict(self) -> dict:
+        """Convert to dictionary for JSON serialization."""
+        return {
+            "ref": {
+                "internalId": self.object_ref.internal_id,
+                "position": FindRequest._position_to_dict(self.object_ref.position),
+                "type": self.object_ref.type.value
+            },
+            "value": self.value
+        }
+
+
+@dataclass
+class FormFieldRef(ObjectRef):
+    """
+    Represents a form field reference with additional form-specific properties.
+    Extends ObjectRef to include form field name and value.
+    """
+    name: Optional[str] = None
+    value: Optional[str] = None
+
+    def get_name(self) -> Optional[str]:
+        """Get the form field name."""
+        return self.name
+
+    def get_value(self) -> Optional[str]:
+        """Get the form field value."""
+        return self.value

{pdfdancer_client_python-0.1.2 → pdfdancer_client_python-0.2.2}/src/pdfdancer/paragraph_builder.py

@@ -4,14 +4,11 @@ Closely mirrors the Java ParagraphBuilder class with Python conventions.
 """
 
 from pathlib import Path
-from typing import Optional, Union, TYPE_CHECKING
+from typing import Optional, Union
 
 from .exceptions import ValidationException
 from .models import Paragraph, Font, Color, Position
 
-if TYPE_CHECKING:
-    from .client_v1 import ClientV1
-
 
 class ParagraphBuilder:
     """
@@ -19,7 +16,7 @@ class ParagraphBuilder:
     Mirrors the Java ParagraphBuilder class exactly.
     """
 
-    def __init__(self, client: 'ClientV1'):
+    def __init__(self, client: 'PDFDancer'):
         """
         Initialize the paragraph builder with a client reference.
 
@@ -37,7 +34,7 @@ class ParagraphBuilder:
         self._ttf_file: Optional[Path] = None
         self._font: Optional[Font] = None
 
-    def from_string(self, text: str, color: Optional[Color] = None) -> 'ParagraphBuilder':
+    def text(self, text: str, color: Optional[Color] = None) -> 'ParagraphBuilder':
         """
         Set the text content for the paragraph.
         Equivalent to fromString() methods in Java ParagraphBuilder.
@@ -63,13 +60,14 @@ class ParagraphBuilder:
 
         return self
 
-    def with_font(self, font: Font) -> 'ParagraphBuilder':
+    def font(self, font_name: str, font_size: float) -> 'ParagraphBuilder':
         """
         Set the font for the paragraph using an existing Font object.
         Equivalent to withFont(Font) in Java ParagraphBuilder.
 
         Args:
-            font: The Font object to use
+            font_name: The Font to use
+            font_size: The font size
 
         Returns:
             Self for method chaining
@@ -77,6 +75,7 @@ class ParagraphBuilder:
         Raises:
             ValidationException: If font is None
         """
+        font = Font(font_name, font_size)
         if font is None:
             raise ValidationException("Font cannot be null")
 
@@ -84,7 +83,7 @@ class ParagraphBuilder:
         self._ttf_file = None  # Clear TTF file when using existing font
         return self
 
-    def with_font_file(self, ttf_file: Union[Path, str], font_size: float) -> 'ParagraphBuilder':
+    def font_file(self, ttf_file: Union[Path, str], font_size: float) -> 'ParagraphBuilder':
         """
         Set the font for the paragraph using a TTF file.
         Equivalent to withFont(File, double) in Java ParagraphBuilder.
@@ -125,7 +124,7 @@ class ParagraphBuilder:
         self._font = self._register_ttf(ttf_path, font_size)
         return self
 
-    def with_line_spacing(self, spacing: float) -> 'ParagraphBuilder':
+    def line_spacing(self, spacing: float) -> 'ParagraphBuilder':
         """
         Set the line spacing for the paragraph.
         Equivalent to withLineSpacing() in Java ParagraphBuilder.
@@ -145,7 +144,7 @@ class ParagraphBuilder:
         self._line_spacing = spacing
         return self
 
-    def with_color(self, color: Color) -> 'ParagraphBuilder':
+    def color(self, color: Color) -> 'ParagraphBuilder':
         """
         Set the text color for the paragraph.
         Equivalent to withColor() in Java ParagraphBuilder.
@@ -165,7 +164,7 @@ class ParagraphBuilder:
         self._text_color = color
         return self
 
-    def with_position(self, position: Position) -> 'ParagraphBuilder':
+    def at(self, page_index: int, x: float, y: float) -> 'ParagraphBuilder':
         """
         Set the position for the paragraph.
         Equivalent to withPosition() in Java ParagraphBuilder.
@@ -179,6 +178,7 @@ class ParagraphBuilder:
         Raises:
             ValidationException: If position is None
         """
+        position = Position.at_page_coordinates(page_index, x, y)
         if position is None:
             raise ValidationException("Position cannot be null")
 
@@ -265,3 +265,6 @@ class ParagraphBuilder:
             lines = ['']
 
         return lines
+
+    def add(self):
+        self._client._add_paragraph(self.build())