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

pdfdancer_client_python-0.2.2/.github/workflows/ci.yml

@@ -0,0 +1,40 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, staging, develop, development, dev ]
+  pull_request:
+    branches: [ main, staging, develop, development, dev ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.9', '3.10', '3.11', '3.12']
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v4
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Create virtual environment
+      run: python -m venv venv
+
+    - name: Install dependencies
+      run: |
+        venv/bin/pip install --upgrade pip
+        venv/bin/pip install -e .
+        venv/bin/pip install -r requirements-dev.txt
+
+    - name: Run tests
+      run: venv/bin/python -m pytest tests/ -v --ignore=tests/e2e/
+
+    - name: Build distribution packages
+      run: venv/bin/python -m build
+
+    - name: Validate packages
+      run: venv/bin/python -m twine check dist/*

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

@@ -1,7 +1,8 @@
 output.pdf
 .idea
 comprehensive_output.pdf
-jwt-token-mlahr-20250829-160417.txt
+jwt-token*.txt
 dist/
 src/pdfdancer_python.egg-info
 .aider*
+src/pdfdancer_client_python.egg-info

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

@@ -38,19 +38,19 @@ 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()
-    .from_string("Text content")
-    .with_font(Font("Arial", 12))
-    .with_position(Position.on_page_coordinates(0, 100, 200))
-    .build())
+             .from_string("Text content")
+             .with_font(Font("Arial", 12))
+             .with_position(Position.at_page_coordinates(0, 100, 200))
+             .build())
 
 # Context manager support (Python enhancement)
 with ClientV1(token="jwt-token", pdf_data=pdf_file) as client:

{pdfdancer_client_python-0.1.1/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.1
+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
@@ -57,21 +56,21 @@ client = ClientV1(token="your-jwt-token", pdf_data="document.pdf")
 
 # Find operations (mirrors Java client methods)
 paragraphs = client.find_paragraphs(None)
-images = client.find_images(Position.from_page_index(0))
+images = client.find_images(Position.at_page(0))
 
 # Manipulation operations (mirrors Java client methods)
-client.delete(paragraphs[0])
-client.move(images[0], Position.on_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()
              .from_string("Hello World")
              .with_font(Font("Arial", 12))
              .with_color(Color(255, 0, 0))
-             .with_position(Position.from_page_index(0))
+             .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")
 ```
 
@@ -167,12 +168,12 @@ paragraph = (builder
 from pdfdancer import Position
 
 # Factory methods (Java: Position.fromPageNumber(), Position.onPageCoordinates())
-position = Position.from_page_index(0)
-position = Position.on_page_coordinates(0, 100, 200)
+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)
@@ -237,7 +238,7 @@ font = Font(name="Arial", size=12.0)
 color = Color(r=255, g=128, b=0)
 
 # Position with bounding rectangle (Java: Position, BoundingRect)
-position = Position.on_page_coordinates(page=0, x=100.0, y=200.0)
+position = Position.at_page_coordinates(page=0, x=100.0, y=200.0)
 ```
 
 ## Development
@@ -261,11 +262,6 @@ python -m pytest tests/test_paragraph_builder.py -v
 python -m pytest tests/test_models.py -v
 ```
 
-### Run Demo
-```bash
-python demo.py
-```
-
 ### Build Package
 ```bash
 python -m build

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

@@ -30,21 +30,21 @@ client = ClientV1(token="your-jwt-token", pdf_data="document.pdf")
 
 # Find operations (mirrors Java client methods)
 paragraphs = client.find_paragraphs(None)
-images = client.find_images(Position.from_page_index(0))
+images = client.find_images(Position.at_page(0))
 
 # Manipulation operations (mirrors Java client methods)
-client.delete(paragraphs[0])
-client.move(images[0], Position.on_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()
              .from_string("Hello World")
              .with_font(Font("Arial", 12))
              .with_color(Color(255, 0, 0))
-             .with_position(Position.from_page_index(0))
+             .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")
 ```
 
@@ -140,12 +142,12 @@ paragraph = (builder
 from pdfdancer import Position
 
 # Factory methods (Java: Position.fromPageNumber(), Position.onPageCoordinates())
-position = Position.from_page_index(0)
-position = Position.on_page_coordinates(0, 100, 200)
+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)
@@ -210,7 +212,7 @@ font = Font(name="Arial", size=12.0)
 color = Color(r=255, g=128, b=0)
 
 # Position with bounding rectangle (Java: Position, BoundingRect)
-position = Position.on_page_coordinates(page=0, x=100.0, y=200.0)
+position = Position.at_page_coordinates(page=0, x=100.0, y=200.0)
 ```
 
 ## Development
@@ -234,11 +236,6 @@ python -m pytest tests/test_paragraph_builder.py -v
 python -m pytest tests/test_models.py -v
 ```
 
-### Run Demo
-```bash
-python demo.py
-```
-
 ### Build Package
 ```bash
 python -m build

{pdfdancer_client_python-0.1.1 → 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.1"
+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"}
+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,16 +36,16 @@ 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"]
 
 [tool.black]
 line-length = 88
-target-version = ['py38']
+target-version = ['py39']
 
 [tool.mypy]
-python_version = "3.8"
+python_version = "3.9"
 strict = true

pdfdancer_client_python-0.2.2/release.py

@@ -0,0 +1,272 @@
+#!/usr/bin/env python3
+"""
+PDFDancer Python Client Release Tool
+
+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
+
+
+class ReleaseError(Exception):
+    """Base exception for release operations."""
+    pass
+
+
+class VersionBumper:
+    """Handles version bumping in pyproject.toml."""
+
+    def __init__(self, pyproject_path: Path = Path("pyproject.toml")):
+        self.pyproject_path = pyproject_path
+        if not self.pyproject_path.exists():
+            raise ReleaseError(f"pyproject.toml not found at {pyproject_path}")
+
+    def get_current_version(self) -> str:
+        """Get the current version from pyproject.toml."""
+        content = self.pyproject_path.read_text()
+        match = re.search(r'^version\s*=\s*"([^"]+)"', content, re.MULTILINE)
+        if not match:
+            raise ReleaseError("Version not found in pyproject.toml")
+        return match.group(1)
+
+    def set_version(self, new_version: str) -> None:
+        """Set a new version in pyproject.toml."""
+        content = self.pyproject_path.read_text()
+        new_content = re.sub(
+            r'^version\s*=\s*"[^"]+"',
+            f'version = "{new_version}"',
+            content,
+            flags=re.MULTILINE
+        )
+        if content == new_content:
+            raise ReleaseError("Failed to update version in pyproject.toml")
+        self.pyproject_path.write_text(new_content)
+
+    def bump_version(self, bump_type: str) -> str:
+        """Bump version by type (major, minor, patch)."""
+        current = self.get_current_version()
+        parts = current.split(".")
+
+        if len(parts) != 3:
+            raise ReleaseError(f"Invalid version format: {current}")
+
+        try:
+            major, minor, patch = map(int, parts)
+        except ValueError:
+            raise ReleaseError(f"Invalid version format: {current}")
+
+        if bump_type == "major":
+            major += 1
+            minor = 0
+            patch = 0
+        elif bump_type == "minor":
+            minor += 1
+            patch = 0
+        elif bump_type == "patch":
+            patch += 1
+        else:
+            raise ReleaseError(f"Invalid bump type: {bump_type}")
+
+        new_version = f"{major}.{minor}.{patch}"
+        self.set_version(new_version)
+        return new_version
+
+
+class PyPIUploader:
+    """Handles PyPI upload operations."""
+
+    def __init__(self, venv_path: Path = Path("venv")):
+        self.venv_path = venv_path
+        self.python_exe = self._get_python_executable()
+
+    def _get_python_executable(self) -> Path:
+        """Get the Python executable from the virtual environment."""
+        if sys.platform == "win32":
+            python_exe = self.venv_path / "Scripts" / "python.exe"
+        else:
+            python_exe = self.venv_path / "bin" / "python"
+
+        if not python_exe.exists():
+            raise ReleaseError(f"Python executable not found at {python_exe}")
+        return python_exe
+
+    def run_command(self, cmd: List[str], check: bool = True) -> subprocess.CompletedProcess:
+        """Run a command and return the result."""
+        print(f"Running: {' '.join(cmd)}")
+        result = subprocess.run(cmd, capture_output=True, text=True)
+
+        if check and result.returncode != 0:
+            print(f"Command failed with exit code {result.returncode}")
+            print(f"STDOUT: {result.stdout}")
+            print(f"STDERR: {result.stderr}")
+            raise ReleaseError(f"Command failed: {' '.join(cmd)}")
+
+        return result
+
+    def clean_dist(self) -> None:
+        """Clean the dist directory."""
+        dist_path = Path("dist")
+        if dist_path.exists():
+            import shutil
+            shutil.rmtree(dist_path)
+            print("Cleaned dist directory")
+
+    def build_package(self) -> None:
+        """Build the package."""
+        self.run_command([str(self.python_exe), "-m", "build"])
+        print("Package built successfully")
+
+    def check_package(self) -> None:
+        """Check the built package."""
+        self.run_command([str(self.python_exe), "-m", "twine", "check", "dist/*"])
+        print("Package validation passed")
+
+    def upload_to_pypi(self, test: bool = False) -> None:
+        """Upload to PyPI or test PyPI."""
+        cmd = [str(self.python_exe), "-m", "twine", "upload"]
+        if test:
+            cmd.extend(["--repository", "testpypi"])
+        cmd.append("dist/*")
+
+        self.run_command(cmd)
+        repo_name = "Test PyPI" if test else "PyPI"
+        print(f"Package uploaded to {repo_name} successfully")
+
+    def run_tests(self, include_e2e: bool = False) -> None:
+        """Run the test suite."""
+        if include_e2e:
+            test_path = "tests/"
+        else:
+            # 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")
+
+
+def main():
+    """Main entry point."""
+    parser = argparse.ArgumentParser(description="PDFDancer Python Client Release Tool")
+    parser.add_argument(
+        "action",
+        choices=["bump", "upload", "release"],
+        help="Action to perform: bump (version only), upload (build+upload), release (bump+test+build+upload)"
+    )
+    parser.add_argument(
+        "--bump-type",
+        choices=["major", "minor", "patch"],
+        default="patch",
+        help="Type of version bump (default: patch)"
+    )
+    parser.add_argument(
+        "--version",
+        help="Specific version to set (overrides --bump-type)"
+    )
+    parser.add_argument(
+        "--test",
+        action="store_true",
+        help="Upload to test PyPI instead of production PyPI"
+    )
+    parser.add_argument(
+        "--skip-tests",
+        action="store_true",
+        help="Skip running tests before release"
+    )
+    parser.add_argument(
+        "--include-e2e",
+        action="store_true",
+        help="Include E2E tests (requires PDFDancer server and token)"
+    )
+    parser.add_argument(
+        "--dry-run",
+        action="store_true",
+        help="Show what would be done without actually doing it"
+    )
+
+    args = parser.parse_args()
+
+    try:
+        version_bumper = VersionBumper()
+        uploader = PyPIUploader()
+
+        if args.dry_run:
+            print("DRY RUN MODE - No changes will be made")
+
+        if args.action in ["bump", "release"]:
+            current_version = version_bumper.get_current_version()
+            print(f"Current version: {current_version}")
+
+            if args.version:
+                new_version = args.version
+                if not args.dry_run:
+                    version_bumper.set_version(new_version)
+            else:
+                if not args.dry_run:
+                    new_version = version_bumper.bump_version(args.bump_type)
+                else:
+                    # Calculate what the new version would be for dry run
+                    parts = current_version.split(".")
+                    major, minor, patch = map(int, parts)
+                    if args.bump_type == "major":
+                        major += 1
+                        minor = 0
+                        patch = 0
+                    elif args.bump_type == "minor":
+                        minor += 1
+                        patch = 0
+                    elif args.bump_type == "patch":
+                        patch += 1
+                    new_version = f"{major}.{minor}.{patch}"
+
+            print(f"New version: {new_version}")
+
+        if args.action in ["upload", "release"]:
+            if args.action == "release" and not args.skip_tests:
+                if not args.dry_run:
+                    print("Running tests...")
+                    uploader.run_tests(include_e2e=args.include_e2e)
+                else:
+                    test_type = "all tests (including E2E)" if args.include_e2e else "unit tests only"
+                    print(f"Would run {test_type}")
+
+            if not args.dry_run:
+                print("Cleaning dist directory...")
+                uploader.clean_dist()
+
+                print("Building package...")
+                uploader.build_package()
+
+                print("Checking package...")
+                uploader.check_package()
+
+                print("Uploading to PyPI...")
+                uploader.upload_to_pypi(test=args.test)
+            else:
+                print("Would clean dist directory")
+                print("Would build package")
+                print("Would check package")
+                repo_name = "Test PyPI" if args.test else "PyPI"
+                print(f"Would upload to {repo_name}")
+
+        print("Release process completed successfully!")
+
+    except ReleaseError as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)
+    except KeyboardInterrupt:
+        print("\nOperation cancelled by user", file=sys.stderr)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()