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.

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);
+}