Refactor PDF Cleaning Tests for Improved Modularity and Error Handling + Add Rust Distribution README

[carlosiborra]

Description

This pull request introduces a significant refactor of the existing PDF cleaning tests. The primary focus is on enhancing modularity, readability, and error handling, ensuring a more maintainable and robust testing framework. Key changes include the introduction of a TestConfig struct, the use of Result for error handling, performance measurement via std::time::Instant, and improved function naming and structuring.

Also adds a dedicated README file for the Rust distribution.

Changes

1. Introduction of TestConfig Struct: Centralizes test configuration, making it easier to extend tests with new parameters or PDF sources.
2. Improved Modularity: Separates concerns by introducing dedicated functions for creating the output directory (create_output_directory), reading and cleaning PDFs (read_and_clean_pdf), and storing PDFs (store_pdf). This approach enhances code reusability and readability.
3. Robust Error Handling: Shifts from using unwrap() and expect() to handling errors with Result, providing a safer and more idiomatic way to handle potential failures in file operations.
4. Performance Measurement: Adds timing for each test execution using std::time::Instant, offering valuable insights into the performance and efficiency of the PDF cleaning process.
5. Clear and Descriptive Function Names: Renames functions to more accurately reflect their purpose, improving the readability and maintainability of the code.
6. Enhanced Documentation with Rust-Specific README: Introduced a dedicated README file for the Rust distribution and referenced in the main README document.

Testing

• Updated tests have been run successfully, ensuring that the refactoring has not affected the existing functionality.
• Performance measurements have been logged for both test cases, providing a baseline for future optimizations.

Example

Output example after running tests with cargo test --package gulagcleaner_rs --lib -- tests --nocapture:

running 2 tests
Test for `example_docs/studocu-example.pdf` completed in 133.804977ms
test tests::test_studocu_pdf ... ok
Test for `example_docs/wuolah-free-example.pdf` completed in 210.941144ms
test tests::test_wuolah_pdf ... ok

test result: ok. 2 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.22s

[YM162]

LGTM! Thanks for the contribution.