php-uuid/tests/Type/HexadecimalTest.php

<?php

declare(strict_types=1);

namespace Ramsey\Uuid\Test\Type;

use PHPUnit\Framework\Attributes\DataProvider;
use Ramsey\Uuid\Exception\InvalidArgumentException;
use Ramsey\Uuid\Test\TestCase;
use Ramsey\Uuid\Type\Hexadecimal;

use function json_encode;
use function serialize;
use function sprintf;
use function unserialize;

class HexadecimalTest extends TestCase
{
    /**
     * @param Hexadecimal|non-empty-string $value
     */
    #[DataProvider('provideHex')]
    public function testHexadecimalType(Hexadecimal | string $value, string $expected): void
    {
        $hexadecimal = new Hexadecimal($value);

        $this->assertSame($expected, $hexadecimal->toString());
        $this->assertSame($expected, (string) $hexadecimal);
    }

    /**
     * @return array<array{value: Hexadecimal | non-empty-string, expected: string}>
     */
    public static function provideHex(): array
    {
        return [
            [
                'value' => '0xFFFF',
                'expected' => 'ffff',
            ],
            [
                'value' => '0123456789abcdef',
                'expected' => '0123456789abcdef',
            ],
            [
                'value' => 'ABCDEF',
                'expected' => 'abcdef',
            ],
            [
                'value' => new Hexadecimal('ABCDEF'),
                'expected' => 'abcdef',
            ],
        ];
    }

    /**
     * @param non-empty-string $value
     */
    #[DataProvider('provideHexBadValues')]
    public function testHexadecimalTypeThrowsExceptionForBadValues(string $value): void
    {
        $this->expectException(InvalidArgumentException::class);
        $this->expectExceptionMessage(
            'Value must be a hexadecimal number'
        );

        new Hexadecimal($value);
    }

    /**
     * @return array<array{string}>
     */
    public static function provideHexBadValues(): array
    {
        return [
            ['-123456.789'],
            ['123456.789'],
            ['foobar'],
            ['0xfoobar'],
        ];
    }

    /**
     * @param Hexadecimal|non-empty-string $value
     */
    #[DataProvider('provideHex')]
    public function testSerializeUnserializeHexadecimal(Hexadecimal | string $value, string $expected): void
    {
        $hexadecimal = new Hexadecimal($value);
        $serializedHexadecimal = serialize($hexadecimal);

        /** @var Hexadecimal $unserializedHexadecimal */
        $unserializedHexadecimal = unserialize($serializedHexadecimal);

        $this->assertSame($expected, $unserializedHexadecimal->toString());
    }

    /**
     * @param Hexadecimal|non-empty-string $value
     */
    #[DataProvider('provideHex')]
    public function testJsonSerialize(Hexadecimal | string $value, string $expected): void
    {
        $hexadecimal = new Hexadecimal($value);
        $expectedJson = sprintf('"%s"', $expected);

        $this->assertSame($expectedJson, json_encode($hexadecimal));
    }
}