IBX-8534: Added rule for replacing interfaces

src/contracts/Sets/ibexa-50.php

@@ -10,6 +10,7 @@
 
 use Ibexa\Rector\Rule\PropertyToGetterRector;
 use Ibexa\Rector\Rule\RemoveArgumentFromMethodCallRector;
+use Ibexa\Rector\Rule\ReplaceInterfaceRector;
 use Rector\Config\RectorConfig;
 use Rector\Renaming\Rector\ClassConstFetch\RenameClassConstFetchRector;
 use Rector\Renaming\Rector\MethodCall\RenameMethodRector;
@@ -114,4 +115,12 @@
             ],
         ]
     );
+
+    $rectorConfig->ruleWithConfiguration(
+        ReplaceInterfaceRector::class,
+        [
+            'to_replace' => 'Ibexa\Bundle\Core\Imagine\VariationPathGenerator',
+            'replace_with' => 'Ibexa\Contracts\Core\Variation\VariationPathGenerator',
+        ]
+    );
 };

src/lib/Rule/ReplaceInterfaceRector.php

@@ -0,0 +1,74 @@
+<?php
+
+/**
+ * @copyright Copyright (C) Ibexa AS. All rights reserved.
+ * @license For full copyright and license information view LICENSE file distributed with this source code.
+ */
+declare(strict_types=1);
+
+namespace Ibexa\Rector\Rule;
+
+use PhpParser\Node;
+use PhpParser\Node\Name;
+use PhpParser\Node\Stmt\Class_;
+use Rector\Contract\Rector\ConfigurableRectorInterface;
+use Rector\Rector\AbstractRector;
+use Symplify\RuleDocGenerator\ValueObject\CodeSample\ConfiguredCodeSample;
+use Symplify\RuleDocGenerator\ValueObject\RuleDefinition;
+
+final class ReplaceInterfaceRector extends AbstractRector implements ConfigurableRectorInterface
+{
+    /** @var class-string */
+    private string $interfaceToBeReplaced;
+
+    /** @var class-string */
+    private string $interfaceToReplaceWith;
+
+    /**
+     * @throws \Exception
+     */
+    public function getRuleDefinition(): RuleDefinition
+    {
+        return new RuleDefinition('Replace OldInterface with NewInterface', [new ConfiguredCodeSample(
+            <<<'CODE_SAMPLE'
+                class SomeClass implements OldInterface
+                {
+                }
+            CODE_SAMPLE,
+            <<<'CODE_SAMPLE'
+                class SomeClass implements NewInterface
+                {
+                }
+            CODE_SAMPLE,
+            ['var_dump']
+        )]);
+    }
+
+    /**
+     * @return array<class-string<Node>>
+     */
+    public function getNodeTypes(): array
+    {
+        return [Class_::class];
+    }
+
+    /**
+     * @param \PhpParser\Node\Stmt\Class_ $node
+     */
+    public function refactor(Node $node): ?Node
+    {
+        foreach ($node->implements as $key => $implement) {
+            if ($this->isName($implement, $this->interfaceToBeReplaced)) {
+                $node->implements[$key] = new Name($this->interfaceToReplaceWith);
+            }
+        }
+
+        return $node;
+    }
+
+    public function configure(array $configuration): void
+    {
+        $this->interfaceToBeReplaced = $configuration['to_replace'];
+        $this->interfaceToReplaceWith = $configuration['replace_with'];
+    }
+}

tests/lib/Rule/ReplaceInterfaceRector/Fixture/some_class.php.inc

@@ -0,0 +1,19 @@
+<?php /** @noinspection ALL */
+
+namespace Ibexa\Rector\Tests\Rule\ReplaceInterfaceRector\Fixture;
+
+class SomeClass implements \SomeInterface
+{
+}
+
+?>
+-----
+<?php /** @noinspection ALL */
+
+namespace Ibexa\Rector\Tests\Rule\ReplaceInterfaceRector\Fixture;
+
+class SomeClass implements SomeOtherInterface
+{
+}
+
+?>

tests/lib/Rule/ReplaceInterfaceRector/ReplaceInterfaceRectorTest.php

@@ -0,0 +1,34 @@
+<?php
+
+/**
+ * @copyright Copyright (C) Ibexa AS. All rights reserved.
+ * @license For full copyright and license information view LICENSE file distributed with this source code.
+ */
+declare(strict_types=1);
+
+namespace Ibexa\Rector\Tests\Rule\ReplaceInterfaceRector;
+
+use PHPUnit\Framework\Attributes\DataProvider;
+use Rector\Testing\PHPUnit\AbstractRectorTestCase;
+
+final class ReplaceInterfaceRectorTest extends AbstractRectorTestCase
+{
+    /**
+     * @throws \Rector\Exception\ShouldNotHappenException
+     */
+    #[DataProvider('provideData')]
+    public function test(string $filePath): void
+    {
+        $this->doTestFile($filePath);
+    }
+
+    public static function provideData(): \Iterator
+    {
+        return self::yieldFilesFromDirectory(__DIR__ . '/Fixture');
+    }
+
+    public function provideConfigFilePath(): string
+    {
+        return __DIR__ . '/config/configured_rule.php';
+    }
+}

tests/lib/Rule/ReplaceInterfaceRector/config/configured_rule.php

@@ -0,0 +1,20 @@
+<?php
+
+/**
+ * @copyright Copyright (C) Ibexa AS. All rights reserved.
+ * @license For full copyright and license information view LICENSE file distributed with this source code.
+ */
+declare(strict_types=1);
+
+use Ibexa\Rector\Rule\ReplaceInterfaceRector;
+use Rector\Config\RectorConfig;
+
+return static function (RectorConfig $rectorConfig): void {
+    $rectorConfig->ruleWithConfiguration(
+        ReplaceInterfaceRector::class,
+        [
+            'to_replace' => 'SomeInterface',
+            'replace_with' => 'SomeOtherInterface',
+        ]
+    );
+};

tests/lib/Sets/Ibexa50/Fixture/rename_variation_interface.inc

@@ -0,0 +1,23 @@
+<?php
+
+namespace Ibexa\Rector\Tests\Sets\Ibexa50\Fixture;
+
+use Ibexa\Bundle\Core\Imagine\VariationPathGenerator;
+
+class SomeFormatVariationGenerator implements VariationPathGenerator
+{
+}
+
+?>
+-----
+<?php
+
+namespace Ibexa\Rector\Tests\Sets\Ibexa50\Fixture;
+
+use Ibexa\Contracts\Core\Variation\VariationPathGenerator;
+
+class SomeFormatVariationGenerator implements VariationPathGenerator
+{
+}
+
+?>