rector/rules/DeadCode/Rector/ClassMethod/RemoveUselessReturnTagRecto...

73 lines
1.7 KiB
PHP

<?php
declare (strict_types=1);
namespace Rector\DeadCode\Rector\ClassMethod;
use PhpParser\Node;
use PhpParser\Node\Stmt\ClassMethod;
use Rector\Core\Rector\AbstractRector;
use Rector\DeadCode\PhpDoc\TagRemover\ReturnTagRemover;
use Symplify\RuleDocGenerator\ValueObject\CodeSample\CodeSample;
use Symplify\RuleDocGenerator\ValueObject\RuleDefinition;
/**
* @see \Rector\Tests\DeadCode\Rector\ClassMethod\RemoveUselessReturnTagRector\RemoveUselessReturnTagRectorTest
*/
final class RemoveUselessReturnTagRector extends AbstractRector
{
/**
* @readonly
* @var \Rector\DeadCode\PhpDoc\TagRemover\ReturnTagRemover
*/
private $returnTagRemover;
public function __construct(ReturnTagRemover $returnTagRemover)
{
$this->returnTagRemover = $returnTagRemover;
}
public function getRuleDefinition() : RuleDefinition
{
return new RuleDefinition('Remove @return docblock with same type as defined in PHP', [new CodeSample(<<<'CODE_SAMPLE'
use stdClass;
class SomeClass
{
/**
* @return stdClass
*/
public function foo(): stdClass
{
}
}
CODE_SAMPLE
, <<<'CODE_SAMPLE'
use stdClass;
class SomeClass
{
public function foo(): stdClass
{
}
}
CODE_SAMPLE
)]);
}
/**
* @return array<class-string<Node>>
*/
public function getNodeTypes() : array
{
return [ClassMethod::class];
}
/**
* @param ClassMethod $node
*/
public function refactor(Node $node) : ?Node
{
$phpDocInfo = $this->phpDocInfoFactory->createFromNodeOrEmpty($node);
$hasChanged = $this->returnTagRemover->removeReturnTagIfUseless($phpDocInfo, $node);
if (!$hasChanged) {
return null;
}
return $node;
}
}