FinalImplementationTest.php

Go to the documentation of this file.

<?php
namespace Magento\CodeMessDetector\Test\Unit\Rule\Design;

use PHPUnit\Framework\TestCase as TestCase;
use PHPUnit_Framework_MockObject_MockObject as MockObject;
use PHPUnit\Framework\MockObject\Matcher\InvokedRecorder as InvokedRecorder;
use PHPUnit\Framework\MockObject\Builder\InvocationMocker as InvocationMocker;
use Magento\CodeMessDetector\Rule\Design\FinalImplementation;
use PHPMD\Report;
use PHPMD\AbstractNode;
use PHPMD\Node\ClassNode;
use PHPMD\Node\MethodNode;
use BadMethodCallException;

class FinalImplementationTest extends TestCase
{
    public function testRuleNotAppliesToNotFinalFinalizable($nodeType)
    {
        $finalizableNode = $this->createFinalizableNodeMock($nodeType);
        $finalizableNode->method('isFinal')->willReturn(false);

        $rule = new FinalImplementation();
        $this->expectsRuleViolation($rule, $this->never());
        $rule->apply($finalizableNode);
    }

    public function testRuleAppliesToFinalFinalizable($nodeType)
    {
        $finalizableNode = $this->createFinalizableNodeMock($nodeType);
        $finalizableNode->method('isFinal')->willReturn(true);

        $rule = new FinalImplementation();
        $this->expectsRuleViolation($rule, $this->once());
        $rule->apply($finalizableNode);
    }

    public function testRuleVerifiesFinalizableNodes($nodeType)
    {
        $finalizableNode = $this->createFinalizableNodeMock($nodeType);

        $finalizableNode->expects($this->atLeastOnce())
            ->method('isFinal');

        $rule = new FinalImplementation();
        $rule->apply($finalizableNode);
    }

    public function testRuleFailsOnNotFinalizableNodes()
    {
        $someNode = $this->getMockBuilder(AbstractNode::class)
            ->disableOriginalConstructor()
            ->getMockForAbstractClass();

        $rule = new FinalImplementation();
        $rule->apply($someNode);
    }

    public function finalizableNodeTypesProvider()
    {
        return [
            [ClassNode::class],
            [MethodNode::class],
        ];
    }

    private function createFinalizableNodeMock($nodeType)
    {
        $finalizableNode = $this->getMockBuilder($nodeType)
            ->disableOriginalConstructor()
            ->disableProxyingToOriginalMethods()
            ->setMethods([
                'isFinal',
                // disable name lookup from AST artifact
                'getNamespaceName',
                'getParentName',
                'getName',
            ])
            ->getMock();
        return $finalizableNode;
    }

    private function expectsRuleViolation(FinalImplementation $rule, InvokedRecorder $violationExpectation)
    {
        $report = $this->getMockBuilder(Report::class)->getMock();
        $invokation = $report->expects($violationExpectation)->method('addRuleViolation');
        $rule->setReport($report);
        return $invokation;
    }
}