pdfdancer-client-python 0.2.7__tar.gz → 0.2.9__tar.gz

{pdfdancer_client_python-0.2.7/src/pdfdancer_client_python.egg-info → pdfdancer_client_python-0.2.9}/PKG-INFO

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

{pdfdancer_client_python-0.2.7 → pdfdancer_client_python-0.2.9}/pyproject.toml

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

{pdfdancer_client_python-0.2.7 → pdfdancer_client_python-0.2.9}/src/pdfdancer/paragraph_builder.py

@@ -268,3 +268,14 @@ class ParagraphBuilder:
 
     def add(self):
         self._client._add_paragraph(self.build())
+
+
+class ParagraphPageBuilder(ParagraphBuilder):
+
+    def __init__(self, client: 'PDFDancer', page_index: int):
+        super().__init__(client)
+        self._page_index: Optional[int] = page_index
+
+    # noinspection PyMethodOverriding
+    def at(self, x: float, y: float) -> 'ParagraphBuilder':
+        return super().at(self._page_index, x, y)

{pdfdancer_client_python-0.2.7 → pdfdancer_client_python-0.2.9}/src/pdfdancer/pdfdancer_v1.py

@@ -26,6 +26,7 @@ from .models import (
     FindRequest, DeleteRequest, MoveRequest, AddRequest, ModifyRequest, ModifyTextRequest, ChangeFormFieldRequest,
     ShapeType, PositionMode
 )
+from .paragraph_builder import ParagraphPageBuilder
 from .types import PathObject, ParagraphObject, TextLineObject, ImageObject, FormObject, FormFieldObject
 
 
@@ -114,6 +115,9 @@ class PageClient:
     def _ref(self):
         return ObjectRef(internal_id=self.internal_id, position=self.position, type=self.object_type)
 
+    def new_paragraph(self):
+        return ParagraphPageBuilder(self.root, self.page_index)
+
 
 class PDFDancer:
     """
@@ -779,7 +783,7 @@ class PDFDancer:
 
     # Document Operations
 
-    def get_pdf_file(self) -> bytes:
+    def get_bytes(self) -> bytes:
         """
         Downloads the current state of the PDF document with all modifications applied.
 
@@ -804,7 +808,7 @@ class PDFDancer:
             raise ValidationException("File path cannot be null or empty")
 
         try:
-            pdf_data = self.get_pdf_file()
+            pdf_data = self.get_bytes()
             output_path = Path(file_path)
 
             # Create parent directories if they don't exist

{pdfdancer_client_python-0.2.7 → pdfdancer_client_python-0.2.9/src/pdfdancer_client_python.egg-info}/PKG-INFO

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

{pdfdancer_client_python-0.2.7 → pdfdancer_client_python-0.2.9}/src/pdfdancer_client_python.egg-info/SOURCES.txt

@@ -21,7 +21,6 @@ src/pdfdancer_client_python.egg-info/requires.txt
 src/pdfdancer_client_python.egg-info/top_level.txt
 tests/__init__.py
 tests/conftest.py
-tests/test_authentication.py
 tests/test_models.py
 tests/test_openapi_compliance.py
 tests/e2e/__init__.py
@@ -32,6 +31,7 @@ tests/e2e/test_line.py
 tests/e2e/test_page.py
 tests/e2e/test_paragraph.py
 tests/e2e/test_path.py
+tests/e2e/test_pdfdancer.py
 tests/fixtures/DancingScript-Regular.ttf
 tests/fixtures/JetBrainsMono-Regular.ttf
 tests/fixtures/ObviouslyAwesome.pdf

{pdfdancer_client_python-0.2.7 → pdfdancer_client_python-0.2.9}/tests/e2e/test_paragraph.py

@@ -116,6 +116,19 @@ def test_add_paragraph_with_custom_font1_1():
         _assert_new_paragraph_exists(pdf)
 
 
+def test_add_paragraph_on_page_with_custom_font1_1():
+    base_url, token, pdf_path = _require_env_and_fixture("ObviouslyAwesome.pdf")
+
+    with PDFDancer.open(pdf_path, token=token, base_url=base_url, timeout=30.0) as pdf:
+        pdf.page(0).new_paragraph() \
+            .text("Awesomely\nObvious!") \
+            .font("Roboto-Regular", 14) \
+            .line_spacing(0.7) \
+            .at(300.1, 500) \
+            .add()
+        _assert_new_paragraph_exists(pdf)
+
+
 def test_add_paragraph_with_custom_font1_2():
     base_url, token, pdf_path = _require_env_and_fixture("ObviouslyAwesome.pdf")
 
@@ -161,7 +174,7 @@ def test_add_paragraph_with_custom_font3():
     with PDFDancer.open(pdf_path, token=token, base_url=base_url, timeout=30.0) as pdf:
         pdf.new_paragraph() \
             .text("Awesomely\nObvious!") \
-            .font_file(str(ttf_path), 24) \
+            .font_file(ttf_path, 24) \
             .line_spacing(1.8) \
             .color(Color(0, 0, 255)) \
             .at(0, 300.1, 500) \

pdfdancer_client_python-0.2.9/tests/e2e/test_pdfdancer.py

@@ -0,0 +1,33 @@
+import os
+
+import pytest
+
+from tests.e2e import _require_env_and_fixture
+from pdfdancer import PDFDancer, ValidationException, HttpClientException
+
+
+def test_env_vars():
+    base_url, _, pdf_path = _require_env_and_fixture("ObviouslyAwesome.pdf")
+    os.environ.pop("PDFDANCER_TOKEN", None)
+
+    with pytest.raises(ValidationException) as exc_info:
+        with PDFDancer.open(pdf_path, base_url=base_url) as pdf:
+            pass
+    assert "Missing PDFDancer API token. Pass a token via the `token` argument or set the PDFDANCER_TOKEN environment variable." == str(
+        exc_info.value)
+
+    os.environ["PDFDANCER_TOKEN"] = "42"
+    with PDFDancer.open(pdf_path, base_url=base_url) as pdf:
+        pass
+
+    os.environ["PDFDANCER_BASE_URL"] = "http://www.google.com"
+    with pytest.raises(HttpClientException) as exc_info:
+        with PDFDancer.open(pdf_path) as pdf:
+            pass
+
+    os.environ["PDFDANCER_BASE_URL"] = "https://api.pdfdancer.com"
+    with pytest.raises(ValidationException) as exc_info:
+        with PDFDancer.open(pdf_path) as pdf:
+            pass
+    assert "Authentication with the PDFDancer API failed. Confirm that your API token is valid, has not expired" in str(
+        exc_info.value)

pdfdancer_client_python-0.2.7/tests/test_authentication.py

@@ -1,36 +0,0 @@
-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