ForumListingBreadcrumbBuilderTest.php

<?php

declare (strict_types=1);
namespace Drupal\Tests\forum\Unit\Breadcrumb;

use Drupal\Core\Cache\Cache;
use Drupal\Core\Entity\EntityTypeManagerInterface;
use Drupal\Core\Link;
use Drupal\forum\Breadcrumb\ForumListingBreadcrumbBuilder;
use Drupal\taxonomy\Entity\Term;
use Drupal\taxonomy\TermStorageInterface;
use Drupal\Tests\UnitTestCase;
use Symfony\Component\DependencyInjection\Container;

/**
 * @coversDefaultClass \Drupal\forum\Breadcrumb\ForumListingBreadcrumbBuilder
 * @group forum
 * @group legacy
 */
class ForumListingBreadcrumbBuilderTest extends UnitTestCase {
    
    /**
     * {@inheritdoc}
     */
    protected function setUp() : void {
        parent::setUp();
        $cache_contexts_manager = $this->getMockBuilder('Drupal\\Core\\Cache\\Context\\CacheContextsManager')
            ->disableOriginalConstructor()
            ->getMock();
        $cache_contexts_manager->method('assertValidTokens')
            ->willReturn(TRUE);
        $container = new Container();
        $container->set('cache_contexts_manager', $cache_contexts_manager);
        \Drupal::setContainer($container);
    }
    
    /**
     * Tests ForumListingBreadcrumbBuilder::applies().
     *
     * @param bool $expected
     *   ForumListingBreadcrumbBuilder::applies() expected result.
     * @param string|null $route_name
     *   (optional) A route name.
     * @param array $parameter_map
     *   (optional) An array of parameter names and values.
     *
     * @dataProvider providerTestApplies
     * @covers ::applies
     */
    public function testApplies(bool $expected, ?string $route_name = NULL, array $parameter_map = []) : void {
        // Make some test doubles.
        $entity_type_manager = $this->createMock(EntityTypeManagerInterface::class);
        $config_factory = $this->getConfigFactoryStub([]);
        $forum_manager = $this->createMock('Drupal\\forum\\ForumManagerInterface');
        $translation_manager = $this->createMock('Drupal\\Core\\StringTranslation\\TranslationInterface');
        $map = [];
        if ($parameter_map) {
            foreach ($parameter_map as $parameter) {
                $map[] = [
                    $parameter[0],
                    $parameter[1] === TRUE ? $this->getMockBuilder(Term::class)
                        ->disableOriginalConstructor()
                        ->getMock() : $parameter[1],
                ];
            }
        }
        // Make an object to test.
        $builder = new ForumListingBreadcrumbBuilder($entity_type_manager, $config_factory, $forum_manager, $translation_manager);
        $route_match = $this->createMock('Drupal\\Core\\Routing\\RouteMatchInterface');
        $route_match->expects($this->once())
            ->method('getRouteName')
            ->willReturn($route_name);
        $route_match->expects($this->any())
            ->method('getParameter')
            ->willReturnMap($map);
        $this->assertEquals($expected, $builder->applies($route_match));
    }
    
    /**
     * Provides test data for testApplies().
     *
     * @return \Generator
     *   Datasets for testApplies(). Structured as such:
     *   - ForumListBreadcrumbBuilder::applies() expected result.
     *   - ForumListBreadcrumbBuilder::applies() $attributes input array.
     */
    public static function providerTestApplies() : \Generator {
        (yield [
            FALSE,
        ]);
        (yield [
            FALSE,
            'NOT.forum.page',
        ]);
        (yield [
            FALSE,
            'forum.page',
        ]);
        (yield [
            TRUE,
            'forum.page',
            [
                [
                    'taxonomy_term',
                    'anything',
                ],
            ],
        ]);
        (yield [
            TRUE,
            'forum.page',
            [
                [
                    'taxonomy_term',
                    TRUE,
                ],
            ],
        ]);
    }
    
    /**
     * Tests ForumListingBreadcrumbBuilder::build().
     *
     * @see \Drupal\forum\ForumListingBreadcrumbBuilder::build()
     *
     * @covers ::build
     */
    public function testBuild() : void {
        // Build all our dependencies, backwards.
        $translation_manager = $this->getMockBuilder('Drupal\\Core\\StringTranslation\\TranslationInterface')
            ->disableOriginalConstructor()
            ->getMock();
        $prophecy = $this->prophesize('Drupal\\taxonomy\\Entity\\Term');
        $prophecy->label()
            ->willReturn('Something');
        $prophecy->id()
            ->willReturn(1);
        $prophecy->getCacheTags()
            ->willReturn([
            'taxonomy_term:1',
        ]);
        $prophecy->getCacheContexts()
            ->willReturn([]);
        $prophecy->getCacheMaxAge()
            ->willReturn(Cache::PERMANENT);
        $term1 = $prophecy->reveal();
        $prophecy = $this->prophesize('Drupal\\taxonomy\\Entity\\Term');
        $prophecy->label()
            ->willReturn('Something else');
        $prophecy->id()
            ->willReturn(2);
        $prophecy->getCacheTags()
            ->willReturn([
            'taxonomy_term:2',
        ]);
        $prophecy->getCacheContexts()
            ->willReturn([]);
        $prophecy->getCacheMaxAge()
            ->willReturn(Cache::PERMANENT);
        $term2 = $prophecy->reveal();
        $term_storage = $this->getMockBuilder(TermStorageInterface::class)
            ->getMock();
        $term_storage->expects($this->exactly(2))
            ->method('loadAllParents')
            ->willReturnOnConsecutiveCalls([
            $term1,
        ], [
            $term1,
            $term2,
        ]);
        // The root forum.
        $prophecy = $this->prophesize('Drupal\\taxonomy\\VocabularyInterface');
        $prophecy->label()
            ->willReturn('Fora_is_the_plural_of_forum');
        $prophecy->id()
            ->willReturn(5);
        $prophecy->getCacheTags()
            ->willReturn([
            'taxonomy_vocabulary:5',
        ]);
        $prophecy->getCacheContexts()
            ->willReturn([]);
        $prophecy->getCacheMaxAge()
            ->willReturn(Cache::PERMANENT);
        $vocab_storage = $this->createMock('Drupal\\Core\\Entity\\EntityStorageInterface');
        $vocab_storage->expects($this->any())
            ->method('load')
            ->willReturnMap([
            [
                'forums',
                $prophecy->reveal(),
            ],
        ]);
        $entity_type_manager = $this->getMockBuilder(EntityTypeManagerInterface::class)
            ->disableOriginalConstructor()
            ->getMock();
        $entity_type_manager->expects($this->any())
            ->method('getStorage')
            ->willReturnMap([
            [
                'taxonomy_vocabulary',
                $vocab_storage,
            ],
            [
                'taxonomy_term',
                $term_storage,
            ],
        ]);
        $config_factory = $this->getConfigFactoryStub([
            'forum.settings' => [
                'vocabulary' => 'forums',
            ],
        ]);
        $forum_manager = $this->createMock('Drupal\\forum\\ForumManagerInterface');
        // Build a breadcrumb builder to test.
        $breadcrumb_builder = new ForumListingBreadcrumbBuilder($entity_type_manager, $config_factory, $forum_manager, $translation_manager);
        // Add a translation manager for t().
        $translation_manager = $this->getStringTranslationStub();
        $breadcrumb_builder->setStringTranslation($translation_manager);
        // The forum listing we need a breadcrumb back from.
        $prophecy = $this->prophesize('Drupal\\taxonomy\\Entity\\Term');
        $prophecy->label()
            ->willReturn('You_should_not_see_this');
        $prophecy->id()
            ->willReturn(23);
        $prophecy->getCacheTags()
            ->willReturn([
            'taxonomy_term:23',
        ]);
        $prophecy->getCacheContexts()
            ->willReturn([]);
        $prophecy->getCacheMaxAge()
            ->willReturn(Cache::PERMANENT);
        $forum_listing = $prophecy->reveal();
        // Our data set.
        $route_match = $this->createMock('Drupal\\Core\\Routing\\RouteMatchInterface');
        $route_match->expects($this->exactly(2))
            ->method('getParameter')
            ->with('taxonomy_term')
            ->willReturn($forum_listing);
        // First test.
        $expected1 = [
            Link::createFromRoute('Home', '<front>'),
            Link::createFromRoute('Fora_is_the_plural_of_forum', 'forum.index'),
            Link::createFromRoute('Something', 'forum.page', [
                'taxonomy_term' => 1,
            ]),
        ];
        $breadcrumb = $breadcrumb_builder->build($route_match);
        $this->assertEquals($expected1, $breadcrumb->getLinks());
        $this->assertEqualsCanonicalizing([
            'route',
        ], $breadcrumb->getCacheContexts());
        $this->assertEqualsCanonicalizing([
            'taxonomy_term:1',
            'taxonomy_term:23',
            'taxonomy_vocabulary:5',
        ], $breadcrumb->getCacheTags());
        $this->assertEqualsCanonicalizing(Cache::PERMANENT, $breadcrumb->getCacheMaxAge());
        // Second test.
        $expected2 = [
            Link::createFromRoute('Home', '<front>'),
            Link::createFromRoute('Fora_is_the_plural_of_forum', 'forum.index'),
            Link::createFromRoute('Something else', 'forum.page', [
                'taxonomy_term' => 2,
            ]),
            Link::createFromRoute('Something', 'forum.page', [
                'taxonomy_term' => 1,
            ]),
        ];
        $breadcrumb = $breadcrumb_builder->build($route_match);
        $this->assertEquals($expected2, $breadcrumb->getLinks());
        $this->assertEqualsCanonicalizing([
            'route',
        ], $breadcrumb->getCacheContexts());
        $this->assertEqualsCanonicalizing([
            'taxonomy_term:1',
            'taxonomy_term:2',
            'taxonomy_term:23',
            'taxonomy_vocabulary:5',
        ], $breadcrumb->getCacheTags());
        $this->assertEquals(Cache::PERMANENT, $breadcrumb->getCacheMaxAge());
    }

}