From 2ec28dd736ac58606e110bda2c4dbc84672c2c3e Mon Sep 17 00:00:00 2001
From: Matias Navarro Carter <mnavarrocarter@gmail.com>
Date: Fri, 26 Jul 2019 23:42:46 -0400
Subject: [PATCH] Function api created

Function api is a set of simple autoloaded functions to create uuids proxying the Uuid class static methods.

They provide easy and clean ways of just creating string represented uuids instead of the class.
---
 composer.json     |  5 +++-
 src/functions.php | 59 +++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 63 insertions(+), 1 deletion(-)
 create mode 100644 src/functions.php

diff --git a/composer.json b/composer.json
index ee0162e..5319644 100644
--- a/composer.json
+++ b/composer.json
@@ -62,7 +62,10 @@
     "autoload": {
         "psr-4": {
             "Ramsey\\Uuid\\": "src/"
-        }
+        },
+        "files": [
+            "src/functions.php"
+        ]
     },
     "autoload-dev": {
         "psr-4": {
diff --git a/src/functions.php b/src/functions.php
new file mode 100644
index 0000000..d8c194b
--- /dev/null
+++ b/src/functions.php
@@ -0,0 +1,59 @@
+<?php
+
+namespace Ramsey\Uuid;
+
+/**
+ * Generate a version 1 UUID from a host ID, sequence number, and the current time.
+ *
+ * @param int|string|null $node A 48-bit number representing the hardware address
+ *     This number may be represented as an integer or a hexadecimal string.
+ * @param int|null $clockSeq A 14-bit number used to help avoid duplicates that
+ *     could arise when the clock is set backwards in time or if the node ID
+ *     changes.
+ * @return string
+ * @throws \Ramsey\Uuid\Exception\UnsatisfiedDependencyException if called on a 32-bit system and
+ *     `Moontoast\Math\BigNumber` is not present
+ * @throws \InvalidArgumentException
+ * @throws \Exception if it was not possible to gather sufficient entropy
+ */
+function v1($node = null, $clockSeq = null): string {
+    return (string) Uuid::uuid1($node, $clockSeq);
+}
+
+/**
+ * Generate a version 3 UUID based on the MD5 hash of a namespace identifier
+ * (which is a UUID) and a name (which is a string).
+ *
+ * @param string $ns The UUID namespace in which to create the named UUID
+ * @param string $name The name to create a UUID for
+ * @return string
+ * @throws \Ramsey\Uuid\Exception\InvalidUuidStringException
+ */
+function v3($ns, $name): string {
+    return (string) Uuid::uuid3($ns, $name);
+}
+
+/**
+ * Generate a version 4 (random) UUID.
+ *
+ * @return string
+ * @throws \Ramsey\Uuid\Exception\UnsatisfiedDependencyException if `Moontoast\Math\BigNumber` is not present
+ * @throws \InvalidArgumentException
+ * @throws \Exception
+ */
+function v4(): string {
+    return (string) Uuid::uuid4();
+}
+
+/**
+ * Generate a version 5 UUID based on the SHA-1 hash of a namespace
+ * identifier (which is a UUID) and a name (which is a string).
+ *
+ * @param string $ns The UUID namespace in which to create the named UUID
+ * @param string $name The name to create a UUID for
+ * @return string
+ * @throws \Ramsey\Uuid\Exception\InvalidUuidStringException
+ */
+function v5($ns, $name): string {
+    return (string) Uuid::uuid5($ns, $name);
+}
\ No newline at end of file