2019-10-13 05:59:52 +00:00
|
|
|
<?php
|
|
|
|
|
2021-05-09 20:15:43 +00:00
|
|
|
declare (strict_types=1);
|
2022-06-06 17:12:56 +00:00
|
|
|
namespace Rector\Transform\Rector\ClassMethod;
|
2018-12-12 19:34:32 +00:00
|
|
|
|
2022-06-06 17:12:56 +00:00
|
|
|
use PhpParser\Node;
|
2023-03-23 23:21:34 +00:00
|
|
|
use PhpParser\Node\Expr;
|
2022-06-06 17:12:56 +00:00
|
|
|
use PhpParser\Node\Expr\Array_;
|
|
|
|
use PhpParser\Node\Expr\ArrayItem;
|
|
|
|
use PhpParser\Node\Stmt\ClassMethod;
|
|
|
|
use PhpParser\Node\Stmt\Return_;
|
2024-01-02 02:40:38 +00:00
|
|
|
use Rector\Contract\Rector\ConfigurableRectorInterface;
|
|
|
|
use Rector\Rector\AbstractRector;
|
2022-06-06 17:12:56 +00:00
|
|
|
use Rector\Transform\ValueObject\WrapReturn;
|
2022-06-07 09:18:30 +00:00
|
|
|
use Symplify\RuleDocGenerator\ValueObject\CodeSample\ConfiguredCodeSample;
|
|
|
|
use Symplify\RuleDocGenerator\ValueObject\RuleDefinition;
|
2024-05-02 02:21:56 +00:00
|
|
|
use RectorPrefix202405\Webmozart\Assert\Assert;
|
2019-09-03 09:11:45 +00:00
|
|
|
/**
|
2021-03-12 22:20:25 +00:00
|
|
|
* @see \Rector\Tests\Transform\Rector\ClassMethod\WrapReturnRector\WrapReturnRectorTest
|
2019-09-03 09:11:45 +00:00
|
|
|
*/
|
2022-06-07 08:22:29 +00:00
|
|
|
final class WrapReturnRector extends AbstractRector implements ConfigurableRectorInterface
|
2018-12-12 19:34:32 +00:00
|
|
|
{
|
|
|
|
/**
|
2020-09-12 21:19:08 +00:00
|
|
|
* @var WrapReturn[]
|
2018-12-12 19:34:32 +00:00
|
|
|
*/
|
2020-08-25 19:05:58 +00:00
|
|
|
private $typeMethodWraps = [];
|
2022-06-07 08:22:29 +00:00
|
|
|
public function getRuleDefinition() : RuleDefinition
|
2018-12-12 19:34:32 +00:00
|
|
|
{
|
2022-06-07 08:22:29 +00:00
|
|
|
return new RuleDefinition('Wrap return value of specific method', [new ConfiguredCodeSample(<<<'CODE_SAMPLE'
|
2018-12-12 19:34:32 +00:00
|
|
|
final class SomeClass
|
|
|
|
{
|
|
|
|
public function getItem()
|
|
|
|
{
|
|
|
|
return 1;
|
|
|
|
}
|
|
|
|
}
|
2020-09-15 08:23:13 +00:00
|
|
|
CODE_SAMPLE
|
2021-05-09 20:15:43 +00:00
|
|
|
, <<<'CODE_SAMPLE'
|
2018-12-12 19:34:32 +00:00
|
|
|
final class SomeClass
|
|
|
|
{
|
|
|
|
public function getItem()
|
|
|
|
{
|
|
|
|
return [1];
|
|
|
|
}
|
|
|
|
}
|
2020-09-15 08:23:13 +00:00
|
|
|
CODE_SAMPLE
|
2022-06-07 08:22:29 +00:00
|
|
|
, [new WrapReturn('SomeClass', 'getItem', \true)])]);
|
2018-12-12 19:34:32 +00:00
|
|
|
}
|
|
|
|
/**
|
2021-02-27 00:06:15 +00:00
|
|
|
* @return array<class-string<Node>>
|
2018-12-12 19:34:32 +00:00
|
|
|
*/
|
2021-05-09 20:15:43 +00:00
|
|
|
public function getNodeTypes() : array
|
2018-12-12 19:34:32 +00:00
|
|
|
{
|
2022-06-07 08:22:29 +00:00
|
|
|
return [ClassMethod::class];
|
2018-12-12 19:34:32 +00:00
|
|
|
}
|
|
|
|
/**
|
2021-12-10 10:22:23 +00:00
|
|
|
* @param ClassMethod $node
|
2018-12-12 19:34:32 +00:00
|
|
|
*/
|
2022-06-07 08:22:29 +00:00
|
|
|
public function refactor(Node $node) : ?Node
|
2018-12-12 19:34:32 +00:00
|
|
|
{
|
2020-08-25 19:05:58 +00:00
|
|
|
foreach ($this->typeMethodWraps as $typeMethodWrap) {
|
2023-03-22 14:20:22 +00:00
|
|
|
if (!$this->isName($node, $typeMethodWrap->getMethod())) {
|
2018-12-12 19:34:32 +00:00
|
|
|
continue;
|
|
|
|
}
|
2023-03-22 14:20:22 +00:00
|
|
|
if (!$this->isObjectType($node, $typeMethodWrap->getObjectType())) {
|
2020-08-25 19:05:58 +00:00
|
|
|
continue;
|
|
|
|
}
|
2021-11-28 17:01:20 +00:00
|
|
|
if ($node->stmts === null) {
|
2020-08-25 19:05:58 +00:00
|
|
|
continue;
|
2018-12-12 19:34:32 +00:00
|
|
|
}
|
2020-08-25 19:05:58 +00:00
|
|
|
return $this->wrap($node, $typeMethodWrap->isArrayWrap());
|
2018-12-12 19:34:32 +00:00
|
|
|
}
|
2022-11-24 14:31:52 +00:00
|
|
|
return null;
|
2018-12-12 19:34:32 +00:00
|
|
|
}
|
2021-05-02 10:46:55 +00:00
|
|
|
/**
|
2021-11-28 17:01:20 +00:00
|
|
|
* @param mixed[] $configuration
|
2021-05-02 10:46:55 +00:00
|
|
|
*/
|
2021-12-10 10:22:23 +00:00
|
|
|
public function configure(array $configuration) : void
|
2020-07-29 23:39:41 +00:00
|
|
|
{
|
2022-06-07 08:22:29 +00:00
|
|
|
Assert::allIsAOf($configuration, WrapReturn::class);
|
2022-02-18 01:46:17 +00:00
|
|
|
$this->typeMethodWraps = $configuration;
|
2020-07-29 23:39:41 +00:00
|
|
|
}
|
2022-06-07 08:22:29 +00:00
|
|
|
private function wrap(ClassMethod $classMethod, bool $isArrayWrap) : ?ClassMethod
|
2018-12-12 19:34:32 +00:00
|
|
|
{
|
2021-05-09 20:15:43 +00:00
|
|
|
if (!\is_iterable($classMethod->stmts)) {
|
2020-08-25 19:05:58 +00:00
|
|
|
return null;
|
2018-12-12 19:34:32 +00:00
|
|
|
}
|
2020-12-25 00:22:45 +00:00
|
|
|
foreach ($classMethod->stmts as $key => $stmt) {
|
2023-03-23 23:21:34 +00:00
|
|
|
if ($stmt instanceof Return_ && $stmt->expr instanceof Expr) {
|
2022-06-07 08:22:29 +00:00
|
|
|
if ($isArrayWrap && !$stmt->expr instanceof Array_) {
|
|
|
|
$stmt->expr = new Array_([new ArrayItem($stmt->expr)]);
|
2018-12-12 19:34:32 +00:00
|
|
|
}
|
2020-08-25 19:05:58 +00:00
|
|
|
$classMethod->stmts[$key] = $stmt;
|
2018-12-12 19:34:32 +00:00
|
|
|
}
|
|
|
|
}
|
2020-08-25 19:05:58 +00:00
|
|
|
return $classMethod;
|
2018-12-12 19:34:32 +00:00
|
|
|
}
|
|
|
|
}
|