Rewrote FileSource to use memmap2 for zero-copy random access.
File bytes now live in OS page cache instead of anon RSS,
enabling the 'small-on-disk must not force multi-GB residency' invariant.
Changes:
- Added memmap2 = "0.9" dependency to pdftract-core
- Replaced fs::File-based FileSource with memmap2::Mmap
- Added source_tests module with 5 unit tests (all pass)
- Removed fs::read fallback for unbounded files per Anti-Patterns
Closes: bf-2ervu
Add test helper for running code under bounded memory limits and asserting
graceful failure (no OOM panic/abort). Uses POSIX rlimit (RLIMIT_AS) on
Linux/macOS; skips on Windows.
Implements:
- run_under_memory_limit(): Execute closure with memory limit
- assert_fails_under_memory_limit(): Assert graceful failure
- assert_succeeds_under_memory_limit(): Assert success within budget
Applied to allocation-sensitive test scenarios (vector, string, hashmap
allocations). Tests with tight limits are marked #[ignore] to avoid
interference when run in the same process.
Closes: bf-4fa0y
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
