tests: enumerate live blank-pdf literals for sync and async

- Add a shared literal case matrix to live blank-pdf tests covering all accepted
page_size values, both page_orientation literals, and custom dimensions.
- Keep explicit invalid extra_body overrides for both transports to verify server
errors on unsupported page_size values.

Assisted-by: Codex

Author: datalogics-cgreen

tests/live/test_live_blank_pdf.py

@@ -4,26 +4,90 @@
 
 from pdfrest import AsyncPdfRestClient, PdfRestApiError, PdfRestClient
 
+BLANK_PDF_LITERAL_CASES = [
+    pytest.param(
+        "letter",
+        "portrait",
+        None,
+        None,
+        "blank-letter",
+        id="letter-portrait",
+    ),
+    pytest.param(
+        "legal",
+        "landscape",
+        None,
+        None,
+        "blank-legal",
+        id="legal-landscape",
+    ),
+    pytest.param(
+        "ledger",
+        "portrait",
+        None,
+        None,
+        "blank-ledger",
+        id="ledger-portrait",
+    ),
+    pytest.param(
+        "A3",
+        "landscape",
+        None,
+        None,
+        "blank-a3",
+        id="a3-landscape",
+    ),
+    pytest.param(
+        "A4",
+        "portrait",
+        None,
+        None,
+        "blank-a4",
+        id="a4-portrait",
+    ),
+    pytest.param(
+        "A5",
+        "landscape",
+        None,
+        None,
+        "blank-a5",
+        id="a5-landscape",
+    ),
+    pytest.param(
+        "custom",
+        None,
+        792.0,
+        612.0,
+        "blank-custom",
+        id="custom-dimensions",
+    ),
+]
+
 
 @pytest.mark.parametrize(
-    "output_name",
-    [
-        pytest.param(None, id="default-output"),
-        pytest.param("blank-doc", id="custom-output"),
-    ],
+    ("page_size", "page_orientation", "custom_height", "custom_width", "output_name"),
+    BLANK_PDF_LITERAL_CASES,
 )
 def test_live_blank_pdf_success(
     pdfrest_api_key: str,
     pdfrest_live_base_url: str,
-    output_name: str | None,
+    page_size: str,
+    page_orientation: str | None,
+    custom_height: float | None,
+    custom_width: float | None,
+    output_name: str,
 ) -> None:
-    kwargs: dict[str, str | int] = {
-        "page_size": "letter",
+    kwargs: dict[str, str | int | float] = {
+        "page_size": page_size,
         "page_count": 1,
-        "page_orientation": "portrait",
+        "output": output_name,
     }
-    if output_name is not None:
-        kwargs["output"] = output_name
+    if page_orientation is not None:
+        kwargs["page_orientation"] = page_orientation
+    if custom_height is not None:
+        kwargs["custom_height"] = custom_height
+    if custom_width is not None:
+        kwargs["custom_width"] = custom_width
 
     with PdfRestClient(
         api_key=pdfrest_api_key,
@@ -36,31 +100,44 @@ def test_live_blank_pdf_success(
     assert output_file.type == "application/pdf"
     assert output_file.size > 0
     assert response.warning is None
-    if output_name is not None:
-        assert output_file.name.startswith(output_name)
-    else:
-        assert output_file.name.endswith(".pdf")
+    assert output_file.name.startswith(output_name)
 
 
 @pytest.mark.asyncio
+@pytest.mark.parametrize(
+    ("page_size", "page_orientation", "custom_height", "custom_width", "output_name"),
+    BLANK_PDF_LITERAL_CASES,
+)
 async def test_live_async_blank_pdf_success(
     pdfrest_api_key: str,
     pdfrest_live_base_url: str,
+    page_size: str,
+    page_orientation: str | None,
+    custom_height: float | None,
+    custom_width: float | None,
+    output_name: str,
 ) -> None:
+    kwargs: dict[str, str | int | float] = {
+        "page_size": page_size,
+        "page_count": 2,
+        "output": output_name,
+    }
+    if page_orientation is not None:
+        kwargs["page_orientation"] = page_orientation
+    if custom_height is not None:
+        kwargs["custom_height"] = custom_height
+    if custom_width is not None:
+        kwargs["custom_width"] = custom_width
+
     async with AsyncPdfRestClient(
         api_key=pdfrest_api_key,
         base_url=pdfrest_live_base_url,
     ) as client:
-        response = await client.blank_pdf(
-            page_size="A4",
-            page_count=2,
-            page_orientation="landscape",
-            output="async-blank",
-        )
+        response = await client.blank_pdf(**kwargs)
 
     assert response.output_files
     output_file = response.output_file
-    assert output_file.name.startswith("async-blank")
+    assert output_file.name.startswith(output_name)
     assert output_file.type == "application/pdf"
     assert output_file.size > 0
     assert response.warning is None