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

{pdfdancer_client_python-0.2.3 → 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.3/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.3
+Version: 0.2.4
 Summary: Python client for PDFDancer API
 Author-email: "The Famous Cat Ltd." <hi@thefamouscat.com>
 License: MIT

{pdfdancer_client_python-0.2.3 → 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.3"
+version = "0.2.4"
 description = "Python client for PDFDancer API"
 readme = "README.md"
 authors = [

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

@@ -138,6 +138,12 @@ class PDFDancer:
             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:
@@ -259,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.
@@ -274,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()
 
@@ -283,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
@@ -316,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

{pdfdancer_client_python-0.2.3 → 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.3
+Version: 0.2.4
 Summary: Python client for PDFDancer API
 Author-email: "The Famous Cat Ltd." <hi@thefamouscat.com>
 License: MIT

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

@@ -20,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