Support version 6 UUIDs

See the following: * https://github.com/uuid6/uuid6-ietf-draft * http://gh.peabody.io/uuidv6/
2026-06-16 16:17:43 +03:00 · 2020-02-22 22:41:15 -06:00
parent 65b0c091c0
commit cc2bf6f8ef
12 changed files with 473 additions and 4 deletions
@@ -0,0 +1,160 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Ramsey\Uuid\Test\Nonstandard;
+
+use DateTimeImmutable;
+use Mockery;
+use Ramsey\Uuid\Codec\CodecInterface;
+use Ramsey\Uuid\Converter\NumberConverterInterface;
+use Ramsey\Uuid\Converter\TimeConverterInterface;
+use Ramsey\Uuid\Exception\InvalidArgumentException;
+use Ramsey\Uuid\Nonstandard\UuidV6;
+use Ramsey\Uuid\Rfc4122\FieldsInterface;
+use Ramsey\Uuid\Rfc4122\UuidV1;
+use Ramsey\Uuid\Test\TestCase;
+use Ramsey\Uuid\Uuid;
+
+class UuidV6Test extends TestCase
+{
+    /**
+     * @dataProvider provideTestVersions
+     */
+    public function testConstructorThrowsExceptionWhenFieldsAreNotValidForType(int $version): void
+    {
+        $fields = Mockery::mock(FieldsInterface::class, [
+            'getVersion' => $version,
+        ]);
+
+        $numberConverter = Mockery::mock(NumberConverterInterface::class);
+        $codec = Mockery::mock(CodecInterface::class);
+        $timeConverter = Mockery::mock(TimeConverterInterface::class);
+
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage(
+            'Fields used to create a UuidV6 must represent a '
+            . 'version 6 (ordered-time) UUID'
+        );
+
+        new UuidV6($fields, $numberConverter, $codec, $timeConverter);
+    }
+
+    /**
+     * @phpcsSuppress SlevomatCodingStandard.TypeHints.ReturnTypeHint.MissingTraversableTypeHintSpecification
+     */
+    public function provideTestVersions(): array
+    {
+        return [
+            ['version' => 0],
+            ['version' => 1],
+            ['version' => 2],
+            ['version' => 3],
+            ['version' => 4],
+            ['version' => 5],
+            ['version' => 7],
+            ['version' => 8],
+            ['version' => 9],
+        ];
+    }
+
+    /**
+     * @dataProvider provideUuidV6WithOddMicroseconds
+     */
+    public function testGetDateTimeProperlyHandlesLongMicroseconds(string $uuid, string $expected): void
+    {
+        /** @var UuidV6 $object */
+        $object = Uuid::fromString($uuid);
+
+        $date = $object->getDateTime();
+
+        $this->assertInstanceOf(DateTimeImmutable::class, $date);
+        $this->assertSame($expected, $date->format('U.u'));
+    }
+
+    /**
+     * @phpcsSuppress SlevomatCodingStandard.TypeHints.ReturnTypeHint.MissingTraversableTypeHintSpecification
+     */
+    public function provideUuidV6WithOddMicroseconds(): array
+    {
+        return [
+            [
+                'uuid' => '1b21dd21-4814-6000-9669-00007ffffffe',
+                'expected' => '1.677722',
+            ],
+            [
+                'uuid' => '1b21dd21-3714-6000-9669-00007ffffffe',
+                'expected' => '0.104858',
+            ],
+            [
+                'uuid' => '1b21dd21-3713-6000-9669-00007ffffffe',
+                'expected' => '0.105267',
+            ],
+            [
+                'uuid' => '1b21dd21-2e8a-6980-8d4f-acde48001122',
+                'expected' => '-1.000000',
+            ],
+        ];
+    }
+
+    /**
+     * @dataProvider provideUuidV1UuidV6Equivalents
+     */
+    public function testToUuidV1(string $uuidv6, string $uuidv1): void
+    {
+        /** @var UuidV6 $uuid6 */
+        $uuid6 = Uuid::fromString($uuidv6);
+        $uuid1 = $uuid6->toUuidV1();
+
+        $this->assertSame($uuidv6, $uuid6->toString());
+        $this->assertSame($uuidv1, $uuid1->toString());
+
+        $this->assertSame(
+            $uuid6->getDateTime()->format('U.u'),
+            $uuid1->getDateTime()->format('U.u')
+        );
+    }
+
+    /**
+     * @dataProvider provideUuidV1UuidV6Equivalents
+     */
+    public function testFromUuidV1(string $uuidv6, string $uuidv1): void
+    {
+        /** @var UuidV1 $uuid1 */
+        $uuid1 = Uuid::fromString($uuidv1);
+        $uuid6 = UuidV6::fromUuidV1($uuid1);
+
+        $this->assertSame($uuidv1, $uuid1->toString());
+        $this->assertSame($uuidv6, $uuid6->toString());
+
+        $this->assertSame(
+            $uuid1->getDateTime()->format('U.u'),
+            $uuid6->getDateTime()->format('U.u')
+        );
+    }
+
+    /**
+     * @phpcsSuppress SlevomatCodingStandard.TypeHints.ReturnTypeHint.MissingTraversableTypeHintSpecification
+     */
+    public function provideUuidV1UuidV6Equivalents(): array
+    {
+        return [
+            [
+                'uuidv6' => '1b21dd21-4814-6000-9669-00007ffffffe',
+                'uuidv1' => '14814000-1dd2-11b2-9669-00007ffffffe',
+            ],
+            [
+                'uuidv6' => '1b21dd21-3714-6000-9669-00007ffffffe',
+                'uuidv1' => '13714000-1dd2-11b2-9669-00007ffffffe',
+            ],
+            [
+                'uuidv6' => '1b21dd21-3713-6000-9669-00007ffffffe',
+                'uuidv1' => '13713000-1dd2-11b2-9669-00007ffffffe',
+            ],
+            [
+                'uuidv6' => '1b21dd21-2e8a-6980-8d4f-acde48001122',
+                'uuidv1' => '12e8a980-1dd2-11b2-8d4f-acde48001122',
+            ],
+        ];
+    }
+}