Add simple profile script that parses a pdf file without using PHPUnit and Composer

Author: PrinsFrank

CONTRIBUTING.md

@@ -13,13 +13,13 @@ It contains php-spx for easier profiling of memory/cpu usage, which can be enabl
 
 To profile how a specific PDF is being parsed, you can run the parser with SPX_ENABLED=1 for a specific sample from the Samples test suite. For example, to debug the file in `tests/Samples/files/gdocs-image-simple/file.pdf`, you can run the following command:
 ```bash
-docker compose exec -e SPX_ENABLED=1 php vendor/bin/phpunit tests/Samples/ --filter "gdocs-image-simple"
+docker compose exec -e SPX_ENABLED=1 php php tests/Samples/profile.php gdocs-image-simple getText
 ```
 
 If you want a more detailed profile, you can run the following command:
 
 ```bash
-docker compose exec -e SPX_ENABLED=1 -e SPX_REPORT=full php vendor/bin/phpunit tests/Samples/ --filter "gdocs-image-simple"
+docker compose exec -e SPX_ENABLED=1 -e SPX_REPORT=full php php tests/Samples/profile.php gdocs-image-simple getText
 ```
 
 you can then head to http://localhost, scroll down to the last run and click on it to view the full profile.

tests/Samples/profile.php

@@ -0,0 +1,17 @@
+<?php declare(strict_types=1);
+
+require_once dirname(__DIR__, 2) . '/.al-custom.php';
+
+$sampleName = $argv[1] ?? throw new InvalidArgumentException('Missing sample name');
+if (preg_match('/^[a-zA-Z0-9_-]+$/', $sampleName) !== 1) {
+    throw new InvalidArgumentException('Invalid sample name. Only alphanumeric characters, hyphens, and underscores are allowed.');
+}
+
+$document = (new \PrinsFrank\PdfParser\PdfParser())
+    ->parseFile(__DIR__ . '/files/' . $sampleName . '/file.pdf');
+
+match ($argv[2] ?? throw new InvalidArgumentException('Missing profile type')) {
+    'getText' => $document->getText(),
+    'getImages' => array_map(fn(\PrinsFrank\PdfParser\Document\Object\Decorator\XObject $image) => $image->getStream()->toString(), $document->getImages()),
+    default => throw new InvalidArgumentException('Please provide a profile type'),
+};