Update website

2024-11-19 08:02:04 +01:00 · 2024-11-19 08:02:04 +01:00 · 1d90fbf296
commit 1d90fbf296
parent 4413528994
6865 changed files with 1091082 additions and 0 deletions
--- a/vendor/doctrine/rst-parser/tests/EnvironmentTest.php
+++ b/vendor/doctrine/rst-parser/tests/EnvironmentTest.php
@ -0,0 +1,125 @@
+<?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',
+        ];
+    }
+}