Add comprehensive test suite and rules documentation

- Add .rules directory with detailed guidelines for code style, testing, samples, file review, docs, and commit strategy
- Update test READMEs with improved documentation
- Add new integration tests for editpdf, pagenumbers, pdftojpg, and validate_pdfa tasks
- Add new unit tests for editpdf, pagenumbers, pdftojpg, and validate_pdfa tasks
- Update existing unit tests with enhancements
- Add test sample files (PDFs and images) for comprehensive testing
- Improve test structure and organization

Update test_task.py

Update test_task_methods.py

Update README.md

Author: daniel-crombie

tests/README.md

@@ -4,12 +4,12 @@ This directory contains all test code for the **iLovePDF Python** library. Tests
 
 ## Structure
 
-- `unit/`  
-  Contains unit tests for individual modules and classes.  
+- `unit/`
+  Contains unit tests for individual modules and classes.
   See [`unit/README.md`](unit/README.md) for details.
 
-- `integration/`  
-  Contains integration tests that interact with the iLovePDF API and test complete workflows.  
+- `integration/`
+  Contains integration tests that interact with the iLovePDF API and test complete workflows.
   See [`integration/README.md`](integration/README.md) for details.
 
 ## Running Tests

tests/integration/README.md

@@ -33,17 +33,18 @@ pytest tests/integration
 | test_integration_merge_task.py              | Integration tests for MergeTask, merging multiple PDF files.                                  |
 | test_integration_office_pdf_task.py         | Integration tests for OfficePdfTask, converting Office files to PDF.                          |
 | test_integration_pdfocr_task.py             | Integration tests for PdfOcrTask, performing OCR on scanned PDFs.                             |
-| test_integration_pdftopdfa_task.py          | Integration tests for PdfToPdfATask, converting PDFs to PDF/A format.                         |
-| test_integration_protect_task.py            | Integration tests for ProtectTask, adding password protection to PDFs.                        |
+| test_integration_pdftojpg_task.py           | Integration tests for PdfToJpgTask, converting PDF files to JPG images in 'pages' and 'extract' modes. |
+| test_integration_pdftopdfa_task.py           | Integration tests for PdfToPdfATask, converting PDFs to PDF/A format.                         |
+| test_integration_validate_pdfa_task.py       | Integration tests for ValidatePdfATask, validating PDF/A compliance of PDF files.             |
+| test_integration_protect_task.py             | Integration tests for ProtectTask, adding password protection to PDFs.                        |
 | test_integration_repair_task.py             | Integration tests for RepairTask, repairing corrupted PDFs.                                   |
 | test_integration_rotate_task.py             | Integration tests for RotateTask, rotating PDF pages.                                         |
 | test_integration_sign_basic_task.py         | Integration tests for SignTask, digital signature workflows.                                  |
 | test_integration_split_task.py              | Integration tests for SplitTask, splitting PDFs by range, pages, or size.                     |
 | test_integration_unlock_task.py             | Integration tests for UnlockTask, removing password protection from PDFs.                     |
 | test_integration_watermark_task.py          | Integration tests for WatermarkTask, adding text or image watermarks to PDFs.                 |
-| test_integration_removebackground_task.py   | Integration tests for RemoveBackgroundTask, verifying background removal in PDFs.             |
-| test_integration_resize_task.py             | Integration tests for ResizeTask, resizing images within PDFs.                                |
-| test_integration_upscale_task.py            | Integration tests for UpscaleTask, AI-based upscaling of images in PDFs.                      |
+| test_integration_pagenumbers_task.py        | Integration tests for PageNumbersTask, adding page numbers to PDFs with customizable appearance and format. |
+| test_integration_editpdf_task.py            | Integration tests for EditPdfTask, covering text, image, and SVG elements plus execute/download workflows. |
 
 Update this table as new integration tests are added.
 

tests/integration/base_task_integration_test.py

@@ -10,14 +10,17 @@ class MyTaskTest(BaseIlovePdfTaskIntegrationTest):
 
 import os
 import shutil
+import tempfile
 from pathlib import Path
 from typing import Generic, TypeVar
 
 import pytest
 
 from ilovepdf.task import Task
 
-_OUTPUT_COUNTER_FILE = Path("/tmp/ilovepdf_output_counter.txt")
+_OUTPUT_COUNTER_FILE = Path(
+    os.path.join(tempfile.gettempdir(), "ilovepdf_output_counter.txt")
+)
 
 
 def get_and_increment_global_counter() -> int:
@@ -45,7 +48,6 @@ def get_and_increment_global_counter() -> int:
 T = TypeVar("T", bound=Task)
 
 
-# pylint: disable=protected-access
 class BaseTaskIntegrationTest(Generic[T]):
     """
     Base class for iLovePDF Task integration tests.
@@ -245,9 +247,9 @@ def download_result(self, output_filename: str) -> None:
         self.task.download()
         self.downloaded_file = output_filename
 
-        assert os.path.exists(
-            self.downloaded_file
-        ), f"Downloaded file '{self.downloaded_file}' does not exist."
-        assert (
-            os.path.getsize(self.downloaded_file) > 0
-        ), f"Downloaded file '{self.downloaded_file}' is empty."
+        assert os.path.exists(self.downloaded_file), (
+            f"Downloaded file '{self.downloaded_file}' does not exist."
+        )
+        assert os.path.getsize(self.downloaded_file) > 0, (
+            f"Downloaded file '{self.downloaded_file}' is empty."
+        )

tests/integration/files_samples/ilovepdf-logo.png

@@ -16,8 +16,6 @@ def start(self):
         """Start the authentication test."""
 
 
-# pylint: disable=bad-option-value
-# pylint: disable=broad-exception-raised
 class TestAuthAPI(BaseTaskIntegrationTest):
     """Test the authentication API."""
 

tests/integration/files_samples/ilovepdf-logo.svg

@@ -15,9 +15,9 @@ def test_full_upload_flow(self):
 
         # 1. Upload a IMG file and associate it with the task
         uploaded_file = self.add_sample_file()
-        assert (
-            getattr(uploaded_file, "server_filename", None) is not None
-        ), "Uploaded file should have a server_filename."
+        assert getattr(uploaded_file, "server_filename", None) is not None, (
+            "Uploaded file should have a server_filename."
+        )
 
         # 2. Execute the task and download the result
         self.execute_task()