version 2

.github/workflows/ci.yml

@@ -10,18 +10,15 @@
       fail-fast: false
       matrix:
         env:
-          - { php: 7.4, phpunit: 9 }
-          - { php: 8.0, phpunit: 10 }
-          - { php: 8.1, phpunit: 10 }
-          - { php: 8.2, phpunit: 10 }
-          - { php: 8.3, phpunit: 10 }
-          - { php: 8.4, phpunit: 10, main: true }
-          - { php: 8.5, phpunit: 10 }
+          - { php: 8.2, phpunit: 11 }
+          - { php: 8.3, phpunit: 12 }
+          - { php: 8.4, phpunit: 13 }
+          - { php: 8.5, phpunit: 13, main: true }
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
       - name: Composer cache
-        uses: actions/cache@v5
+        uses: actions/cache@v6
         with:
           path: "vendor"
           key: ${{ runner.os }}-${{ matrix.env.php }}-composer-${{ hashFiles('composer.json') }}
@@ -63,7 +60,7 @@
           thresholds: '60 80'
       - name: Add Coverage PR Comment
         if: "matrix.env.main == true && github.event_name == 'pull_request'"
-        uses: marocchino/sticky-pull-request-comment@v2
+        uses: marocchino/sticky-pull-request-comment@v3
         with:
           recreate: true
           path: code-coverage-results.md

README.md

@@ -117,6 +117,25 @@ array(3) {
 }
 ```
 
+## Passing custom data to `processFile`
+
+`XmlProcessor::processFile()` accepts an optional associative array of custom data.
+It is stored on the [`XmlProcessorContext`], together with the filename currently being processed,
+and is available to every node processor via `$context->getXmlProcessorContext()`.
+
+```php
+$processor->processFile('file.xml', ['tenant' => 'acme']);
+```
+
+```php
+public function openElement(OpenContext $context)
+{
+    $xmlProcessorContext = $context->getXmlProcessorContext();
+    $filename = $xmlProcessorContext->getFilename();
+    $tenant = $xmlProcessorContext->get('tenant');
+}
+```
+
 [`XmlProcessor`]: src/XmlProcessor.php
 
 [`NodeProcessorInterface`]: src/NodeProcessor/NodeProcessorInterface.php
@@ -129,6 +148,8 @@ array(3) {
 
 [`TextNodeProcessorInterface`]: src/NodeProcessor/TextNodeProcessorInterface.php
 
+[`XmlProcessorContext`]: src/XmlProcessorContext.php
+
 [`NodeProcessorContext`]: src/NodeProcessor/Context/NodeProcessorContext.php
 
 [`OpenContext]: src/NodeProcessor/Context/OpenContext.php

composer.json

@@ -9,14 +9,14 @@
     "docs": "https://github.com/netlogix/XML-Processor/blob/main/README.md"
   },
   "require": {
-    "php": "^7.4 || ^8.0",
-    "ext-xmlreader": "*",
-    "symfony/polyfill-php80": ">=1.33.0"
+    "php": "^8.2",
+    "ext-xmlreader": "*"
   },
   "require-dev": {
     "behat/behat": "^3.12.0",
+    "carthage-software/mago": "^1.43",
     "ergebnis/composer-normalize": "^2.50",
-    "phpunit/phpunit": "^9.6.6",
+    "phpunit/phpunit": "^11.5.56",
     "rector/rector": "^2.3"
   },
   "prefer-stable": true,
@@ -40,6 +40,7 @@
   "scripts": {
     "apply-coding-standard": [
       "@composer:normalize:fix",
+      "@lint:fix",
       "@rector:fix",
       "@format:fix"
     ],
@@ -52,6 +53,7 @@
     "format": "mago fmt --dry-run",
     "format:fix": "mago fmt",
     "lint": "mago lint",
+    "lint:fix": "mago lint --fix --unsafe",
     "rector": "rector process --dry-run",
     "rector:fix": "rector process",
     "test": [

mago.toml

@@ -1,12 +1,10 @@
-php-version = "8.4"
+php-version = "8.2"
 
 [source]
 workspace = "."
 paths = [
     "src/",
-    "tests/",
-    # "importmap.php",
-    "migrations/",
+    "tests/"
 ]
 includes = ["vendor"]
 excludes = []
@@ -25,7 +23,8 @@ empty-line-before-return = true
 integrations = ["phpunit"]
 
 [linter.rules]
-ambiguous-function-call = { enabled = false }
+no-fully-qualified-global-function = { enabled = false, level = "warning" }
+ambiguous-function-call = { enabled = true, level = "warning" }
 literal-named-argument = { enabled = false }
 halstead = { effort-threshold = 7000 }
 final-controller = { enabled = false }

phpunit.xml

@@ -1,18 +1,14 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.3/phpunit.xsd"
-         bootstrap="vendor/autoload.php"
-         colors="true"
-         >
-    <coverage>
-        <include>
-            <directory suffix=".php">src/</directory>
-            <directory suffix=".php">features/NodeProcessor</directory>
-        </include>
-    </coverage>
-    <testsuites>
-        <testsuite name="unit">
-            <directory>tests/Unit</directory>
-        </testsuite>
-    </testsuites>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/11.5/phpunit.xsd" bootstrap="vendor/autoload.php" colors="true">
+  <testsuites>
+    <testsuite name="unit">
+      <directory>tests/Unit</directory>
+    </testsuite>
+  </testsuites>
+  <source>
+    <include>
+      <directory suffix=".php">src/</directory>
+      <directory suffix=".php">features/NodeProcessor</directory>
+    </include>
+  </source>
 </phpunit>

rector.php

@@ -13,7 +13,7 @@
         __DIR__ . '/tests',
     ])
     // uncomment to reach your current PHP version
-    ->withPhpVersion(PhpVersion::PHP_74)
+    ->withPhpVersion(PhpVersion::PHP_82)
     ->withSets([
         PHPUnitSetList::ANNOTATIONS_TO_ATTRIBUTES
     ])

src/NodeProcessor/AbstractNodeProcessor.php

@@ -9,16 +9,20 @@
 use Netlogix\XmlProcessor\XmlProcessor;
 use Netlogix\XmlProcessor\XmlProcessorContext;
 
+use function get_class;
+use function defined;
+use function constant;
+
 class AbstractNodeProcessor implements NodeProcessorInterface
 {
     public function getNodePath(): string
     {
-        $constName = \get_class($this) . '::NODE_PATH';
+        $constName = get_class($this) . '::NODE_PATH';
         if (!defined($constName)) {
             throw new Exception('NODE_PATH not defined in ' . static::class);
         }
 
-        return \constant($constName);
+        return constant($constName);
     }
 
     public function getSubscribedEvents(string $nodePath, XmlProcessorContext $context): Iterator

src/NodeProcessor/Context/AbstractElementContext.php

@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types = 1);
+
 namespace Netlogix\XmlProcessor\NodeProcessor\Context;
 
 class AbstractElementContext extends NodeProcessorContext