MockObjectExprDetector.php

<?php

declare(strict_types=1);

namespace Rector\PHPUnit\CodeQuality\NodeAnalyser;

use PhpParser\Node\Expr;
use PhpParser\Node\Expr\MethodCall;
use PhpParser\Node\Expr\PropertyFetch;
use PhpParser\Node\Expr\Variable;
use PhpParser\Node\Stmt\Class_;
use PhpParser\Node\Stmt\ClassMethod;
use Rector\NodeNameResolver\NodeNameResolver;
use Rector\PhpParser\Node\BetterNodeFinder;
use Rector\PHPUnit\CodeQuality\NodeFinder\VariableFinder;

final readonly class MockObjectExprDetector
{
    public function __construct(
        private BetterNodeFinder $betterNodeFinder,
        private NodeNameResolver $nodeNameResolver,
        private VariableFinder $variableFinder,
    ) {
    }

    public function isUsedForMocking(Expr $expr, ClassMethod $classMethod): bool
    {
        if (! $expr instanceof Variable) {
            return false;
        }

        $variableName = $this->nodeNameResolver->getName($expr);

        // to be safe
        if ($variableName === null) {
            return true;
        }

        $relatedVariables = $this->variableFinder->find($classMethod, $variableName);

        // only self variable found, nothing to mock
        if (count($relatedVariables) === 1) {
            return false;
        }

        // find out, how many are used in call likes as args
        /** @var array<Expr\MethodCall> $methodCalls */
        $methodCalls = $this->betterNodeFinder->findInstancesOfScoped((array) $classMethod->stmts, [MethodCall::class]);

        foreach ($methodCalls as $methodCall) {
            if (! $methodCall->var instanceof Variable) {
                continue;
            }

            if ($this->nodeNameResolver->isName($methodCall->var, $variableName)) {
                // variable is being called on, most like mocking, lets skip
                return true;
            }
        }

        return false;
    }

    public function isPropertyUsedForMocking(Class_ $class, string $propertyName): bool
    {
        // find out, how many are used in call likes as args
        /** @var array<Expr\MethodCall> $methodCalls */
        $methodCalls = $this->betterNodeFinder->findInstancesOfScoped($class->getMethods(), [MethodCall::class]);

        foreach ($methodCalls as $methodCall) {
            if (! $methodCall->var instanceof PropertyFetch) {
                continue;
            }

            $propertyFetch = $methodCall->var;
            if ($this->nodeNameResolver->isName($propertyFetch->name, $propertyName)) {
                // variable is being called on, most like mocking, lets skip
                return true;
            }
        }

        return false;
    }
}