pdfdancer-client-python 0.3.4__tar.gz → 0.3.5__tar.gz

{pdfdancer_client_python-0.3.4 → pdfdancer_client_python-0.3.5}/CLAUDE.md

@@ -95,7 +95,7 @@ pdf.save("output.pdf")
 ### Initialization
 
 ```python
-# Open existing PDF with token from env var PDFDANCER_TOKEN
+# Open existing PDF with token from env var PDFDANCER_API_TOKEN
 pdf = PDFDancer.open(pdf_data="document.pdf")
 
 # Open with explicit token

{pdfdancer_client_python-0.3.4 → pdfdancer_client_python-0.3.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pdfdancer-client-python
-Version: 0.3.4
+Version: 0.3.5
 Summary: Python client for PDFDancer API
 Author-email: "The Famous Cat Ltd." <hi@thefamouscat.com>
 License: 
@@ -289,7 +289,7 @@ from pdfdancer import Color, PDFDancer, StandardFonts
 
 with PDFDancer.open(
     pdf_data=Path("input.pdf"),
-    token="your-api-token",             # optional when PDFDANCER_TOKEN is set
+    token="your-api-token",             # optional when PDFDANCER_API_TOKEN is set
     base_url="https://api.pdfdancer.com",
 ) as pdf:
     # Locate and update an existing paragraph
@@ -443,7 +443,7 @@ with PDFDancer.open("confidential.pdf") as pdf:
 
 ## Configuration
 
-- Set `PDFDANCER_TOKEN` for authentication (preferred for local development and CI).
+- Set `PDFDANCER_API_TOKEN` for authentication (preferred). `PDFDANCER_TOKEN` is also supported for backwards compatibility.
 - Override the API host with `PDFDANCER_BASE_URL` (e.g., sandbox or local environments). Defaults to `https://api.pdfdancer.com`.
 - Tune HTTP read timeouts via the `timeout` argument on `PDFDancer.open()` and `PDFDancer.new()` (default: 30 seconds).
 - For testing against self-signed certificates, call `pdfdancer.set_ssl_verify(False)` to temporarily disable TLS verification.
@@ -513,13 +513,13 @@ Set your PDFDancer API token as an environment variable:
 
 ```bash
 # On macOS/Linux:
-export PDFDANCER_TOKEN="your-api-token-here"
+export PDFDANCER_API_TOKEN="your-api-token-here"
 
 # On Windows (Command Prompt):
-set PDFDANCER_TOKEN=your-api-token-here
+set PDFDANCER_API_TOKEN=your-api-token-here
 
 # On Windows (PowerShell):
-$env:PDFDANCER_TOKEN="your-api-token-here"
+$env:PDFDANCER_API_TOKEN="your-api-token-here"
 ```
 
 For permanent configuration, add this to your shell profile (`~/.bashrc`, `~/.zshrc`, etc.).
@@ -651,7 +651,7 @@ pip install -e .
 
 #### Test Failures
 
-- Ensure `PDFDANCER_TOKEN` is set for e2e tests
+- Ensure `PDFDANCER_API_TOKEN` is set for e2e tests
 - Check network connectivity to the PDFDancer API
 - Verify you're using Python 3.10 or higher
 

{pdfdancer_client_python-0.3.4 → pdfdancer_client_python-0.3.5}/README.md

@@ -50,7 +50,7 @@ from pdfdancer import Color, PDFDancer, StandardFonts
 
 with PDFDancer.open(
     pdf_data=Path("input.pdf"),
-    token="your-api-token",             # optional when PDFDANCER_TOKEN is set
+    token="your-api-token",             # optional when PDFDANCER_API_TOKEN is set
     base_url="https://api.pdfdancer.com",
 ) as pdf:
     # Locate and update an existing paragraph
@@ -204,7 +204,7 @@ with PDFDancer.open("confidential.pdf") as pdf:
 
 ## Configuration
 
-- Set `PDFDANCER_TOKEN` for authentication (preferred for local development and CI).
+- Set `PDFDANCER_API_TOKEN` for authentication (preferred). `PDFDANCER_TOKEN` is also supported for backwards compatibility.
 - Override the API host with `PDFDANCER_BASE_URL` (e.g., sandbox or local environments). Defaults to `https://api.pdfdancer.com`.
 - Tune HTTP read timeouts via the `timeout` argument on `PDFDancer.open()` and `PDFDancer.new()` (default: 30 seconds).
 - For testing against self-signed certificates, call `pdfdancer.set_ssl_verify(False)` to temporarily disable TLS verification.
@@ -274,13 +274,13 @@ Set your PDFDancer API token as an environment variable:
 
 ```bash
 # On macOS/Linux:
-export PDFDANCER_TOKEN="your-api-token-here"
+export PDFDANCER_API_TOKEN="your-api-token-here"
 
 # On Windows (Command Prompt):
-set PDFDANCER_TOKEN=your-api-token-here
+set PDFDANCER_API_TOKEN=your-api-token-here
 
 # On Windows (PowerShell):
-$env:PDFDANCER_TOKEN="your-api-token-here"
+$env:PDFDANCER_API_TOKEN="your-api-token-here"
 ```
 
 For permanent configuration, add this to your shell profile (`~/.bashrc`, `~/.zshrc`, etc.).
@@ -412,7 +412,7 @@ pip install -e .
 
 #### Test Failures
 
-- Ensure `PDFDANCER_TOKEN` is set for e2e tests
+- Ensure `PDFDANCER_API_TOKEN` is set for e2e tests
 - Check network connectivity to the PDFDancer API
 - Verify you're using Python 3.10 or higher
 

{pdfdancer_client_python-0.3.4 → pdfdancer_client_python-0.3.5}/pyproject.toml

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

{pdfdancer_client_python-0.3.4 → pdfdancer_client_python-0.3.5}/src/pdfdancer/pdfdancer_v1.py

@@ -690,13 +690,14 @@ class PDFDancer:
 
         Authentication:
         - If token is provided, uses it
-        - Otherwise, checks PDFDANCER_TOKEN environment variable
+        - Otherwise, checks PDFDANCER_API_TOKEN environment variable (preferred)
+        - Falls back to PDFDANCER_TOKEN environment variable (legacy)
         - If no token is found, automatically obtains an anonymous token
 
         Args:
             pdf_data: PDF payload supplied directly or via filesystem handles.
-            token: Override for the API token; falls back to `PDFDANCER_TOKEN` environment variable,
-                then to anonymous token if not set.
+            token: Override for the API token; falls back to `PDFDANCER_API_TOKEN` or
+                `PDFDANCER_TOKEN` environment variable, then to anonymous token if not set.
             base_url: Override for the API base URL; falls back to `PDFDANCER_BASE_URL`
                 or defaults to `https://api.pdfdancer.com`.
             timeout: HTTP read timeout in seconds.
@@ -856,10 +857,15 @@ class PDFDancer:
         """
         Resolve token from argument or environment variable.
         Returns None if no token is found (allowing fallback to anonymous token).
+
+        Checks environment variables in order:
+        1. PDFDANCER_API_TOKEN (preferred)
+        2. PDFDANCER_TOKEN (legacy)
         """
         resolved_token = token.strip() if token and token.strip() else None
         if resolved_token is None:
-            env_token = os.getenv("PDFDANCER_TOKEN")
+            # Check PDFDANCER_API_TOKEN first (preferred), then PDFDANCER_TOKEN (legacy)
+            env_token = os.getenv("PDFDANCER_API_TOKEN") or os.getenv("PDFDANCER_TOKEN")
             resolved_token = (
                 env_token.strip() if env_token and env_token.strip() else None
             )
@@ -882,12 +888,13 @@ class PDFDancer:
 
         Authentication:
         - If token is provided, uses it
-        - Otherwise, checks PDFDANCER_TOKEN environment variable
+        - Otherwise, checks PDFDANCER_API_TOKEN environment variable (preferred)
+        - Falls back to PDFDANCER_TOKEN environment variable (legacy)
         - If no token is found, automatically obtains an anonymous token
 
         Args:
-            token: Override for the API token; falls back to `PDFDANCER_TOKEN` environment variable,
-                then to anonymous token if not set.
+            token: Override for the API token; falls back to `PDFDANCER_API_TOKEN` or
+                `PDFDANCER_TOKEN` environment variable, then to anonymous token if not set.
             base_url: Override for the API base URL; falls back to `PDFDANCER_BASE_URL`
                 or defaults to `https://api.pdfdancer.com`.
             timeout: HTTP read timeout in seconds.
@@ -1101,7 +1108,7 @@ class PDFDancer:
             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. "
+                "the `token` argument or the PDFDANCER_API_TOKEN environment variable. "
                 f"Server response: {details}"
             )
 

{pdfdancer_client_python-0.3.4 → pdfdancer_client_python-0.3.5}/src/pdfdancer_client_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pdfdancer-client-python
-Version: 0.3.4
+Version: 0.3.5
 Summary: Python client for PDFDancer API
 Author-email: "The Famous Cat Ltd." <hi@thefamouscat.com>
 License: 
@@ -289,7 +289,7 @@ from pdfdancer import Color, PDFDancer, StandardFonts
 
 with PDFDancer.open(
     pdf_data=Path("input.pdf"),
-    token="your-api-token",             # optional when PDFDANCER_TOKEN is set
+    token="your-api-token",             # optional when PDFDANCER_API_TOKEN is set
     base_url="https://api.pdfdancer.com",
 ) as pdf:
     # Locate and update an existing paragraph
@@ -443,7 +443,7 @@ with PDFDancer.open("confidential.pdf") as pdf:
 
 ## Configuration
 
-- Set `PDFDANCER_TOKEN` for authentication (preferred for local development and CI).
+- Set `PDFDANCER_API_TOKEN` for authentication (preferred). `PDFDANCER_TOKEN` is also supported for backwards compatibility.
 - Override the API host with `PDFDANCER_BASE_URL` (e.g., sandbox or local environments). Defaults to `https://api.pdfdancer.com`.
 - Tune HTTP read timeouts via the `timeout` argument on `PDFDancer.open()` and `PDFDancer.new()` (default: 30 seconds).
 - For testing against self-signed certificates, call `pdfdancer.set_ssl_verify(False)` to temporarily disable TLS verification.
@@ -513,13 +513,13 @@ Set your PDFDancer API token as an environment variable:
 
 ```bash
 # On macOS/Linux:
-export PDFDANCER_TOKEN="your-api-token-here"
+export PDFDANCER_API_TOKEN="your-api-token-here"
 
 # On Windows (Command Prompt):
-set PDFDANCER_TOKEN=your-api-token-here
+set PDFDANCER_API_TOKEN=your-api-token-here
 
 # On Windows (PowerShell):
-$env:PDFDANCER_TOKEN="your-api-token-here"
+$env:PDFDANCER_API_TOKEN="your-api-token-here"
 ```
 
 For permanent configuration, add this to your shell profile (`~/.bashrc`, `~/.zshrc`, etc.).
@@ -651,7 +651,7 @@ pip install -e .
 
 #### Test Failures
 
-- Ensure `PDFDANCER_TOKEN` is set for e2e tests
+- Ensure `PDFDANCER_API_TOKEN` is set for e2e tests
 - Check network connectivity to the PDFDancer API
 - Verify you're using Python 3.10 or higher
 

{pdfdancer_client_python-0.3.4 → pdfdancer_client_python-0.3.5}/test.sh

@@ -162,7 +162,8 @@ LONG OPTIONS (use either format):
     --help                Show this help message
 
 ENVIRONMENT:
-    PDFDANCER_TOKEN        Token if --token/-t not provided
+    PDFDANCER_API_TOKEN    Token if --token/-t not provided (preferred)
+    PDFDANCER_TOKEN        Token if --token/-t not provided (legacy fallback)
 
 SERVER URL FORMATS:
     localhost:8080                  Hostname with port (auto-detects https)
@@ -300,8 +301,11 @@ validate_args() {
     fi
     
     # Check for token (optional - use from args or environment)
+    # Priority: --token arg > PDFDANCER_API_TOKEN > PDFDANCER_TOKEN
     if [[ -z "$TOKEN" ]]; then
-        if [[ -n "${PDFDANCER_TOKEN:-}" ]]; then
+        if [[ -n "${PDFDANCER_API_TOKEN:-}" ]]; then
+            TOKEN="$PDFDANCER_API_TOKEN"
+        elif [[ -n "${PDFDANCER_TOKEN:-}" ]]; then
             TOKEN="$PDFDANCER_TOKEN"
         else
             TOKEN=""
@@ -374,7 +378,7 @@ run_pytest_with_gnu_parallel() {
     echo "   • Use -S/--stdout for live logs"
 
     # Set environment variables for this test run
-    export PDFDANCER_TOKEN="$TOKEN"
+    export PDFDANCER_API_TOKEN="$TOKEN"
     export PDFDANCER_BASE_URL="$server_url"
 
     # Get list of test files to distribute across workers
@@ -431,11 +435,11 @@ run_pytest_on_server() {
     log_message "$server" "Starting pytest with $PARALLEL workers"
     log_message "$server" "Server URL: $server_url"
     log_message "$server" "Pytest args: ${PYTEST_ARGS[*]:-tests/ -v}"
-    
+
     # Set environment variables for this test run
-    export PDFDANCER_TOKEN="$TOKEN"
+    export PDFDANCER_API_TOKEN="$TOKEN"
     export PDFDANCER_BASE_URL="$server_url"
-    
+
     # Determine python executable (prefer venv if available)
     local python_cmd="${PYTHON_CMD:-python}"
 

{pdfdancer_client_python-0.3.4 → pdfdancer_client_python-0.3.5}/tests/e2e/__init__.py

@@ -11,7 +11,8 @@ def _get_base_url():
 
 
 def _read_token() -> str | None:
-    token = os.getenv("PDFDANCER_TOKEN")
+    # Check PDFDANCER_API_TOKEN first (preferred), then PDFDANCER_TOKEN (legacy)
+    token = os.getenv("PDFDANCER_API_TOKEN") or os.getenv("PDFDANCER_TOKEN")
     if token:
         return token.strip()
     # Try common token files in repo
@@ -53,6 +54,6 @@ def _require_env() -> tuple[str, str | None]:
         )
     if not token:
         pytest.fail(
-            "PDFDANCER_TOKEN not set and no token file found; set env or place jwt-token-*.txt in repo"
+            "PDFDANCER_API_TOKEN not set and no token file found; set env or place jwt-token-*.txt in repo"
         )
     return base_url, token

{pdfdancer_client_python-0.3.4 → pdfdancer_client_python-0.3.5}/tests/e2e/test_pdfdancer.py

@@ -9,19 +9,21 @@ from tests.e2e import _require_env_and_fixture
 def test_env_vars():
     base_url, _, pdf_path = _require_env_and_fixture("Showcase.pdf")
     original_base_url_env = os.environ.get("PDFDANCER_BASE_URL")
+    original_api_token_env = os.environ.get("PDFDANCER_API_TOKEN")
     original_token_env = os.environ.get("PDFDANCER_TOKEN")
     try:
+        os.environ.pop("PDFDANCER_API_TOKEN", None)
         os.environ.pop("PDFDANCER_TOKEN", None)
 
         # With the anonymous token fallback, opening without a token should now succeed
         # (it will automatically obtain an anonymous token)
-        # This test now verifies that the client works without PDFDANCER_TOKEN set
+        # This test now verifies that the client works without PDFDANCER_API_TOKEN set
         with PDFDancer.open(pdf_path, base_url=base_url) as pdf:
             # Verify we got a valid session
             assert pdf._session_id is not None
             assert pdf._token is not None  # Should have obtained an anonymous token
 
-        os.environ["PDFDANCER_TOKEN"] = "42"
+        os.environ["PDFDANCER_API_TOKEN"] = "42"
         with PDFDancer.open(pdf_path, base_url=base_url) as pdf:
             pass
 
@@ -43,6 +45,10 @@ def test_env_vars():
             os.environ["PDFDANCER_BASE_URL"] = original_base_url_env
         elif "PDFDANCER_BASE_URL" in os.environ:
             del os.environ["PDFDANCER_BASE_URL"]
+        if original_api_token_env is not None:
+            os.environ["PDFDANCER_API_TOKEN"] = original_api_token_env
+        elif "PDFDANCER_API_TOKEN" in os.environ:
+            del os.environ["PDFDANCER_API_TOKEN"]
         if original_token_env is not None:
             os.environ["PDFDANCER_TOKEN"] = original_token_env
         elif "PDFDANCER_TOKEN" in os.environ:

{pdfdancer_client_python-0.3.4 → pdfdancer_client_python-0.3.5}/tests/test_anonymous_token.py

@@ -2,8 +2,8 @@
 Tests for anonymous token fallback functionality.
 
 These tests verify that the PDFDancer client can automatically obtain
-anonymous tokens when no PDFDANCER_TOKEN is provided, matching the
-behavior of the Java client.
+anonymous tokens when no PDFDANCER_API_TOKEN or PDFDANCER_TOKEN is provided,
+matching the behavior of the Java client.
 """
 
 import os
@@ -16,7 +16,7 @@ from pdfdancer.exceptions import HttpClientException
 
 
 class TestAnonymousTokenFallback:
-    """Test anonymous token fallback when PDFDANCER_TOKEN is not set."""
+    """Test anonymous token fallback when PDFDANCER_API_TOKEN or PDFDANCER_TOKEN is not set."""
 
     @pytest.fixture
     def mock_httpx_client(self):
@@ -28,13 +28,18 @@ class TestAnonymousTokenFallback:
 
     @pytest.fixture
     def clear_env_token(self):
-        """Temporarily clear PDFDANCER_TOKEN from environment."""
+        """Temporarily clear PDFDANCER_TOKEN and PDFDANCER_API_TOKEN from environment."""
         original_token = os.environ.get("PDFDANCER_TOKEN")
+        original_api_token = os.environ.get("PDFDANCER_API_TOKEN")
         if "PDFDANCER_TOKEN" in os.environ:
             del os.environ["PDFDANCER_TOKEN"]
+        if "PDFDANCER_API_TOKEN" in os.environ:
+            del os.environ["PDFDANCER_API_TOKEN"]
         yield
         if original_token is not None:
             os.environ["PDFDANCER_TOKEN"] = original_token
+        if original_api_token is not None:
+            os.environ["PDFDANCER_API_TOKEN"] = original_api_token
 
     def test_resolve_token_returns_none_when_no_token(self, clear_env_token):
         """Test that _resolve_token returns None when no token is available."""
@@ -49,10 +54,25 @@ class TestAnonymousTokenFallback:
 
     def test_resolve_token_uses_env_token(self):
         """Test that _resolve_token uses PDFDANCER_TOKEN from environment."""
-        with patch.dict(os.environ, {"PDFDANCER_TOKEN": "env-token-456"}):
+        with patch.dict(os.environ, {"PDFDANCER_TOKEN": "env-token-456"}, clear=True):
             result = PDFDancer._resolve_token(None)
             assert result == "env-token-456"
 
+    def test_resolve_token_uses_api_token_env_var(self):
+        """Test that _resolve_token uses PDFDANCER_API_TOKEN from environment."""
+        with patch.dict(os.environ, {"PDFDANCER_API_TOKEN": "api-token-789"}, clear=True):
+            result = PDFDancer._resolve_token(None)
+            assert result == "api-token-789"
+
+    def test_resolve_token_prefers_api_token_over_legacy_token(self):
+        """Test that PDFDANCER_API_TOKEN takes precedence over PDFDANCER_TOKEN."""
+        with patch.dict(
+            os.environ,
+            {"PDFDANCER_API_TOKEN": "api-token", "PDFDANCER_TOKEN": "legacy-token"},
+        ):
+            result = PDFDancer._resolve_token(None)
+            assert result == "api-token"
+
     def test_resolve_token_prefers_explicit_over_env(self):
         """Test that explicit token takes precedence over environment variable."""
         with patch.dict(os.environ, {"PDFDANCER_TOKEN": "env-token"}):