Implement migration from restrictDeprecations="true" to ignoreIndirectDeprecations="true"

Author: sebastianbergmann

.psalm/baseline.xml

@@ -921,6 +921,11 @@
       <code><![CDATA[removeChild]]></code>
     </PossiblyNullReference>
   </file>
+  <file src="src/TextUI/Configuration/Xml/Migration/Migrations/ReplaceRestrictDeprecationsWithIgnoreDeprecations.php">
+    <RedundantConditionGivenDocblockType>
+      <code><![CDATA[assert($source instanceof DOMElement)]]></code>
+    </RedundantConditionGivenDocblockType>
+  </file>
   <file src="src/TextUI/Configuration/Xml/SchemaFinder.php">
     <LessSpecificReturnStatement>
       <code><![CDATA[$result]]></code>

src/TextUI/Configuration/Xml/Migration/MigrationBuilder.php

@@ -65,6 +65,10 @@
         '10.5' => [
             RemoveRegisterMockObjectsFromTestArgumentsRecursivelyAttribute::class,
         ],
+
+        '11.0' => [
+            ReplaceRestrictDeprecationsWithIgnoreDeprecations::class,
+        ],
     ];
 
     /**

src/TextUI/Configuration/Xml/Migration/Migrations/ReplaceRestrictDeprecationsWithIgnoreDeprecations.php

@@ -0,0 +1,49 @@
+<?php declare(strict_types=1);
+/*
+ * This file is part of PHPUnit.
+ *
+ * (c) Sebastian Bergmann <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+namespace PHPUnit\TextUI\XmlConfiguration;
+
+use function assert;
+use DOMDocument;
+use DOMElement;
+
+/**
+ * @internal This class is not covered by the backward compatibility promise for PHPUnit
+ */
+final readonly class ReplaceRestrictDeprecationsWithIgnoreDeprecations implements Migration
+{
+    /**
+     * @throws MigrationException
+     */
+    public function migrate(DOMDocument $document): void
+    {
+        $source = $document->getElementsByTagName('source')->item(0);
+
+        if ($source === null) {
+            return;
+        }
+
+        assert($source instanceof DOMElement);
+
+        if (!$source->hasAttribute('restrictDeprecations')) {
+            return;
+        }
+
+        $restrictDeprecations = $source->getAttribute('restrictDeprecations') === 'true';
+
+        $source->removeAttribute('restrictDeprecations');
+
+        if (!$restrictDeprecations ||
+            $source->hasAttribute('ignoreIndirectDeprecations')) {
+            return;
+        }
+
+        $source->setAttribute('ignoreIndirectDeprecations', 'true');
+    }
+}

tests/end-to-end/migration/_files/migration-from-110/phpunit-11.0.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/11.0/phpunit.xsd"
+         bootstrap="src/Greeter.php">
+    <testsuites>
+        <testsuite name="default">
+            <directory>tests</directory>
+        </testsuite>
+    </testsuites>
+
+    <source restrictDeprecations="true"/>
+</phpunit>

tests/end-to-end/migration/migration-from-110.phpt

@@ -0,0 +1,22 @@
+--TEST--
+Configuration migration from PHPUnit 11.0 format works
+--FILE--
+<?php declare(strict_types=1);
+$_SERVER['argv'][] = '--do-not-cache-result';
+$_SERVER['argv'][] = '--migrate-configuration';
+
+chdir(sys_get_temp_dir());
+copy(__DIR__ . '/_files/migration-from-110/phpunit-11.0.xml', 'phpunit.xml');
+
+require_once __DIR__ . '/../../bootstrap.php';
+
+(new PHPUnit\TextUI\Application)->run($_SERVER['argv']);
+--EXPECTF--
+PHPUnit %s by Sebastian Bergmann and contributors.
+
+Created backup:         %sphpunit.xml.bak
+Migrated configuration: %sphpunit.xml
+--CLEAN--
+<?php declare(strict_types=1);
+unlink(sys_get_temp_dir() . '/phpunit.xml');
+unlink(sys_get_temp_dir() . '/phpunit.xml.bak');