pdfdancer-client-python 0.2.21__tar.gz → 0.2.23__tar.gz

pdfdancer_client_python-0.2.23/.flake8

@@ -0,0 +1,4 @@
+[flake8]
+max-line-length = 88
+extend-ignore = E203, W503, E501
+exclude = venv, build, dist, .git, __pycache__, *.egg-info

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

@@ -0,0 +1,129 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, staging, develop, development, dev ]
+  pull_request:
+    branches: [ main, staging, develop, development, dev ]
+  workflow_dispatch:
+
+jobs:
+  test:
+    # Quick minimal test on non-main branches
+    if: github.ref != 'refs/heads/main'
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: [ '3.12' ]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        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 ".[dev]"
+
+      - name: Run linter
+        run: |
+          venv/bin/python -m flake8 src/
+
+      - name: Run tests
+        run: |
+          PDFDANCER_BASE_URL=https://api-staging.pdfdancer.com \
+          PDFDANCER_TOKEN=42 \
+          venv/bin/python -m pytest tests/ -v --maxfail=3
+
+      - name: Build distribution packages
+        run: venv/bin/python -m build
+
+      - name: Validate packages
+        run: venv/bin/python -m twine check dist/*
+
+
+  test-full-matrix:
+    # Full matrix only on main
+    if: github.ref == 'refs/heads/main'
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ ubuntu-latest, windows-latest ]
+        python-version: [ '3.10', '3.11', '3.12', '3.13' ]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Create virtual environment (Unix)
+        if: runner.os != 'Windows'
+        run: python -m venv venv
+
+      - name: Install dependencies (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          venv/bin/pip install --upgrade pip
+          venv/bin/pip install -e ".[dev]"
+
+      - name: Run linter (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          venv/bin/python -m flake8 src/
+
+      - name: Run tests (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          PDFDANCER_BASE_URL=https://api-staging.pdfdancer.com \
+          PDFDANCER_TOKEN=42 \
+          venv/bin/python -m pytest tests/ -v --maxfail=3
+
+      - name: Build & Validate (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          venv/bin/python -m build
+          venv/bin/python -m twine check dist/*
+
+      - name: Create virtual environment (Windows)
+        if: runner.os == 'Windows'
+        shell: cmd
+        run: python -m venv venv
+
+      - name: Install dependencies (Windows)
+        if: runner.os == 'Windows'
+        shell: cmd
+        run: |
+          venv\Scripts\pip install --upgrade pip
+          venv\Scripts\pip install -e ".[dev]"
+
+      - name: Run linter (Windows)
+        if: runner.os == 'Windows'
+        run: |
+          venv\Scripts\python -m flake8 src/
+
+      - name: Run tests (Windows)
+        if: runner.os == 'Windows'
+        shell: cmd
+        run: |
+          set PDFDANCER_BASE_URL=https://api-staging.pdfdancer.com
+          set PDFDANCER_TOKEN=42
+          venv\Scripts\python -m pytest tests/ -v --maxfail=3
+
+      - name: Build & Validate (Windows)
+        if: runner.os == 'Windows'
+        shell: cmd
+        run: |
+          venv\Scripts\python -m build
+          venv\Scripts\python -m twine check dist/*

pdfdancer_client_python-0.2.23/.github/workflows/daily-tests.yml

@@ -0,0 +1,116 @@
+name: Daily Tests
+
+on:
+  schedule:
+    # Run daily at 9:00 PM UTC
+    - cron: '0 21 * * *'
+  workflow_dispatch: # Allow manual triggering
+
+jobs:
+  daily-test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ ubuntu-latest, windows-latest ]
+        python-version: [ '3.10', '3.11', '3.12', '3.13' ]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Create virtual environment (Unix)
+        if: runner.os != 'Windows'
+        run: python -m venv venv
+
+      - name: Install dependencies (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          venv/bin/pip install --upgrade pip
+          venv/bin/pip install -e ".[dev]"
+
+      - name: Run linter (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          venv/bin/python -m flake8 src/
+
+      - name: Run tests (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          PDFDANCER_BASE_URL=https://api-staging.pdfdancer.com \
+          PDFDANCER_TOKEN=42 \
+          venv/bin/python -m pytest tests/ -v --maxfail=3
+
+      - name: Build & Validate (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          venv/bin/python -m build
+          venv/bin/python -m twine check dist/*
+
+      - name: Create virtual environment (Windows)
+        if: runner.os == 'Windows'
+        shell: cmd
+        run: python -m venv venv
+
+      - name: Install dependencies (Windows)
+        if: runner.os == 'Windows'
+        shell: cmd
+        run: |
+          venv\Scripts\pip install --upgrade pip
+          venv\Scripts\pip install -e ".[dev]"
+
+      - name: Run linter (Windows)
+        if: runner.os == 'Windows'
+        run: |
+          venv\Scripts\python -m flake8 src/
+
+      - name: Run tests (Windows)
+        if: runner.os == 'Windows'
+        shell: cmd
+        run: |
+          set PDFDANCER_BASE_URL=https://api-staging.pdfdancer.com
+          set PDFDANCER_TOKEN=42
+          venv\Scripts\python -m pytest tests/ -v --maxfail=3
+
+      - name: Build & Validate (Windows)
+        if: runner.os == 'Windows'
+        shell: cmd
+        run: |
+          venv\Scripts\python -m build
+          venv\Scripts\python -m twine check dist/*
+
+  notify-on-failure:
+    needs: daily-test
+    runs-on: ubuntu-latest
+    if: failure()
+    steps:
+      - name: Create issue on failure
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const title = `Daily Tests Failed - ${new Date().toISOString().split('T')[0]}`;
+            const body = `The daily test run has failed. Please check the workflow run for details.\n\n[Workflow Run](${context.payload.repository.html_url}/actions/runs/${context.runId})`;
+
+            // Check if an issue already exists
+            const issues = await github.rest.issues.listForRepo({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              state: 'open',
+              labels: 'daily-test-failure'
+            });
+
+            const existingIssue = issues.data.find(issue => issue.title === title);
+
+            if (!existingIssue) {
+              await github.rest.issues.create({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                title: title,
+                body: body,
+                labels: ['daily-test-failure', 'automated']
+              });
+            }

{pdfdancer_client_python-0.2.21 → pdfdancer_client_python-0.2.23}/.gitignore

@@ -9,3 +9,11 @@ src/pdfdancer_client_python.egg-info
 /logs/
 /venv
 /venv-*
+
+# Python cache
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+/.run/

{pdfdancer_client_python-0.2.21 → pdfdancer_client_python-0.2.23}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pdfdancer-client-python
-Version: 0.2.21
+Version: 0.2.23
 Summary: Python client for PDFDancer API
 Author-email: "The Famous Cat Ltd." <hi@thefamouscat.com>
 License: 

pdfdancer_client_python-0.2.23/check.py

@@ -0,0 +1,4 @@
+#!/bin/sh
+
+
+isort src/ tests/ && black src/ tests/ && flake8 src/

{pdfdancer_client_python-0.2.21 → pdfdancer_client_python-0.2.23}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pdfdancer-client-python"
-version = "0.2.21"
+version = "0.2.23"
 description = "Python client for PDFDancer API"
 readme = "README.md"
 authors = [
@@ -48,6 +48,9 @@ Repository = "https://github.com/MenschMachine/pdfdancer-client-python"
 [tool.setuptools.packages.find]
 where = ["src"]
 
+[tool.isort]
+profile = "black"
+
 [tool.black]
 line-length = 88
 target-version = ['py310']
@@ -55,3 +58,7 @@ target-version = ['py310']
 [tool.mypy]
 python_version = "3.10"
 strict = true
+
+[tool.poetry.scripts]
+lint = "bash -c 'flake8 src && mypy src'"
+format = "bash -c 'black src && isort src'"

{pdfdancer_client_python-0.2.21 → pdfdancer_client_python-0.2.23}/src/pdfdancer/__init__.py

@@ -7,17 +7,42 @@ mirrors the Java client structure and functionality.
 """
 
 from .exceptions import (
-    PdfDancerException, FontNotFoundException, ValidationException,
-    HttpClientException, SessionException
+    FontNotFoundException,
+    HttpClientException,
+    PdfDancerException,
+    RateLimitException,
+    SessionException,
+    ValidationException,
 )
 from .models import (
-    ObjectRef, Position, ObjectType, Font, Color, Image, BoundingRect, Paragraph, FormFieldRef, TextObjectRef,
-    PageRef, PositionMode, ShapeType, Point, StandardFonts, PageSize, Orientation, TextStatus, FontRecommendation,
-    FontType, PathSegment, Line, Bezier, Path
+    Bezier,
+    BoundingRect,
+    Color,
+    Font,
+    FontRecommendation,
+    FontType,
+    FormFieldRef,
+    Image,
+    Line,
+    ObjectRef,
+    ObjectType,
+    Orientation,
+    PageRef,
+    PageSize,
+    Paragraph,
+    Path,
+    PathSegment,
+    Point,
+    Position,
+    PositionMode,
+    ShapeType,
+    StandardFonts,
+    TextObjectRef,
+    TextStatus,
 )
-from .paragraph_builder import ParagraphBuilder
 from .page_builder import PageBuilder
-from .path_builder import PathBuilder, LineBuilder, BezierBuilder
+from .paragraph_builder import ParagraphBuilder
+from .path_builder import BezierBuilder, LineBuilder, PathBuilder
 
 __version__ = "1.0.0"
 __all__ = [
@@ -56,11 +81,13 @@ __all__ = [
     "ValidationException",
     "HttpClientException",
     "SessionException",
-    "set_ssl_verify"
+    "RateLimitException",
+    "set_ssl_verify",
 ]
 
-from .pdfdancer_v1 import PDFDancer
 from . import pdfdancer_v1
+from .pdfdancer_v1 import PDFDancer
+
 
 def set_ssl_verify(enabled: bool) -> None:
     """

{pdfdancer_client_python-0.2.21 → pdfdancer_client_python-0.2.23}/src/pdfdancer/exceptions.py

@@ -35,7 +35,12 @@ class HttpClientException(PdfDancerException):
     Wraps httpx exceptions and HTTP errors from the API.
     """
 
-    def __init__(self, message: str, response: Optional[httpx.Response] = None, cause: Optional[Exception] = None):
+    def __init__(
+        self,
+        message: str,
+        response: Optional[httpx.Response] = None,
+        cause: Optional[Exception] = None,
+    ):
         super().__init__(message, cause)
         self.response = response
         self.status_code = response.status_code if response else None
@@ -46,6 +51,7 @@ class SessionException(PdfDancerException):
     Exception raised for session-related errors.
     Occurs when session creation fails or session is invalid.
     """
+
     pass
 
 
@@ -54,4 +60,22 @@ class ValidationException(PdfDancerException):
     Exception raised for input validation errors.
     Equivalent to IllegalArgumentException in the Java client.
     """
+
     pass
+
+
+class RateLimitException(PdfDancerException):
+    """
+    Exception raised when the API rate limit is exceeded (HTTP 429).
+    Includes retry-after information if provided by the server.
+    """
+
+    def __init__(
+        self,
+        message: str,
+        retry_after: Optional[int] = None,
+        response: Optional[httpx.Response] = None,
+    ):
+        super().__init__(message)
+        self.retry_after = retry_after
+        self.response = response

{pdfdancer_client_python-0.2.21 → pdfdancer_client_python-0.2.23}/src/pdfdancer/fingerprint.py

@@ -30,14 +30,14 @@ class Fingerprint:
         install_salt = cls._get_or_create_salt()
 
         fingerprint_data = (
-                ip_hash +
-                uid_hash +
-                os_type +
-                sdk_language +
-                timezone +
-                locale_str +
-                domain_hash +
-                install_salt
+            ip_hash
+            + uid_hash
+            + os_type
+            + sdk_language
+            + timezone
+            + locale_str
+            + domain_hash
+            + install_salt
         )
 
         return cls._hash(fingerprint_data)
@@ -63,7 +63,7 @@ class Fingerprint:
         """Get timezone name."""
         try:
             tz = datetime.now().astimezone().tzinfo
-            timezone_name = getattr(tz, 'key', str(tz))
+            timezone_name = getattr(tz, "key", str(tz))
             return timezone_name
         except Exception:
             return "unknown"
@@ -118,4 +118,4 @@ class Fingerprint:
         Returns:
             Hexadecimal SHA256 hash
         """
-        return hashlib.sha256(value.encode('utf-8')).hexdigest()
+        return hashlib.sha256(value.encode("utf-8")).hexdigest()

{pdfdancer_client_python-0.2.21 → pdfdancer_client_python-0.2.23}/src/pdfdancer/image_builder.py

@@ -1,11 +1,17 @@
+from __future__ import annotations
+
 from pathlib import Path
+from typing import TYPE_CHECKING
+
+from pdfdancer import Image, Position, ValidationException
 
-from pdfdancer import ValidationException, Image, Position
+if TYPE_CHECKING:
+    from .pdfdancer_v1 import PDFDancer
 
 
 class ImageBuilder:
 
-    def __init__(self, client: 'PDFDancer'):
+    def __init__(self, client: "PDFDancer"):
         """
         Initialize the image builder with a client reference.
 
@@ -18,11 +24,11 @@ class ImageBuilder:
         self._client = client
         self._image = Image()
 
-    def from_file(self, img_path: Path) -> 'ImageBuilder':
+    def from_file(self, img_path: Path) -> "ImageBuilder":
         self._image.data = img_path.read_bytes()
         return self
 
-    def at(self, page, x, y) -> 'ImageBuilder':
+    def at(self, page, x, y) -> "ImageBuilder":
         self._image.position = Position.at_page_coordinates(page, x, y)
         return self
 
@@ -33,7 +39,7 @@ class ImageBuilder:
 
 class ImageOnPageBuilder:
 
-    def __init__(self, client: 'PDFDancer', page_index: int):
+    def __init__(self, client: "PDFDancer", page_index: int):
         """
         Initialize the image builder with a client reference.
 
@@ -47,11 +53,11 @@ class ImageOnPageBuilder:
         self._image = Image()
         self._page_index = page_index
 
-    def from_file(self, img_path: Path) -> 'ImageOnPageBuilder':
+    def from_file(self, img_path: Path) -> "ImageOnPageBuilder":
         self._image.data = img_path.read_bytes()
         return self
 
-    def at(self, x, y) -> 'ImageOnPageBuilder':
+    def at(self, x, y) -> "ImageOnPageBuilder":
         self._image.position = Position.at_page_coordinates(self._page_index, x, y)
         return self