v0.1 implementation

Author: Asisyas

.gitignore

@@ -0,0 +1,3 @@
+vendor/
+composer.lock
+.phpunit.result.cache

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Komar Stanislau
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

composer.json

@@ -0,0 +1,22 @@
+{
+    "name": "micro/plugin-uuid",
+    "description": "Micro Framework - plugin for UUID support",
+    "type": "library",
+    "license": "MIT",
+    "version": "0.1",
+    "autoload": {
+        "psr-4": {
+            "Micro\\Plugin\\Uuid\\": "src/"
+        }
+    },
+    "authors": [
+        {
+            "name": "Stanislau.Komar",
+            "email": "[email protected]"
+        }
+    ],
+    "minimum-stability": "stable",
+    "require": {
+        "ramsey/uuid": "^4.2"
+    }
+}

src/Business/UuidExtractor.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace Micro\Plugin\Uuid\Business\Uuid;
+
+use Ramsey\Uuid\Uuid;
+
+class UuidExtractor implements UuidExtractorInterface
+{
+    /**
+     * {@inheritDoc}
+     */
+    public function fromString(string $uuid): string
+    {
+        return Uuid::fromString($uuid)->toString();
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function fromBytes(string $bytes): string
+    {
+        return Uuid::fromBytes($bytes)->toString();
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function fromInteger(string $integer): string
+    {
+        return Uuid::fromInteger($integer)->toString();
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function fromDatetime(\DateTimeInterface $dateTime): string
+    {
+        return Uuid::fromDateTime($dateTime)->toString();
+    }
+}

src/Business/UuidExtractorFactory.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace Micro\Plugin\Uuid\Business\Uuid;
+
+class UuidExtractorFactory implements UuidExtractorFactoryInterface
+{
+    /**
+     * {@inheritDoc}
+     */
+    public function create(): UuidExtractorInterface
+    {
+        return new UuidExtractor();
+    }
+}

src/Business/UuidExtractorFactoryInterface.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace Micro\Plugin\Uuid\Business\Uuid;
+
+interface UuidExtractorFactoryInterface
+{
+    /**
+     * @return UuidExtractorInterface
+     */
+    public function create(): UuidExtractorInterface;
+}

src/Business/UuidExtractorInterface.php

@@ -0,0 +1,42 @@
+<?php
+
+namespace Micro\Plugin\Uuid\Business\Uuid;
+
+interface UuidExtractorInterface
+{
+    /**
+     * Creates a UUID from a string UUID.
+     *
+     * @param string $source
+     *
+     * @return string
+     */
+    public function fromString(string $source): string;
+
+    /**
+     * Creates a UUID from a 16-byte string.
+     *
+     * @param string $bytes
+     *
+     * @return string
+     */
+    public function fromBytes(string $bytes): string;
+
+    /**
+     * Creates a UUID from a string integer.
+     *
+     * @param string $integer
+     *
+     * @return string
+     */
+    public function fromInteger(string $integer): string;
+
+    /**
+     * Creates a UUID from a DateTimeInterface instance
+     *
+     * @param \DateTimeInterface $dateTime
+     *
+     * @return string
+     */
+    public function fromDatetime(\DateTimeInterface $dateTime): string;
+}

src/Business/UuidGenerator.php

@@ -0,0 +1,58 @@
+<?php
+
+namespace Micro\Plugin\Uuid\Business\Uuid;
+
+use Ramsey\Uuid\Uuid;
+
+class UuidGenerator implements UuidGeneratorInterface
+{
+    /**
+     * {@inheritDoc}
+     */
+    public function v1(): string
+    {
+        return Uuid::uuid1()->toString();
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function v3(string $namespace): string
+    {
+        return Uuid::uuid3($this->getUuidConstant($namespace), php_uname('n'))->toString();
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function v4(): string
+    {
+        return Uuid::uuid4()->toString();
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function v5(string $namespace): string
+    {
+        return Uuid::uuid5($this->getUuidConstant($namespace), php_uname('n'))->toString();
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function v6(): string
+    {
+        return Uuid::uuid6()->toString();
+    }
+
+    /**
+     * @param string $constName
+     *
+     * @return mixed
+     */
+    protected function getUuidConstant(string $constName): string
+    {
+        return constant(Uuid::class . "::" . $constName);
+    }
+}

src/Business/UuidGeneratorFactory.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace Micro\Plugin\Uuid\Business\Uuid;
+
+class UuidGeneratorFactory implements UuidGeneratorFactoryInterface
+{
+    /**
+     * {@inheritDoc}
+     */
+    public function create(): UuidGeneratorInterface
+    {
+        return new UuidGenerator();
+    }
+}

src/Business/UuidGeneratorFactoryInterface.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace Micro\Plugin\Uuid\Business\Uuid;
+
+interface UuidGeneratorFactoryInterface
+{
+    /**
+     * @return UuidGeneratorInterface
+     */
+    public function create(): UuidGeneratorInterface;
+}