create-prisma-php-app 1.0.0

package/vendor/ramsey/uuid/docs/reference/rfc4122-fieldsinterface.rst

@@ -0,0 +1,78 @@
+.. _reference.rfc4122.fieldsinterface:
+
+========================
+Rfc4122\\FieldsInterface
+========================
+
+.. php:namespace:: Ramsey\Uuid\Rfc4122
+
+.. php:interface:: FieldsInterface
+
+    Implements :php:interface:`Ramsey\\Uuid\\Fields\\FieldsInterface`.
+
+    Rfc4122\FieldsInterface represents the fields of an RFC 4122 UUID.
+    In addition to the methods defined on the interface, this class additionally
+    defines the following methods.
+
+    .. php:method:: getClockSeq()
+
+        :returns: The full 16-bit clock sequence, with the variant bits (two most significant bits) masked out.
+        :returntype: Ramsey\\Uuid\\Type\\Hexadecimal
+
+    .. php:method:: getClockSeqHiAndReserved()
+
+        :returns: The high field of the clock sequence multiplexed with the variant.
+        :returntype: Ramsey\\Uuid\\Type\\Hexadecimal
+
+    .. php:method:: getClockSeqLow()
+
+        :returns: The low field of the clock sequence.
+        :returntype: Ramsey\\Uuid\\Type\\Hexadecimal
+
+    .. php:method:: getNode()
+
+        :returns: The node field.
+        :returntype: Ramsey\\Uuid\\Type\\Hexadecimal
+
+    .. php:method:: getTimeHiAndVersion()
+
+        :returns: The high field of the timestamp multiplexed with the version.
+        :returntype: Ramsey\\Uuid\\Type\\Hexadecimal
+
+    .. php:method:: getTimeLow()
+
+        :returns: The low field of the timestamp.
+        :returntype: Ramsey\\Uuid\\Type\\Hexadecimal
+
+    .. php:method:: getTimeMid()
+
+        :returns: The middle field of the timestamp.
+        :returntype: Ramsey\\Uuid\\Type\\Hexadecimal
+
+    .. php:method:: getTimestamp()
+
+        :returns: The full 60-bit timestamp, without the version.
+        :returntype: Ramsey\\Uuid\\Type\\Hexadecimal
+
+    .. php:method:: getVariant()
+
+        Returns the variant, which, for RFC 4122 variant UUIDs, should always be
+        the value ``2``.
+
+        :returns: The UUID variant.
+        :returntype: Ramsey\\Uuid\\Variant
+
+    .. php:method:: getVersion()
+
+        :returns: The UUID version.
+        :returntype: Ramsey\\Uuid\\Rfc4122\\Version
+        :returntype: ``null``
+
+    .. php:method:: isNil()
+
+        A *nil* UUID is a special type of UUID with all 128 bits set to zero.
+        Its string standard representation is always
+        ``00000000-0000-0000-0000-000000000000``.
+
+        :returns: True if this UUID represents a nil UUID.
+        :returntype: ``bool``

package/vendor/ramsey/uuid/docs/reference/rfc4122-uuidinterface.rst

@@ -0,0 +1,20 @@
+.. _reference.rfc4122.uuidinterface:
+
+======================
+Rfc4122\\UuidInterface
+======================
+
+.. php:namespace:: Ramsey\Uuid\Rfc4122
+
+.. php:interface:: UuidInterface
+
+    Implements :php:interface:`Ramsey\\Uuid\\UuidInterface`.
+
+    Rfc4122\UuidInterface represents an RFC 4122 UUID. In addition to the
+    methods defined on the interface, this interface additionally defines the
+    following methods.
+
+    .. php:method:: getFields()
+
+        :returns: The fields that comprise this UUID.
+        :returntype: Ramsey\\Uuid\\Rfc4122\\FieldsInterface

package/vendor/ramsey/uuid/docs/reference/rfc4122-uuidv1.rst

@@ -0,0 +1,21 @@
+.. _reference.rfc4122.uuidv1:
+
+===============
+Rfc4122\\UuidV1
+===============
+
+.. php:namespace:: Ramsey\Uuid\Rfc4122
+
+.. php:class:: UuidV1
+
+    Implements :php:interface:`Ramsey\\Uuid\\Rfc4122\\UuidInterface` and
+    :php:interface:`Ramsey\\Uuid\\TimeBasedUuidInterface`.
+
+    UuidV1 represents a :ref:`version 1, Gregorian time UUID <rfc4122.version1>`.
+    In addition to providing the methods defined on the interface, this class
+    additionally provides the following methods.
+
+    .. php:method:: getDateTime()
+
+        :returns: A date object representing the timestamp associated with the UUID.
+        :returntype: ``\DateTimeInterface``

package/vendor/ramsey/uuid/docs/reference/rfc4122-uuidv2.rst

@@ -0,0 +1,47 @@
+.. _reference.rfc4122.uuidv2:
+
+===============
+Rfc4122\\UuidV2
+===============
+
+.. php:namespace:: Ramsey\Uuid\Rfc4122
+
+.. php:class:: UuidV2
+
+    Implements :php:interface:`Ramsey\\Uuid\\Rfc4122\\UuidInterface`.
+
+    UuidV2 represents a :ref:`version 2, DCE Security UUID <rfc4122.version2>`.
+    In addition to providing the methods defined on the interface, this class
+    additionally provides the following methods.
+
+    .. php:method:: getDateTime()
+
+        Returns a `DateTimeInterface <https://www.php.net/datetimeinterface>`_
+        instance representing the timestamp associated with the UUID
+
+        .. caution::
+
+            It is important to note that version 2 UUIDs suffer from some loss
+            of timestamp precision. See :ref:`rfc4122.version2.timestamp-problems`
+            to learn more.
+
+        :returns: A date object representing the timestamp associated with the UUID
+        :returntype: ``\DateTimeInterface``
+
+    .. php:method:: getLocalDomain()
+
+        :returns: The local domain identifier for this UUID, which is one of
+                  :php:const:`Ramsey\\Uuid\\Uuid::DCE_DOMAIN_PERSON`,
+                  :php:const:`Ramsey\\Uuid\\Uuid::DCE_DOMAIN_GROUP`, or
+                  :php:const:`Ramsey\\Uuid\\Uuid::DCE_DOMAIN_ORG`
+        :returntype: ``int``
+
+    .. php:method:: getLocalDomainName()
+
+        :returns: A string name associated with the local domain identifier (one of "person," "group," or "org")
+        :returntype: ``string``
+
+    .. php:method:: getLocalIdentifier()
+
+        :returns: The local identifier used when creating this UUID
+        :returntype: Ramsey\\Uuid\\Type\\Integer

package/vendor/ramsey/uuid/docs/reference/rfc4122-uuidv3.rst

@@ -0,0 +1,13 @@
+.. _reference.rfc4122.uuidv3:
+
+===============
+Rfc4122\\UuidV3
+===============
+
+.. php:namespace:: Ramsey\Uuid\Rfc4122
+
+.. php:class:: UuidV3
+
+    Implements :php:interface:`Ramsey\\Uuid\\Rfc4122\\UuidInterface`.
+
+    UuidV3 represents a :ref:`version 3, name-based (MD5) UUID <rfc4122.version3>`.

package/vendor/ramsey/uuid/docs/reference/rfc4122-uuidv4.rst

@@ -0,0 +1,13 @@
+.. _reference.rfc4122.uuidv4:
+
+===============
+Rfc4122\\UuidV4
+===============
+
+.. php:namespace:: Ramsey\Uuid\Rfc4122
+
+.. php:class:: UuidV4
+
+    Implements :php:interface:`Ramsey\\Uuid\\Rfc4122\\UuidInterface`.
+
+    UuidV4 represents a :ref:`version 4, random UUID <rfc4122.version4>`.

package/vendor/ramsey/uuid/docs/reference/rfc4122-uuidv5.rst

@@ -0,0 +1,13 @@
+.. _reference.rfc4122.uuidv5:
+
+===============
+Rfc4122\\UuidV5
+===============
+
+.. php:namespace:: Ramsey\Uuid\Rfc4122
+
+.. php:class:: UuidV5
+
+    Implements :php:interface:`Ramsey\\Uuid\\Rfc4122\\UuidInterface`.
+
+    UuidV5 represents a :ref:`version 5, name-based (SHA-1) UUID <rfc4122.version5>`.

package/vendor/ramsey/uuid/docs/reference/rfc4122-uuidv6.rst

@@ -0,0 +1,31 @@
+.. _reference.rfc4122.uuidv6:
+
+===============
+Rfc4122\\UuidV6
+===============
+
+.. php:namespace:: Ramsey\Uuid\Rfc4122
+
+.. php:class:: UuidV6
+
+    Implements :php:interface:`Ramsey\\Uuid\\Rfc4122\\UuidInterface`.
+
+    UuidV6 represents a :ref:`version 6, reordered time UUID
+    <rfc4122.version6>`. In addition to providing the methods defined on the
+    interface, this class additionally provides the following methods.
+
+    .. php:method:: getDateTime()
+
+        :returns: A date object representing the timestamp associated with the UUID
+        :returntype: ``\DateTimeInterface``
+
+    .. php:method:: toUuidV1()
+
+        :returns: A version 1 UUID, converted from this version 6 UUID
+        :returntype: Ramsey\\Uuid\\Rfc4122\\UuidV1
+
+    .. php:staticmethod:: fromUuidV1()
+
+        :param Ramsey\\Uuid\\Rfc4122\\UuidV1 $uuidV1: A version 1 UUID
+        :returns: A version 6 UUID, converted from the given version 1 UUID
+        :returntype: Ramsey\\Uuid\\Rfc4122\\UuidV6

package/vendor/ramsey/uuid/docs/reference/rfc4122-uuidv7.rst

@@ -0,0 +1,20 @@
+.. _reference.rfc4122.uuidv7:
+
+===============
+Rfc4122\\UuidV7
+===============
+
+.. php:namespace:: Ramsey\Uuid\Rfc4122
+
+.. php:class:: UuidV7
+
+    Implements :php:interface:`Ramsey\\Uuid\\Rfc4122\\UuidInterface`.
+
+    UuidV7 represents a :ref:`version 7, Unix Epoch time UUID <rfc4122.version7>`.
+    In addition to providing the methods defined on the interface, this class
+    additionally provides the following methods.
+
+    .. php:method:: getDateTime()
+
+        :returns: A date object representing the timestamp associated with the UUID.
+        :returntype: ``\DateTimeInterface``

package/vendor/ramsey/uuid/docs/reference/rfc4122-uuidv8.rst

@@ -0,0 +1,13 @@
+.. _reference.rfc4122.uuidv8:
+
+===============
+Rfc4122\\UuidV8
+===============
+
+.. php:namespace:: Ramsey\Uuid\Rfc4122
+
+.. php:class:: UuidV8
+
+    Implements :php:interface:`Ramsey\\Uuid\\Rfc4122\\UuidInterface`.
+
+    UuidV8 represents a :ref:`version 8, custom UUID <rfc4122.version8>`.

package/vendor/ramsey/uuid/docs/reference/rfc4122-version.rst

@@ -0,0 +1,87 @@
+.. _reference.rfc4122.version:
+
+================
+Rfc4122\\Version
+================
+
+.. php:namespace:: Ramsey\Uuid\Rfc4122
+
+.. php:enum:: Version : int
+
+    The version number describes how the UUID was generated.
+
+    .. php:case:: Time : 1
+
+        A version 1 UUID uses a timestamp based on the Gregorian calendar epoch,
+        along with the MAC address (or *node*) for a network interface on the
+        local machine. For more details, see :ref:`rfc4122.version1`.
+
+    .. php:case:: DceSecurity : 2
+
+        Like a version 1 UUID, a version 2 UUID uses the current time, along
+        with the MAC address (or *node*) for a network interface on the local
+        machine. Additionally, a version 2 UUID replaces the low part of the
+        time field with a local identifier such as the user ID or group ID of
+        the local account that created the UUID. For more details, see
+        :ref:`rfc4122.version2`.
+
+    .. php:case:: HashMd5 : 3
+
+        Name-based UUIDs combine a namespace with a name. This way, the UUIDs
+        are unique to the namespace they're created in. Version 3 UUIDs use the
+        MD5 hashing algorithm to combine the namespace and name. For more
+        details, see :ref:`rfc4122.version3`.
+
+    .. php:case:: Random : 4
+
+        Version 4 UUIDs are randomly-generated identifiers. For more details,
+        see :ref:`rfc4122.version4`.
+
+    .. php:case:: HashSha1 : 5
+
+        Name-based UUIDs combine a namespace with a name. This way, the UUIDs
+        are unique to the namespace they're created in. Version 5 UUIDs use the
+        SHA-1 hashing algorithm to combine the namespace and name. For more
+        details, see :ref:`rfc4122.version5`.
+
+    .. php:case:: ReorderedTime : 6
+
+    .. php:case:: UnixTime : 7
+
+    .. php:case:: Custom : 8
+
+    .. php:const:: V1
+
+        An alias for :php:case:`Ramsey\\Uuid\\Rfc4122\\Version::Time`.
+
+    .. php:const:: V2
+
+        An alias for :php:case:`Ramsey\\Uuid\\Rfc4122\\Version::DceSecurity`.
+
+    .. php:const:: V3
+
+        An alias for :php:case:`Ramsey\\Uuid\\Rfc4122\\Version::HashMd4`.
+
+    .. php:const:: V4
+
+        An alias for :php:case:`Ramsey\\Uuid\\Rfc4122\\Version::Random`.
+
+    .. php:const:: V5
+
+        An alias for :php:case:`Ramsey\\Uuid\\Rfc4122\\Version::HashSha1`.
+
+    .. php:const:: V6
+
+        An alias for :php:case:`Ramsey\\Uuid\\Rfc4122\\Version::ReorderedTime`.
+
+    .. php:const:: V7
+
+        An alias for :php:case:`Ramsey\\Uuid\\Rfc4122\\Version::UnixTime`.
+
+    .. php:const:: V8
+
+        An alias for :php:case:`Ramsey\\Uuid\\Rfc4122\\Version::Custom`.
+
+    .. php:const:: Peabody
+
+        An alias for :php:case:`Ramsey\\Uuid\\Rfc4122\\Version::ReorderedTime`.

package/vendor/ramsey/uuid/docs/reference/timebaseduuidinterface.rst

@@ -0,0 +1,16 @@
+.. _reference.timebaseduuidinterface:
+
+======================
+TimeBasedUuidInterface
+======================
+
+.. php:namespace:: Ramsey\Uuid
+
+.. php:interface:: TimeBasedUuidInterface
+
+    Defines functionality for time-based UUIDs.
+
+    .. php:method:: getDateTime()
+
+        :returns: A date object representing the timestamp associated with the UUID.
+        :returntype: ``\DateTimeInterface``

package/vendor/ramsey/uuid/docs/reference/types.rst

@@ -0,0 +1,79 @@
+.. _reference.types:
+
+=====
+Types
+=====
+
+.. php:namespace:: Ramsey\Uuid\Type
+
+.. php:class:: TypeInterface
+
+    Implements `JsonSerializable <https://www.php.net/jsonserializable>`_ and
+    `Serializable <https://www.php.net/serializable>`_.
+
+    TypeInterface ensures consistency in typed values returned by ramsey/uuid.
+
+    .. php:method:: toString()
+
+        :returntype: ``string``
+
+    .. php:method:: __toString()
+
+        :returntype: ``string``
+
+.. php:class:: NumberInterface
+
+    Implements :php:interface:`Ramsey\\Uuid\\Type\\TypeInterface`.
+
+    NumberInterface ensures consistency in numeric values returned by ramsey/uuid.
+
+    .. php:method:: isNegative()
+
+        :returns: True if this number is less than zero, false otherwise.
+        :returntype: ``bool``
+
+.. php:class:: Decimal
+
+    Implements :php:interface:`Ramsey\\Uuid\\Type\\NumberInterface`.
+
+    A value object representing a decimal, for type-safety purposes, to ensure
+    that decimals returned from ramsey/uuid methods as strings are truly
+    decimals and not some other kind of string.
+
+    To support values as true decimals and not as floats or doubles, we store
+    the decimals as strings.
+
+.. php:class:: Hexadecimal
+
+    Implements :php:interface:`Ramsey\\Uuid\\Type\\TypeInterface`.
+
+    A value object representing a hexadecimal number, for type-safety purposes,
+    to ensure that hexadecimal numbers returned from ramsey/uuid methods as
+    strings are truly hexadecimal and not some other kind of string.
+
+.. php:class:: Integer
+
+    Implements :php:interface:`Ramsey\\Uuid\\Type\\NumberInterface`.
+
+    A value object representing an integer, for type-safety purposes, to ensure
+    that integers returned from ramsey/uuid methods as strings are truly
+    integers and not some other kind of string.
+
+    To support large integers beyond ``PHP_INT_MAX`` and ``PHP_INT_MIN`` on both
+    64-bit and 32-bit systems, we store the integers as strings.
+
+.. php:class:: Time
+
+    Implements :php:interface:`Ramsey\\Uuid\\Type\\TypeInterface`.
+
+    A value object representing a timestamp, for type-safety purposes, to ensure
+    that timestamps used by ramsey/uuid are truly timestamp integers and not
+    some other kind of string or integer.
+
+    .. php:method:: getSeconds()
+
+        :returntype: :php:class:`Ramsey\\Uuid\\Type\\Integer`
+
+    .. php:method:: getMicroseconds()
+
+        :returntype: :php:class:`Ramsey\\Uuid\\Type\\Integer`

package/vendor/ramsey/uuid/docs/reference/uuid.rst

@@ -0,0 +1,161 @@
+.. _reference.uuid:
+
+====
+Uuid
+====
+
+Ramsey\Uuid\Uuid provides static methods for the most common functionality for
+generating and working with UUIDs. It also provides constants used throughout
+the ramsey/uuid library.
+
+.. php:namespace:: Ramsey\Uuid
+
+.. php:class:: Uuid
+
+    .. php:const:: NAMESPACE_DNS
+
+        The name string is a fully-qualified domain name.
+
+    .. php:const:: NAMESPACE_URL
+
+        The name string is a URL.
+
+    .. php:const:: NAMESPACE_OID
+
+        The name string is an `ISO object identifier (OID)`_.
+
+    .. php:const:: NAMESPACE_X500
+
+        The name string is an `X.500`_ `DN`_ in `DER`_ or a text output format.
+
+    .. php:const:: NIL
+
+        The nil UUID is a special form of UUID that is specified to have all 128
+        bits set to zero.
+
+    .. php:const:: DCE_DOMAIN_PERSON
+
+        DCE Security principal (person) domain.
+
+    .. php:const:: DCE_DOMAIN_GROUP
+
+        DCE Security group domain.
+
+    .. php:const:: DCE_DOMAIN_ORG
+
+        DCE Security organization domain.
+
+    .. php:staticmethod:: uuid1([$node[, $clockSeq]])
+
+        Generates a version 1, Gregorian time UUID. See :ref:`rfc4122.version1`.
+
+        :param Ramsey\\Uuid\\Type\\Hexadecimal|null $node: An optional hexadecimal node to use
+        :param int|null $clockSeq: An optional clock sequence to use
+        :returns: A version 1 UUID
+        :returntype: Ramsey\\Uuid\\Rfc4122\\UuidV1
+
+    .. php:staticmethod:: uuid2($localDomain[, $localIdentifier[, $node[, $clockSeq]]])
+
+        Generates a version 2, DCE Security UUID. See :ref:`rfc4122.version2`.
+
+        :param int $localDomain: The local domain to use (one of :php:const:`Uuid::DCE_DOMAIN_PERSON`, :php:const:`Uuid::DCE_DOMAIN_GROUP`, or :php:const:`Uuid::DCE_DOMAIN_ORG`)
+        :param Ramsey\\Uuid\\Type\\Integer|null $localIdentifier: A local identifier for the domain (defaults to system UID or GID for *person* or *group*)
+        :param Ramsey\\Uuid\\Type\\Hexadecimal|null $node: An optional hexadecimal node to use
+        :param int|null $clockSeq: An optional clock sequence to use
+        :returns: A version 2 UUID
+        :returntype: Ramsey\\Uuid\\Rfc4122\\UuidV2
+
+    .. php:staticmethod:: uuid3($ns, $name)
+
+        Generates a version 3, name-based (MD5) UUID. See :ref:`rfc4122.version3`.
+
+        :param Ramsey\\Uuid\\UuidInterface|string $ns: The namespace for this identifier
+        :param string $name: The name from which to generate an identifier
+        :returns: A version 3 UUID
+        :returntype: Ramsey\\Uuid\\Rfc4122\\UuidV3
+
+    .. php:staticmethod:: uuid4()
+
+        Generates a version 4, random UUID. See :ref:`rfc4122.version4`.
+
+        :returns: A version 4 UUID
+        :returntype: Ramsey\\Uuid\\Rfc4122\\UuidV4
+
+    .. php:staticmethod:: uuid5($ns, $name)
+
+        Generates a version 5, name-based (SHA-1) UUID. See :ref:`rfc4122.version5`.
+
+        :param Ramsey\\Uuid\\UuidInterface|string $ns: The namespace for this identifier
+        :param string $name: The name from which to generate an identifier
+        :returns: A version 5 UUID
+        :returntype: Ramsey\\Uuid\\Rfc4122\\UuidV5
+
+    .. php:staticmethod:: uuid6([$node[, $clockSeq]])
+
+        Generates a version 6, reordered time UUID. See :ref:`rfc4122.version6`.
+
+        :param Ramsey\\Uuid\\Type\\Hexadecimal|null $node: An optional hexadecimal node to use
+        :param int|null $clockSeq: An optional clock sequence to use
+        :returns: A version 6 UUID
+        :returntype: Ramsey\\Uuid\\Rfc4122\\UuidV6
+
+    .. php:staticmethod:: uuid7([$dateTime])
+
+        Generates a version 7, Unix Epoch time UUID. See :ref:`rfc4122.version7`.
+
+        :param DateTimeInterface|null $dateTime: The date from which to create the UUID instance
+        :returns: A version 7 UUID
+        :returntype: Ramsey\\Uuid\\Rfc4122\\UuidV7
+
+    .. php:staticmethod:: fromString($uuid)
+
+        Creates an instance of UuidInterface from the string standard
+        representation.
+
+        :param string $uuid: The string standard representation of a UUID
+        :returntype: Ramsey\\Uuid\\UuidInterface
+
+    .. php:staticmethod:: fromBytes($bytes)
+
+        Creates an instance of UuidInterface from a 16-byte string.
+
+        :param string $bytes: A 16-byte binary string representation of a UUID
+        :returntype: Ramsey\\Uuid\\UuidInterface
+
+    .. php:staticmethod:: fromInteger($integer)
+
+        Creates an instance of UuidInterface from a 128-bit string integer.
+
+        :param string $integer: A 128-bit string integer representation of a UUID
+        :returntype: Ramsey\\Uuid\\UuidInterface
+
+    .. php:staticmethod:: fromDateTime($dateTime[, $node[, $clockSeq]])
+
+        Creates a version 1 UUID instance from a `DateTimeInterface
+        <https://www.php.net/datetimeinterface>`_ instance.
+
+        :param DateTimeInterface $dateTime: The date from which to create the UUID instance
+        :param Ramsey\\Uuid\\Type\\Hexadecimal|null $node: An optional hexadecimal node to use
+        :param int|null $clockSeq: An optional clock sequence to use
+        :returns: A version 1 UUID
+        :returntype: Ramsey\\Uuid\\Rfc4122\\UuidV1
+
+    .. php:staticmethod:: isValid($uuid)
+
+        Validates the string standard representation of a UUID.
+
+        :param string $uuid: The string standard representation of a UUID
+        :returntype: ``bool``
+
+    .. php:staticmethod:: setFactory($factory)
+
+        Sets the factory used to create UUIDs.
+
+        :param Ramsey\\Uuid\\UuidFactoryInterface $factory: A UUID factory to use for all UUID generation
+        :returntype: void
+
+
+.. _ISO object identifier (OID): http://www.oid-info.com
+.. _X.500: https://en.wikipedia.org/wiki/X.500
+.. _DN: https://en.wikipedia.org/wiki/Distinguished_Name
+.. _DER: https://www.itu.int/rec/T-REC-X.690/