tests: Add live tests for PDF/X, Word, and form flattening

- Added `test_live_convert_to_pdfx.py` to test PDF to PDF/X conversion
  with valid and invalid output types.
- Added `test_live_convert_to_word.py` to test PDF to Word conversion
  with support for custom and default output names.
- Added `test_live_flatten_pdf_forms.py` to test flattening of PDF forms
  with validation for custom and default output names.
- Introduced new test resource file: `form_with_data.pdf`.

Assisted-by: Codex

Author: datalogics-kam

tests/live/test_live_convert_to_pdfx.py

@@ -0,0 +1,78 @@
+from __future__ import annotations
+
+from typing import cast, get_args
+
+import pytest
+
+from pdfrest import PdfRestApiError, PdfRestClient
+from pdfrest.models import PdfRestFile
+from pdfrest.types import PdfXType
+
+from ..resources import get_test_resource_path
+
+PDFX_TYPES: tuple[PdfXType, ...] = cast(tuple[PdfXType, ...], get_args(PdfXType))
+
+
+@pytest.fixture(scope="module")
+def uploaded_pdf_for_pdfx(
+    pdfrest_api_key: str,
+    pdfrest_live_base_url: str,
+) -> PdfRestFile:
+    resource = get_test_resource_path("report.pdf")
+    with PdfRestClient(
+        api_key=pdfrest_api_key,
+        base_url=pdfrest_live_base_url,
+    ) as client:
+        return client.files.create_from_paths([resource])[0]
+
+
+@pytest.mark.parametrize("output_type", PDFX_TYPES, ids=list(PDFX_TYPES))
+def test_live_convert_to_pdfx_success(
+    pdfrest_api_key: str,
+    pdfrest_live_base_url: str,
+    uploaded_pdf_for_pdfx: PdfRestFile,
+    output_type: PdfXType,
+) -> None:
+    with PdfRestClient(
+        api_key=pdfrest_api_key,
+        base_url=pdfrest_live_base_url,
+    ) as client:
+        response = client.convert_to_pdfx(
+            uploaded_pdf_for_pdfx,
+            output_type=output_type,
+            output="pdfx-live",
+        )
+
+    assert response.output_files
+    output_file = response.output_file
+    assert output_file.type == "application/pdf"
+    assert str(response.input_id) == str(uploaded_pdf_for_pdfx.id)
+    assert output_file.name.startswith("pdfx-live")
+
+
+@pytest.mark.parametrize(
+    "invalid_output_type",
+    [
+        pytest.param("PDF/X-0", id="pdfx-0"),
+        pytest.param("PDF/X-99", id="pdfx-99"),
+        pytest.param("pdf/x-4", id="lowercase"),
+    ],
+)
+def test_live_convert_to_pdfx_invalid_output_type(
+    pdfrest_api_key: str,
+    pdfrest_live_base_url: str,
+    uploaded_pdf_for_pdfx: PdfRestFile,
+    invalid_output_type: str,
+) -> None:
+    with (
+        PdfRestClient(
+            api_key=pdfrest_api_key,
+            base_url=pdfrest_live_base_url,
+        ) as client,
+        pytest.raises(PdfRestApiError),
+    ):
+        client.convert_to_pdfx(
+            uploaded_pdf_for_pdfx,
+            output_type="PDF/X-1a",
+            extra_body={"output_type": invalid_output_type},
+        )

tests/live/test_live_convert_to_word.py

@@ -0,0 +1,75 @@
+from __future__ import annotations
+
+import pytest
+
+from pdfrest import PdfRestApiError, PdfRestClient
+from pdfrest.models import PdfRestFile
+
+from ..resources import get_test_resource_path
+
+
+@pytest.fixture(scope="module")
+def uploaded_pdf_for_word(
+    pdfrest_api_key: str,
+    pdfrest_live_base_url: str,
+) -> PdfRestFile:
+    resource = get_test_resource_path("report.pdf")
+    with PdfRestClient(
+        api_key=pdfrest_api_key,
+        base_url=pdfrest_live_base_url,
+    ) as client:
+        return client.files.create_from_paths([resource])[0]
+
+
+@pytest.mark.parametrize(
+    "output_name",
+    [
+        pytest.param(None, id="default-output"),
+        pytest.param("live-word", id="custom-output"),
+    ],
+)
+def test_live_convert_to_word_success(
+    pdfrest_api_key: str,
+    pdfrest_live_base_url: str,
+    uploaded_pdf_for_word: PdfRestFile,
+    output_name: str | None,
+) -> None:
+    kwargs: dict[str, str] = {}
+    if output_name is not None:
+        kwargs["output"] = output_name
+
+    with PdfRestClient(
+        api_key=pdfrest_api_key,
+        base_url=pdfrest_live_base_url,
+    ) as client:
+        response = client.convert_to_word(uploaded_pdf_for_word, **kwargs)
+
+    assert response.output_files
+    output_file = response.output_file
+    assert (
+        output_file.type
+        == "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
+    )
+    assert str(response.input_id) == str(uploaded_pdf_for_word.id)
+    if output_name is not None:
+        assert output_file.name.startswith(output_name)
+    else:
+        assert output_file.name.endswith(".docx")
+
+
+def test_live_convert_to_word_invalid_file_id(
+    pdfrest_api_key: str,
+    pdfrest_live_base_url: str,
+    uploaded_pdf_for_word: PdfRestFile,
+) -> None:
+    with (
+        PdfRestClient(
+            api_key=pdfrest_api_key,
+            base_url=pdfrest_live_base_url,
+        ) as client,
+        pytest.raises(PdfRestApiError),
+    ):
+        client.convert_to_word(
+            uploaded_pdf_for_word,
+            extra_body={"id": "00000000-0000-0000-0000-000000000000"},
+        )

tests/live/test_live_flatten_pdf_forms.py

@@ -0,0 +1,72 @@
+from __future__ import annotations
+
+import pytest
+
+from pdfrest import PdfRestApiError, PdfRestClient
+from pdfrest.models import PdfRestFile
+
+from ..resources import get_test_resource_path
+
+
+@pytest.fixture(scope="module")
+def uploaded_pdf_with_forms(
+    pdfrest_api_key: str,
+    pdfrest_live_base_url: str,
+) -> PdfRestFile:
+    resource = get_test_resource_path("form_with_data.pdf")
+    with PdfRestClient(
+        api_key=pdfrest_api_key,
+        base_url=pdfrest_live_base_url,
+    ) as client:
+        return client.files.create_from_paths([resource])[0]
+
+
+@pytest.mark.parametrize(
+    "output_name",
+    [
+        pytest.param(None, id="default-output"),
+        pytest.param("flattened-live", id="custom-output"),
+    ],
+)
+def test_live_flatten_pdf_forms(
+    pdfrest_api_key: str,
+    pdfrest_live_base_url: str,
+    uploaded_pdf_with_forms: PdfRestFile,
+    output_name: str | None,
+) -> None:
+    kwargs: dict[str, str] = {}
+    if output_name is not None:
+        kwargs["output"] = output_name
+
+    with PdfRestClient(
+        api_key=pdfrest_api_key,
+        base_url=pdfrest_live_base_url,
+    ) as client:
+        response = client.flatten_pdf_forms(uploaded_pdf_with_forms, **kwargs)
+
+    assert response.output_files
+    output_file = response.output_file
+    assert output_file.type == "application/pdf"
+    assert str(response.input_id) == str(uploaded_pdf_with_forms.id)
+    if output_name is not None:
+        assert output_file.name.startswith(output_name)
+    else:
+        assert output_file.name.endswith(".pdf")
+
+
+def test_live_flatten_pdf_forms_invalid_file_id(
+    pdfrest_api_key: str,
+    pdfrest_live_base_url: str,
+    uploaded_pdf_with_forms: PdfRestFile,
+) -> None:
+    with (
+        PdfRestClient(
+            api_key=pdfrest_api_key,
+            base_url=pdfrest_live_base_url,
+        ) as client,
+        pytest.raises(PdfRestApiError),
+    ):
+        client.flatten_pdf_forms(
+            uploaded_pdf_with_forms,
+            extra_body={"id": "ffffffff-ffff-ffff-ffff-ffffffffffff"},
+        )