gl-website-deployer/vendor/doctrine/rst-parser/tests/EnvironmentTest.php

<?php

declare(strict_types=1);

namespace Doctrine\Tests\RST;

use Doctrine\RST\Configuration;
use Doctrine\RST\Environment;
use PHPUnit\Framework\TestCase;
use Throwable;

/**
 * Unit testing for RST
 */
class EnvironmentTest extends TestCase
{
    public function testRelativeUrl(): void
    {
        $environment = new Environment(new Configuration());
        $environment->setCurrentFileName('path/to/something.rst');
        $environment->setCurrentDirectory('input/dir');

        self::assertSame('path/to/something.rst', $environment->getCurrentFileName());
        self::assertSame('input/dir', $environment->getCurrentDirectory());

        // Assert that rules of relative url are respected
        self::assertSame($environment->relativeUrl('test.jpg'), 'test.jpg');
        self::assertSame($environment->relativeUrl('/path/to/test.jpg'), 'test.jpg');
        self::assertSame($environment->relativeUrl('/path/x/test.jpg'), '../../path/x/test.jpg');
        self::assertSame($environment->relativeUrl('/test.jpg'), '../../test.jpg');
        self::assertSame($environment->relativeUrl('http://example.com/test.jpg'), 'http://example.com/test.jpg');
        self::assertSame($environment->relativeUrl('imgs/test.jpg'), 'imgs/test.jpg');
        self::assertSame($environment->relativeUrl('/imgs/test.jpg'), '../../imgs/test.jpg');
    }

    public function testAbsoluteUrl(): void
    {
        $environment = new Environment(new Configuration());
        $environment->setCurrentFileName('path/to/something.rst');
        $environment->setCurrentDirectory('input/dir');

        self::assertSame('/test', $environment->absoluteUrl('/test'));
        self::assertSame('path/to/test', $environment->absoluteUrl('test'));
    }

    public function testCanonicalUrl(): void
    {
        $environment = new Environment(new Configuration());
        $environment->setCurrentFileName('subdir1/subdir2/test.rst');

        self::assertSame($environment->canonicalUrl('subdir1/subdir2/test.rst'), 'subdir1/subdir2/test.rst');
        self::assertSame($environment->canonicalUrl('test.rst'), 'subdir1/subdir2/test.rst');
        self::assertSame($environment->canonicalUrl('../index.rst'), 'subdir1/index.rst');
        self::assertSame($environment->canonicalUrl('../../index.rst'), 'index.rst');
    }

    /** @dataProvider getMissingSectionTests */
    public function testResolveForMissingSection(string $expectedMessage, ?string $currentFilename): void
    {
        $this->expectException(Throwable::class);
        $this->expectExceptionMessage($expectedMessage);
        $configuration = new Configuration();
        $configuration->silentOnError(true);
        $environment = new Environment($configuration);
        if ($currentFilename !== null) {
            $environment->setCurrentFileName($currentFilename);
        }

        $environment->resolve('doc', '/path/to/unknown/doc');
    }

    /** @return iterable<string, array{string, string|null}> */
    public function getMissingSectionTests(): iterable
    {
        yield 'no_current_filename' => [
            'Unknown reference section "doc"',
            null,
        ];

        yield 'with_current_filename' => [
            'Unknown reference section "doc" in file "current_doc_filename"',
            'current_doc_filename',
        ];
    }

    /** @dataProvider getTextsAndSlugs */
    public function testSlugify(string $text, string $expectedSlug): void
    {
        self::assertSame($expectedSlug, Environment::slugify($text));
    }

    /** @return iterable<string, array{string, string}> */
    public function getTextsAndSlugs(): iterable
    {
        yield 'empty string' => [
            '',
            '',
        ];

        yield 'string with white spaces only' => [
            '   ',
            '',
        ];

        yield 'already slugged text' => [
            'setting-up-a-database',
            'setting-up-a-database',
        ];

        yield 'English text' => [
            'Setting up a Database',
            'setting-up-a-database',
        ];

        yield 'Japanese text' => [
            'データベースをセットアップする',
            'detabesuwosettoappusuru',
        ];

        yield 'Ukrainian text' => [
            'Налаштування бази даних',
            'nalastuvanna-bazi-danih',
        ];
    }
}