delete: Add examples for file deletion using Python 3.10 and 3.11

- Introduced `delete_example.py` showcasing async file deletion with pdfRest:
  - A Python 3.11 version using `except*` syntax for exception groups.
  - A Python 3.10 version leveraging the `exceptiongroup` backport.
- Updated `pyproject.toml`, `uv.lock`, and `pyrightconfig.json` to include
  `python-dotenv` for environment variable management.
- Added `ruff.toml` configurations targeting `py310` and `py311` in examples.

Assisted-by: Codex

Author: datalogics-kam

examples/delete/delete_example.py

@@ -0,0 +1,52 @@
+# /// script
+# requires-python = ">=3.11"
+# dependencies = ["pdfrest", "python-dotenv"]
+# ///
+"""Delete files with pdfRest's async client on Python 3.11+.
+
+This sample shows how to:
+
+1. Upload a local resource so we have a file id to delete.
+2. Delete that file successfully.
+3. Demonstrate how `PdfRestErrorGroup` behaves when we try to delete the same
+   file again (Python 3.11 also allows `except* PdfRestDeleteError` if you want
+   to tighten the example even further).
+
+Run with `uv run --project ../.. python delete_example.py`; the script uses the
+checked-in `examples/resources/report.pdf` sample so no additional setup is
+required.
+"""
+
+from __future__ import annotations
+
+import asyncio
+from pathlib import Path
+
+from dotenv import load_dotenv
+
+from pdfrest import AsyncPdfRestClient, PdfRestDeleteError
+
+RESOURCE = Path(__file__).resolve().parents[1] / "resources" / "report.pdf"
+
+
+async def delete_with_except_star() -> None:
+    load_dotenv()
+    async with AsyncPdfRestClient() as client:
+        uploaded = (await client.files.create_from_paths([RESOURCE]))[0]
+        print(f"Uploaded {uploaded.name} with id={uploaded.id}")
+
+        await client.files.delete(uploaded)
+        print("First deletion succeeded.\n")
+
+        print("Attempting to delete the same file again to trigger errors...")
+        try:
+            await client.files.delete(uploaded)
+        except* PdfRestDeleteError as group:
+            for error in group.exceptions:
+                print(f"- Cleanup failed for {error.file_id}: {error.detail}")
+        else:  # pragma: no cover - would require server bug
+            print("Second deletion unexpectedly succeeded.")
+
+
+if __name__ == "__main__":  # pragma: no cover - manual example
+    asyncio.run(delete_with_except_star())

examples/delete/python-3.10/delete_example.py

@@ -0,0 +1,48 @@
+# /// script
+# requires-python = "==3.10"
+# dependencies = ["pdfrest", "exceptiongroup", "python-dotenv"]
+# ///
+"""Delete files with pdfRest's async client on Python 3.10.
+
+Python 3.10 lacks the built-in `except*` syntax, so this example uses the
+`exceptiongroup` backport to catch `PdfRestErrorGroup` and inspect individual
+`PdfRestDeleteError` instances when cleanup fails.
+
+Run with `uv run --project ../.. python delete_example.py`; the shared
+`examples/resources/report.pdf` sample ships with the repository.
+"""
+
+from __future__ import annotations
+
+import asyncio
+from pathlib import Path
+
+from dotenv import load_dotenv
+from exceptiongroup import BaseExceptionGroup, catch
+
+from pdfrest import AsyncPdfRestClient, PdfRestDeleteError
+
+RESOURCE = Path(__file__).resolve().parents[2] / "resources" / "report.pdf"
+
+
+def _log_delete_errors(group: BaseExceptionGroup) -> None:
+    for error in group.exceptions:
+        print(f"- Cleanup failed for {error.file_id}: {error.detail}")
+
+
+async def delete_with_exceptiongroup_catch() -> None:
+    load_dotenv()
+    async with AsyncPdfRestClient() as client:
+        uploaded = (await client.files.create_from_paths([RESOURCE]))[0]
+        print(f"Uploaded {uploaded.name} with id={uploaded.id}")
+
+        await client.files.delete(uploaded)
+        print("First deletion succeeded.\n")
+
+        print("Attempting to delete the same file again to trigger errors...")
+        with catch({PdfRestDeleteError: _log_delete_errors}):
+            await client.files.delete(uploaded)
+
+
+if __name__ == "__main__":  # pragma: no cover - manual example
+    asyncio.run(delete_with_exceptiongroup_catch())

examples/delete/python-3.10/ruff.toml

@@ -0,0 +1,4 @@
+# Extend the `ruff.toml` file in the examples directory...
+
+extend = "../../ruff.toml"
+target-version = "py310"

examples/resources/report.pdf

@@ -0,0 +1,4 @@
+# Extend the `pyproject.toml` file in the parent directory...
+
+extend = "../pyproject.toml"
+target-version = "py311"

examples/ruff.toml

@@ -32,6 +32,7 @@ dev = [
     "pytest-xdist>=3.8.0",
     "nox>=2025.5.1",
     "basedpyright>=1.34.0",
+    "python-dotenv>=1.0.1",
 ]
 
 [tool.pytest.ini_options]

pyproject.toml

@@ -22,6 +22,10 @@
     {
       "root": "src"
     },
+    {
+      "root": "examples",
+      "pythonVersion": "3.11"
+    },
     {
       "root": "tests",
       "reportUnknownLambdaType": "none",