create-prisma-php-app 1.0.0

package/vendor/ramsey/uuid/CHANGELOG.md

@@ -0,0 +1,1511 @@
+# ramsey/uuid Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
+and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
+
+## Unreleased
+
+### Added
+
+* Introduce `Ramsey\Uuid\TimeBasedUuidInterface` to represent any UUID based on
+  a date/time value.
+* Introduce `Ramsey\Uuid\TimeBasedUuidFactoryInterface` to represent any factory
+  for creating UUIDs based on a date/time value.
+* Introduce `Ramsey\Uuid\Variant` enum to represent the variant field.
+* Introduce `Ramsey\Uuid\Rfc4122\Version` enum to represent the version field.
+* Add new static method `Ramsey\Uuid\BinaryUtils::applyVersionAndVariant()`.
+
+### Changed
+
+* Remove the following deprecated classes and interfaces:
+  * `Ramsey\Uuid\Builder\BuilderCollection`
+  * `Ramsey\Uuid\Builder\DefaultUuidBuilder`
+  * `Ramsey\Uuid\Builder\DegradedUuidBuilder`
+  * `Ramsey\Uuid\Converter\Number\BigNumberConverter`
+  * `Ramsey\Uuid\Converter\Number\DegradedNumberConverter`
+  * `Ramsey\Uuid\Converter\Time\BigNumberTimeConverter`
+  * `Ramsey\Uuid\Converter\Time\DegradedTimeConverter`
+  * `Ramsey\Uuid\DegradedUuid`
+  * `Ramsey\Uuid\DeprecatedUuidFactoryInterface`
+  * `Ramsey\Uuid\Generator\RandomLibAdapter`
+  * `Ramsey\Uuid\Provider\Node\NodeProviderCollection`
+* Remove the following deprecated methods from Uuid classes:
+  * `getClockSeqHiAndReserved()`
+  * `getClockSeqHiAndReservedHex()`
+  * `getClockSeqLow()`
+  * `getClockSeqLowHex()`
+  * `getClockSequence()`
+  * `getClockSequenceHex()`
+  * `getDateTime()`
+  * `getFieldsHex()`
+  * `getLeastSignificantBits()`
+  * `getLeastSignificantBitsHex()`
+  * `getMostSignificantBits()`
+  * `getMostSignificantBitsHex()`
+  * `getNode()`
+  * `getNodeHex()`
+  * `getNumberConverter()`
+  * `getTimeHiAndVersion()`
+  * `getTimeHiAndVersionHex()`
+  * `getTimeLow()`
+  * `getTimeLowHex()`
+  * `getTimeMid()`
+  * `getTimeMidHex()`
+  * `getTimestamp()`
+  * `getTimestampHex()`
+  * `getVariant()`
+  * `getVersion()`
+* Remove the following deprecated constants:
+  * `Ramsey\Uuid\Uuid::RESERVED_NCS` (replaced with `Ramsey\Uuid\Variant::ReservedNcs` enum)
+  * `Ramsey\Uuid\Uuid::RFC_4122` (replaced with `Ramsey\Uuid\Variant::Rfc4122` enum)
+  * `Ramsey\Uuid\Uuid::RESERVED_MICROSOFT` (replaced with `Ramsey\Uuid\Variant::ReservedMicrosoft` enum)
+  * `Ramsey\Uuid\Uuid::RESERVED_FUTURE` (replaced with `Ramsey\Uuid\Variant::ReservedFuture` enum)
+  * `Ramsey\Uuid\Uuid::UUID_TYPE_TIME` (replaced with `Ramsey\Uuid\Rfc4122\Version::Time` enum)
+  * `Ramsey\Uuid\Uuid::UUID_TYPE_DCE_SECURITY` (replaced with `Ramsey\Uuid\Rfc4122\Version::DceSecurity` enum)
+  * `Ramsey\Uuid\Uuid::UUID_TYPE_HASH_MD5` (replaced with `Ramsey\Uuid\Rfc4122\Version::HashMd5` enum)
+  * `Ramsey\Uuid\Uuid::UUID_TYPE_RANDOM` (replaced with `Ramsey\Uuid\Rfc4122\Version::Random` enum)
+  * `Ramsey\Uuid\Uuid::UUID_TYPE_HASH_SHA1` (replaced with `Ramsey\Uuid\Rfc4122\Version::HashSha1` enum)
+  * `Ramsey\Uuid\Uuid::UUID_TYPE_PEABODY` (replaced with `Ramsey\Uuid\Rfc4122\Version::ReorderedTime` enum)
+  * `Ramsey\Uuid\Uuid::VALID_PATTERN`
+* Remove dependency on ramsey/collection package.
+
+
+## 4.7.4 - 2023-04-15
+
+### Fixed
+
+* Allow brick/math version `^0.11`.
+* Add explicit `Stringable` interface to `UuidInterface`.
+* Fix namespace conflict reported in [#490](https://github.com/ramsey/uuid/issues/490).
+* Fix unserialize error with `OrderedTimeCodec` reported in
+  [#494](https://github.com/ramsey/uuid/issues/494).
+
+
+## 4.7.3 - 2023-01-12
+
+### Fixed
+
+* The original 4.7.2 tag accidentally pointed to a commit in the 5.x branch. I
+  have replaced the 4.7.2 tag with a new tag that points to the correct commit,
+  but I am creating this tag to help notify users and automated processes who
+  might have already updated to the bad 4.7.2 tag.
+
+
+## 4.7.2 - 2023-01-12
+
+### Fixed
+
+* Amend Psalm assertion syntax on `Uuid::isValid()` to prevent incorrect type
+  inference ([#486](https://github.com/ramsey/uuid/pull/486)).
+* Re-tagged with the correct commit hash, since the first tag was pointing to
+  a commit in the 5.x branch.
+
+
+## 4.7.1 - 2022-12-31
+
+### Fixed
+
+* Allow the use of ramsey/collection ^2.0 with ramsey/uuid.
+
+
+## 4.7.0 - 2022-12-19
+
+### Added
+
+* Add `Uuid::fromHexadecimal()` and `UuidFactory::fromHexadecimal()`. These
+  methods are not required by the interfaces.
+
+### Fixed
+
+* Ignore MAC addresses consisting of all zeroes (i.e., `00:00:00:00:00:00`).
+
+
+## 4.6.0 - 2022-11-05
+
+### Added
+
+* Add support for version 8, Unix Epoch time UUIDs, as defined in
+  [draft-ietf-uuidrev-rfc4122bis-00, section 5.8][version8]. While still an
+  Internet-Draft, version 8 is stable and unlikely to change in any way that
+  breaks compatibility.
+  * Use `Ramsey\Uuid\Uuid::uuid8()` to generate version 8 UUIDs.
+  * Version 8 UUIDs are of type `Ramsey\Uuid\Rfc4122\UuidV8`.
+  * The constant `Ramsey\Uuid\Uuid::UUID_TYPE_CUSTOM` exists for version 8 UUIDs.
+
+### Fixed
+
+* Ensure monotonicity of version 7 UUIDs.
+
+
+## 4.5.1 - 2022-09-16
+
+### Fixed
+
+* Update RFC 4122 validator to recognize version 6 and 7 UUIDs.
+
+
+## 4.5.0 - 2022-09-15
+
+### Added
+
+* Promote version 6, reordered time UUIDs from the `Nonstandard` namespace to
+  the `Rfc4122` namespace. Version 6 UUIDs are defined in
+  [draft-ietf-uuidrev-rfc4122bis-00, section 5.6][version6]. While still an
+  Internet-Draft version 6 is stable and unlikely to change in any way that
+  breaks compatibility.
+* Add support for version 7, Unix Epoch time UUIDs, as defined in
+  [draft-ietf-uuidrev-rfc4122bis-00, section 5.7][version7]. While still an
+  Internet-Draft, version 7 is stable and unlikely to change in any way that
+  breaks compatibility.
+  * Use `Ramsey\Uuid\Uuid::uuid7()` to generate version 7 UUIDs.
+  * Version 7 UUIDs are of type `Ramsey\Uuid\Rfc4122\UuidV7`.
+  * The constant `Ramsey\Uuid\Uuid::UUID_TYPE_UNIX_TIME` exists for version
+    7 UUIDs.
+* Add `Ramsey\Uuid\Converter\Time\UnixTimeConverter` and
+  `Ramsey\Uuid\Generator\UnixTimeGenerator` to support version 7 UUID generation.
+* Add support for [max UUIDs][] through `Ramsey\Uuid\Uuid::MAX` and
+  `Ramsey\Uuid\Rfc4122\MaxUuid`.
+
+### Changed
+
+* The lowest version of brick/math allowed is now `^0.8.8`.
+
+### Deprecated
+
+The following will be removed in ramsey/uuid 5.0.0:
+
+* `Ramsey\Uuid\Nonstandard\UuidV6` is deprecated in favor of
+  `Ramsey\Uuid\Rfc4122\UuidV6`.
+* `Ramsey\Uuid\Uuid::UUID_TYPE_PEABODY`; use
+  `Ramsey\Uuid\Uuid::UUID_TYPE_REORDERED_TIME` instead.
+
+### Fixed
+
+* For `Ramsey\Uuid\Uuid::isValid()`, Psalm now asserts the UUID is a
+  non-empty-string when it is valid.
+* Nil UUIDs are properly treated as RFC 4122 variants, and `getVariant()` now
+  returns a `2` when called on a nil UUID.
+
+
+## 4.4.0 - 2022-08-05
+
+### Changed
+
+* Allow brick/math 0.10.
+* Remove dev dependency to moontoast/math.
+* Un-deprecate `UuidInterface::getUrn()`.
+
+
+## 4.3.1 - 2022-03-27
+
+### Deprecated
+
+The following will be removed in ramsey/uuid 5.0.0:
+
+* `Ramsey\Uuid\Generator\RandomLibAdapter`
+
+
+## 4.3.0 - 2022-03-26
+
+### Changed
+
+* Remove support for PHP 7.2, 7.3, and 7.4. This is not a BC break, since
+  Composer will do the right thing for your environment and select a compatible
+  version of this library.
+* Require `ext-ctype` extension. For applications that run in environments where
+  the `ext-ctype` is not present, please require a polyfill, such as
+  [symfony/polyfill-ctype](https://packagist.org/packages/symfony/polyfill-ctype).
+* Use `iterable<UuidBuilderInterface>` instead of `BuilderCollection` types.
+* Use `iterable<NodeProviderInterface>` instead of `NodeProviderCollection` types.
+
+### Deprecated
+
+The following will be removed in ramsey/uuid 5.0.0:
+
+* `Ramsey\Uuid\Builder\BuilderCollection`
+* `Ramsey\Uuid\Provider\Node\NodeProviderCollection`
+* Dependency on ramsey/collection
+
+### Fixed
+
+* Support valid UUIDs in uppercase in `LazyUuidFromString`.
+
+
+## 4.2.3 - 2021-09-25
+
+### Fixed
+
+* Switch back to `^8.0` in the PHP version requirement.
+
+
+## 4.2.2 - 2021-09-24
+
+### Fixed
+
+* Indicate support for PHP 8.1, using `~8.1.0` to prevent installations on 8.2
+  until the library is ready.
+
+
+## 4.2.1 - 2021-08-10
+
+### Fixed
+
+* Fix *soft* BC break with `Uuid::fromString()` signature. The change from
+  `string` to `non-empty-string` on the parameter annotation introduced a
+  BC break for those using static analysis tools. This release reverts this
+  change and provides an assertion to guard against empty strings.
+  See [ramsey/uuid#383](https://github.com/ramsey/uuid/pull/383).
+
+
+## 4.2.0 - 2021-08-06
+
+### Added
+
+* Add `Ramsey\Uuid\Exception\UuidExceptionInterface` for all ramsey/uuid
+  exceptions to implement. See [ramsey/uuid#340](https://github.com/ramsey/uuid/pull/340).
+
+### Fixed
+
+* Fix serialization of UUIDs.
+  See [ramsey/uuid#361](https://github.com/ramsey/uuid/pull/361).
+
+
+## 4.1.3 - 2021-09-25
+
+### Fixed
+
+* Switch back to `^8.0` in the PHP version requirement.
+
+
+## 4.1.2 - 2021-09-24
+
+### Fixed
+
+* Lock 4.1.x to `~8.0.0` to indicate it does not support PHP 8.1.
+
+
+## 4.1.1 - 2020-08-18
+
+### Fixed
+
+* Allow use of brick/math version 0.9
+
+
+## 4.1.0 - 2020-07-28
+
+### Changed
+
+* Improve performance of `Uuid::fromString()`, `Uuid::fromBytes()`,
+  `UuidInterface#toString()`, and `UuidInterface#getBytes()`. See PR
+  [#324](https://github.com/ramsey/uuid/pull/324) for more information.
+
+
+## 4.0.3 - 2021-09-25
+
+### Fixed
+
+* Switch back to `^8.0` in the PHP version requirement.
+
+
+## 4.0.2 - 2021-09-24
+
+### Fixed
+
+* Lock 4.0.x to `~8.0.0` to indicate it does not support PHP 8.1.
+
+
+## 4.0.1 - 2020-03-29
+
+### Fixed
+
+* Fix collection deserialization errors due to upstream `allowed_classes` being
+  set to `false`. For details, see [ramsey/uuid#303](https://github.com/ramsey/uuid/issues/303)
+  and [ramsey/collection#47](https://github.com/ramsey/collection/issues/47).
+
+
+## 4.0.0 - 2020-03-22
+
+### Added
+
+* Add support for version 6 UUIDs, as defined by <http://gh.peabody.io/uuidv6/>,
+  including the static method `Uuid::uuid6()`, which returns a
+  `Nonstandard\UuidV6` instance.
+* Add ability to generate version 2 (DCE Security) UUIDs, including the static
+  method `Uuid::uuid2()`, which returns an `Rfc4122\UuidV2` instance.
+* Add classes to represent each version of RFC 4122 UUID. When generating new
+  UUIDs or creating UUIDs from existing strings, bytes, or integers, if the UUID
+  is an RFC 4122 variant, one of these instances will be returned:
+  * `Rfc4122\UuidV1`
+  * `Rfc4122\UuidV2`
+  * `Rfc4122\UuidV3`
+  * `Rfc4122\UuidV4`
+  * `Rfc4122\UuidV5`
+  * `Rfc4122\NilUuid`
+* Add classes to represent version 6 UUIDs, GUIDs, and nonstandard
+  (non-RFC 4122 variant) UUIDs:
+  * `Nonstandard\UuidV6`
+  * `Guid\Guid`
+  * `Nonstandard\Uuid`
+* Add `Uuid::fromDateTime()` to create version 1 UUIDs from instances of
+  `\DateTimeInterface`.
+* The `\DateTimeInterface` instance returned by `UuidInterface::getDateTime()`
+  (and now `Rfc4122\UuidV1::getDateTime()`) now includes microseconds, as
+  specified by the version 1 UUID.
+* Add `Validator\ValidatorInterface` and `Validator\GenericValidator` to allow
+  flexibility in validating UUIDs/GUIDs.
+  * The default validator continues to validate UUID strings using the same
+    relaxed validation pattern found in the 3.x series of ramsey/uuid.
+  * Introduce `Rfc4122\Validator` that may be used for strict validation of
+    RFC 4122 UUID strings.
+  * Add ability to change the default validator used by `Uuid` through
+    `FeatureSet::setValidator()`.
+  * Add `getValidator()` and `setValidator()` to `UuidFactory`.
+* Add `Provider\Node\StaticNodeProvider` to assist in setting a custom static
+  node value with the multicast bit set for version 1 UUIDs.
+* Add the following new exceptions:
+  * `Exception\BuilderNotFoundException` -
+    Thrown to indicate that no suitable UUID builder could be found.
+  * `Exception\DateTimeException` -
+    Thrown to indicate that the PHP DateTime extension encountered an
+    exception/error.
+  * `Exception\DceSecurityException` -
+    Thrown to indicate an exception occurred while dealing with DCE Security
+    (version 2) UUIDs.
+  * `Exception\InvalidArgumentException` -
+    Thrown to indicate that the argument received is not valid. This extends the
+    built-in PHP `\InvalidArgumentException`, so there should be no BC breaks
+    with ramsey/uuid throwing this exception, if you are catching the PHP
+    exception.
+  * `Exception\InvalidBytesException` -
+    Thrown to indicate that the bytes being operated on are invalid in some way.
+  * `Exception\NameException` -
+    Thrown to indicate that an error occurred while attempting to hash a
+    namespace and name.
+  * `Exception\NodeException` -
+    Throw to indicate that attempting to fetch or create a node ID encountered
+    an error.
+  * `Exception\RandomSourceException` -
+    Thrown to indicate that the source of random data encountered an error.
+  * `Exception\TimeSourceException` -
+    Thrown to indicate that the source of time encountered an error.
+  * `Exception\UnableToBuildUuidException` -
+    Thrown to indicate a builder is unable to build a UUID.
+* Introduce a `Builder\FallbackBuilder`, used by `FeatureSet` to help decide
+  whether to return a `Uuid` or `Nonstandard\Uuid` when decoding a
+  UUID string or bytes.
+* Add `Rfc4122\UuidInterface` to specifically represent RFC 4122 variant UUIDs.
+* Add `Rfc4122\UuidBuilder` to build RFC 4122 variant UUIDs. This replaces the
+  existing `Builder\DefaultUuidBuilder`, which is now deprecated.
+* Introduce `Math\CalculatorInterface` for representing calculators to perform
+  arithmetic operations on integers.
+* Depend on [brick/math](https://github.com/brick/math) for the
+  `Math\BrickMathCalculator`, which is the default calculator used by this
+  library when math cannot be performed in native PHP due to integer size
+  limitations. The calculator is configurable and may be changed, if desired.
+* Add `Converter\Number\GenericNumberConverter` and
+  `Converter\Time\GenericTimeConverter` which will use the calculator provided
+  to convert numbers and time to values for UUIDs.
+* Introduce `Type\Hexadecimal`, `Type\Integer`, `Type\Decimal`, and `Type\Time`
+  for improved type-safety when dealing with arbitrary string values.
+* Add a `Type\TypeInterface` that each of the ramsey/uuid types implements.
+* Add `Fields\FieldsInterface` and `Rfc4122\FieldsInterface` to define
+  field layouts for UUID variants. The implementations `Rfc4122\Fields`,
+  `Guid\Fields`, and `Nonstandard\Fields` store the 16-byte,
+  binary string representation of the UUID internally, and these manage
+  conversion of the binary string into the hexadecimal field values.
+* Introduce `Builder\BuilderCollection` and `Provider\Node\NodeProviderCollection`.
+  These are typed collections for providing builders and node providers to
+  `Builder\FallbackBuilder` and `Provider\Node\FallbackNodeProvider`, respectively.
+* Add `Generator\NameGeneratorInterface` to support alternate methods of
+  generating bytes for version 3 and version 5 name-based UUID. By default,
+  ramsey/uuid uses the `Generator\DefaultNameGenerator`, which uses the standard
+  algorithm this library has used since the beginning. You may choose to use the
+  new `Generator\PeclUuidNameGenerator` to make use of the new
+  `uuid_generate_md5()` and `uuid_generate_sha1()` functions in
+  [ext-uuid version 1.1.0](https://pecl.php.net/package/uuid).
+
+### Changed
+
+* Set minimum required PHP version to 7.2.
+* This library now works on 32-bit and 64-bit systems, with no degradation in
+  functionality.
+* By default, the following static methods will now return specific instance
+  types. This should not cause any BC breaks if typehints target `UuidInterface`:
+  * `Uuid::uuid1` returns `Rfc4122\UuidV1`
+  * `Uuid::uuid3` returns `Rfc4122\UuidV3`
+  * `Uuid::uuid4` returns `Rfc4122\UuidV4`
+  * `Uuid::uuid5` returns `Rfc4122\UuidV5`
+* Accept `Type\Hexadecimal` for the `$node` parameter for
+  `UuidFactoryInterface::uuid1()`. This is in addition to the `int|string` types
+  already accepted, so there are no BC breaks. `Type\Hexadecimal` is now the
+  recommended type to pass for `$node`.
+* Out of the box, `Uuid::fromString()`, `Uuid::fromBytes()`, and
+  `Uuid::fromInteger()` will now return either an `Rfc4122\UuidInterface`
+  instance or an instance of `Nonstandard\Uuid`, depending on whether the input
+  contains an RFC 4122 variant UUID with a valid version identifier. Both
+  implement `UuidInterface`, so BC breaks should not occur if typehints use the
+  interface.
+* Change `Uuid::getFields()` to return an instance of `Fields\FieldsInterface`.
+  Previously, it returned an array of integer values (on 64-bit systems only).
+* `Uuid::getDateTime()` now returns an instance of `\DateTimeImmutable` instead
+  of `\DateTime`.
+* Make the following changes to `UuidInterface`:
+  * `getHex()` now returns a `Type\Hexadecimal` instance.
+  * `getInteger()` now returns a `Type\Integer` instance. The `Type\Integer`
+    instance holds a string representation of a 128-bit integer. You may then
+    use a math library of your choice (bcmath, gmp, etc.) to operate on the
+    string integer.
+  * `getDateTime()` now returns `\DateTimeInterface` instead of `\DateTime`.
+  * Add `__toString()` method.
+  * Add `getFields()` method. It returns an instance of `Fields\FieldsInterface`.
+* Add the following new methods to `UuidFactoryInterface`:
+  * `uuid2()`
+  * `uuid6()`
+  * `fromDateTime()`
+  * `fromInteger()`
+  * `getValidator()`
+* This library no longer throws generic exceptions. However, this should not
+  result in BC breaks, since the new exceptions extend from built-in PHP
+  exceptions that this library previously threw.
+  * `Exception\UnsupportedOperationException` is now descended from
+    `\LogicException`. Previously, it descended from `\RuntimeException`.
+* Change required constructor parameters for `Uuid`:
+  * Change the first required constructor parameter for `Uuid` from
+    `array $fields` to `Rfc4122\FieldsInterface $fields`.
+  * Add `Converter\TimeConverterInterface $timeConverter` as the fourth
+    required constructor parameter for `Uuid`.
+* Change the second required parameter of `Builder\UuidBuilderInterface::build()`
+  from `array $fields` to `string $bytes`. Rather than accepting an array of
+  hexadecimal strings as UUID fields, the `build()` method now expects a byte
+  string.
+* Add `Converter\TimeConverterInterface $timeConverter` as the second required
+  constructor parameter for `Rfc4122\UuidBuilder`. This also affects the
+  now-deprecated `Builder\DefaultUuidBuilder`, since this class now inherits
+  from `Rfc4122\UuidBuilder`.
+* Add `convertTime()` method to `Converter\TimeConverterInterface`.
+* Add `getTime()` method to `Provider\TimeProviderInterface`. It replaces the
+  `currentTime()` method.
+* `Provider\Node\FallbackNodeProvider` now accepts only a
+  `Provider\Node\NodeProviderCollection` as its constructor parameter.
+* `Provider\Time\FixedTimeProvider` no longer accepts an array but accepts only
+  `Type\Time` instances.
+* `Provider\NodeProviderInterface::getNode()` now returns `Type\Hexadecimal`
+  instead of `string|false|null`.
+* `Converter/TimeConverterInterface::calculateTime()` now returns
+  `Type\Hexadecimal` instead of `array`. The value is the full UUID timestamp
+  value (count of 100-nanosecond intervals since the Gregorian calendar epoch)
+  in hexadecimal format.
+* Change methods in `NumberConverterInterface` to accept and return string values
+  instead of `mixed`; this simplifies the interface and makes it consistent.
+* `Generator\DefaultTimeGenerator` no longer adds the variant and version bits
+  to the bytes it returns. These must be applied to the bytes afterwards.
+* When encoding to bytes or decoding from bytes, `OrderedTimeCodec` now checks
+  whether the UUID is an RFC 4122 variant, version 1 UUID. If not, it will throw
+  an exception—`InvalidArgumentException` when using
+  `OrderedTimeCodec::encodeBinary()` and `UnsupportedOperationException` when
+  using `OrderedTimeCodec::decodeBytes()`.
+
+### Deprecated
+
+The following functionality is deprecated and will be removed in ramsey/uuid
+5.0.0.
+
+* The following methods from `UuidInterface` and `Uuid` are deprecated. Use their
+  counterparts on the `Rfc4122\FieldsInterface` returned by `Uuid::getFields()`.
+  * `getClockSeqHiAndReservedHex()`
+  * `getClockSeqLowHex()`
+  * `getClockSequenceHex()`
+  * `getFieldsHex()`
+  * `getNodeHex()`
+  * `getTimeHiAndVersionHex()`
+  * `getTimeLowHex()`
+  * `getTimeMidHex()`
+  * `getTimestampHex()`
+  * `getVariant()`
+  * `getVersion()`
+* The following methods from `Uuid` are deprecated. Use the `Rfc4122\FieldsInterface`
+  instance returned by `Uuid::getFields()` to get the `Type\Hexadecimal` value
+  for these fields. You may use the new `Math\CalculatorInterface::toIntegerValue()`
+  method to convert the `Type\Hexadecimal` instances to instances of
+  `Type\Integer`. This library provides `Math\BrickMathCalculator`, which may be
+  used for this purpose, or you may use the arbitrary-precision arithemetic
+  library of your choice.
+  * `getClockSeqHiAndReserved()`
+  * `getClockSeqLow()`
+  * `getClockSequence()`
+  * `getNode()`
+  * `getTimeHiAndVersion()`
+  * `getTimeLow()`
+  * `getTimeMid()`
+  * `getTimestamp()`
+* `getDateTime()` on `UuidInterface` and `Uuid` is deprecated. Use this method
+  only on instances of `Rfc4122\UuidV1` or `Nonstandard\UuidV6`.
+* `getUrn()` on `UuidInterface` and `Uuid` is deprecated. It is available on
+  `Rfc4122\UuidInterface` and classes that implement it.
+* The following methods are deprecated and have no direct replacements. However,
+  you may obtain the same information by calling `UuidInterface::getHex()` and
+  splitting the return value in half.
+  * `UuidInterface::getLeastSignificantBitsHex()`
+  * `UuidInterface::getMostSignificantBitsHex()`
+  * `Uuid::getLeastSignificantBitsHex()`
+  * `Uuid::getMostSignificantBitsHex()`
+  * `Uuid::getLeastSignificantBits()`
+  * `Uuid::getMostSignificantBits()`
+* `UuidInterface::getNumberConverter()` and `Uuid::getNumberConverter()` are
+  deprecated. There is no alternative recommendation, so plan accordingly.
+* `Builder\DefaultUuidBuilder` is deprecated; transition to `Rfc4122\UuidBuilder`.
+* `Converter\Number\BigNumberConverter` is deprecated; transition to
+  `Converter\Number\GenericNumberConverter`.
+* `Converter\Time\BigNumberTimeConverter` is deprecated; transition to
+  `Converter\Time\GenericTimeConverter`.
+* The classes for representing and generating *degraded* UUIDs are deprecated.
+  These are no longer necessary; this library now behaves the same on 32-bit and
+  64-bit systems.
+  * `Builder\DegradedUuidBuilder`
+  * `Converter\Number\DegradedNumberConverter`
+  * `Converter\Time\DegradedTimeConverter`
+  * `DegradedUuid`
+* The `Uuid::UUID_TYPE_IDENTIFIER` constant is deprecated. Use
+  `Uuid::UUID_TYPE_DCE_SECURITY` instead.
+* The `Uuid::VALID_PATTERN` constant is deprecated. Use
+  `Validator\GenericValidator::getPattern()` or `Rfc4122\Validator::getPattern()`
+  instead.
+
+### Removed
+
+* Remove the following bytes generators and recommend
+  `Generator\RandomBytesGenerator` as a suitable replacement:
+  * `Generator\MtRandGenerator`
+  * `Generator\OpenSslGenerator`
+  * `Generator\SodiumRandomGenerator`
+* Remove `Exception\UnsatisfiedDependencyException`. This library no longer
+  throws this exception.
+* Remove the method `Provider\TimeProviderInterface::currentTime()`. Use
+  `Provider\TimeProviderInterface::getTime()` instead.
+
+
+## 4.0.0-beta2 - 2020-03-01
+
+## Added
+
+* Add missing convenience methods for `Rfc4122\UuidV2`.
+* Add `Provider\Node\StaticNodeProvider` to assist in setting a custom static
+  node value with the multicast bit set for version 1 UUIDs.
+
+## Changed
+
+* `Provider\NodeProviderInterface::getNode()` now returns `Type\Hexadecimal`
+  instead of `string|false|null`.
+
+
+## 4.0.0-beta1 - 2020-02-27
+
+### Added
+
+* Add `ValidatorInterface::getPattern()` to return the regular expression
+  pattern used by the validator.
+* Add `v6()` helper function for version 6 UUIDs.
+
+### Changed
+
+* Set the pattern constants on validators as `private`. Use the `getPattern()`
+  method instead.
+* Change the `$node` parameter for `UuidFactoryInterface::uuid6()` to accept
+  `null` or `Type\Hexadecimal`.
+* Accept `Type\Hexadecimal` for the `$node` parameter for
+  `UuidFactoryInterface::uuid1()`. This is in addition to the `int|string` types
+  already accepted, so there are no BC breaks. `Type\Hexadecimal` is now the
+  recommended type to pass for `$node`.
+
+### Removed
+
+* Remove `currentTime()` method from `Provider\Time\FixedTimeProvider` and
+  `Provider\Time\SystemTimeProvider`; it had previously been removed from
+  `Provider\TimeProviderInterface`.
+
+
+## 4.0.0-alpha5 - 2020-02-23
+
+### Added
+
+* Introduce `Builder\BuilderCollection` and `Provider\Node\NodeProviderCollection`.
+
+### Changed
+
+* `Builder\FallbackBuilder` now accepts only a `Builder\BuilderCollection` as
+  its constructor parameter.
+* `Provider\Node\FallbackNodeProvider` now accepts only a `Provider\Node\NodeProviderCollection`
+  as its constructor parameter.
+* `Provider\Time\FixedTimeProvider` no longer accepts an array but accepts only
+  `Type\Time` instances.
+
+
+## 4.0.0-alpha4 - 2020-02-23
+
+### Added
+
+* Add a `Type\TypeInterface` that each of the ramsey/uuid types implements.
+* Support version 6 UUIDs; see <http://gh.peabody.io/uuidv6/>.
+
+### Changed
+
+* Rename `Type\IntegerValue` to `Type\Integer`. It was originally named
+  `IntegerValue` because static analysis sees `Integer` in docblock annotations
+  and treats it as the native `int` type. `Integer` is not a reserved word in
+  PHP, so it should be named `Integer` for consistency with other types in this
+  library. When using it, a class alias prevents static analysis from
+  complaining.
+* Mark `Guid\Guid` and `Nonstandard\Uuid` classes as `final`.
+* Add `uuid6()` method to `UuidFactoryInterface`.
+
+### Deprecated
+
+* `Uuid::UUID_TYPE_IDENTIFIER` is deprecated. Use `Uuid::UUID_TYPE_DCE_SECURITY`
+  instead.
+* `Uuid::VALID_PATTERN` is deprecated. Use `Validator\GenericValidator::VALID_PATTERN`
+  instead.
+
+
+## 4.0.0-alpha3 - 2020-02-21
+
+### Fixed
+
+* Fix microsecond rounding error on 32-bit systems.
+
+
+## 4.0.0-alpha2 - 2020-02-21
+
+### Added
+
+* Add `Uuid::fromDateTime()` to create version 1 UUIDs from instances of
+  `\DateTimeInterface`.
+* Add `Generator\NameGeneratorInterface` to support alternate methods of
+  generating bytes for version 3 and version 5 name-based UUID. By default,
+  ramsey/uuid uses the `Generator\DefaultNameGenerator`, which uses the standard
+  algorithm this library has used since the beginning. You may choose to use the
+  new `Generator\PeclUuidNameGenerator` to make use of the new
+  `uuid_generate_md5()` and `uuid_generate_sha1()` functions in ext-uuid version
+  1.1.0.
+
+### Changed
+
+* Add `fromDateTime()` method to `UuidFactoryInterface`.
+* Change `UuidInterface::getHex()` to return a `Ramsey\Uuid\Type\Hexadecimal` instance.
+* Change `UuidInterface::getInteger()` to return a `Ramsey\Uuid\Type\IntegerValue` instance.
+
+### Fixed
+
+* Round microseconds to six digits when getting DateTime from v1 UUIDs. This
+  circumvents a needless exception for an otherwise valid time-based UUID.
+
+
+## 4.0.0-alpha1 - 2020-01-22
+
+### Added
+
+* Add `Validator\ValidatorInterface` and `Validator\GenericValidator` to allow
+  flexibility in validating UUIDs/GUIDs.
+  * Add ability to change the default validator used by `Uuid` through
+    `FeatureSet::setValidator()`.
+  * Add `getValidator()` and `setValidator()` to `UuidFactory`.
+* Add an internal `InvalidArgumentException` that descends from the built-in
+  PHP `\InvalidArgumentException`. All places that used to throw
+  `\InvalidArgumentException` now throw `Ramsey\Uuid\Exception\InvalidArgumentException`.
+  This should not cause any BC breaks, however.
+* Add an internal `DateTimeException` that descends from the built-in PHP
+  `\RuntimeException`. `Uuid::getDateTime()` may throw this exception if
+  `\DateTimeImmutable` throws an error or exception.
+* Add `RandomSourceException` that descends from the built-in PHP
+  `\RuntimeException`. `DefaultTimeGenerator`, `RandomBytesGenerator`, and
+  `RandomNodeProvider` may throw this exception if `random_bytes()` or
+  `random_int()` throw an error or exception.
+* Add `Fields\FieldsInterface` and `Rfc4122\FieldsInterface` to define
+  field layouts for UUID variants. The implementations `Rfc4122\Fields`,
+  `Guid\Fields`, and `Nonstandard\Fields` store the 16-byte,
+  binary string representation of the UUID internally, and these manage
+  conversion of the binary string into the hexadecimal field values.
+* Add `Rfc4122\UuidInterface` to specifically represent RFC 4122 variant UUIDs.
+* Add classes to represent each version of RFC 4122 UUID. When generating new
+  UUIDs or creating UUIDs from existing strings, bytes, or integers, if the UUID
+  is an RFC 4122 variant, one of these instances will be returned:
+  * `Rfc4122\UuidV1`
+  * `Rfc4122\UuidV2`
+  * `Rfc4122\UuidV3`
+  * `Rfc4122\UuidV4`
+  * `Rfc4122\UuidV5`
+  * `Rfc4122\NilUuid`
+* Add `Rfc4122\UuidBuilder` to build RFC 4122 variant UUIDs. This replaces the
+  existing `Builder\DefaultUuidBuilder`, which is now deprecated.
+* Add ability to generate version 2 (DCE Security) UUIDs, including the static
+  method `Uuid::uuid2()`, which returns an `Rfc4122\UuidV2` instance.
+* Add classes to represent GUIDs and nonstandard (non-RFC 4122 variant) UUIDs:
+  * `Guid\Guid`
+  * `Nonstandard\Uuid`.
+* Introduce a `Builder\FallbackBuilder`, used by `FeatureSet` to help decide
+  whether to return a `Uuid` or `Nonstandard\Uuid` when decoding a
+  UUID string or bytes.
+* Introduce `Type\Hexadecimal`, `Type\IntegerValue`, and `Type\Time` for
+  improved type-safety when dealing with arbitrary string values.
+* Introduce `Math\CalculatorInterface` for representing calculators to perform
+  arithmetic operations on integers.
+* Depend on [brick/math](https://github.com/brick/math) for the
+  `Math\BrickMathCalculator`, which is the default calculator used by this
+  library when math cannot be performed in native PHP due to integer size
+  limitations. The calculator is configurable and may be changed, if desired.
+* Add `Converter\Number\GenericNumberConverter` and
+  `Converter\Time\GenericTimeConverter` which will use the calculator provided
+  to convert numbers and time to values for UUIDs.
+* The `\DateTimeInterface` instance returned by `UuidInterface::getDateTime()`
+  (and now `Rfc4122\UuidV1::getDateTime()`) now includes microseconds, as
+  specified by the version 1 UUID.
+
+### Changed
+
+* Set minimum required PHP version to 7.2.
+* Add `__toString()` method to `UuidInterface`.
+* The `UuidInterface::getDateTime()` method now specifies `\DateTimeInterface`
+  as the return value, rather than `\DateTime`; `Uuid::getDateTime()` now
+  returns an instance of `\DateTimeImmutable` instead of `\DateTime`.
+* Add `getFields()` method to `UuidInterface`.
+* Add `getValidator()` method to `UuidFactoryInterface`.
+* Add `uuid2()` method to `UuidFactoryInterface`.
+* Add `convertTime()` method to `Converter\TimeConverterInterface`.
+* Add `getTime()` method to `Provider\TimeProviderInterface`.
+* Change `Uuid::getFields()` to return an instance of `Fields\FieldsInterface`.
+  Previously, it returned an array of integer values (on 64-bit systems only).
+* Change the first required constructor parameter for `Uuid` from
+  `array $fields` to `Rfc4122\FieldsInterface $fields`.
+* Introduce `Converter\TimeConverterInterface $timeConverter` as fourth required
+  constructor parameter for `Uuid` and second required constructor parameter for
+  `Builder\DefaultUuidBuilder`.
+* Change `UuidInterface::getInteger()` to always return a `string` value instead
+  of `mixed`. This is a string representation of a 128-bit integer. You may then
+  use a math library of your choice (bcmath, gmp, etc.) to operate on the
+  string integer.
+* Change the second required parameter of `Builder\UuidBuilderInterface::build()`
+  from `array $fields` to `string $bytes`. Rather than accepting an array of
+  hexadecimal strings as UUID fields, the `build()` method now expects a byte
+  string.
+* `Generator\DefaultTimeGenerator` no longer adds the variant and version bits
+  to the bytes it returns. These must be applied to the bytes afterwards.
+* `Converter/TimeConverterInterface::calculateTime()` now returns
+  `Type\Hexadecimal` instead of `array`. The value is the full UUID timestamp
+  value (count of 100-nanosecond intervals since the Gregorian calendar epoch)
+  in hexadecimal format.
+* Change methods in converter interfaces to accept and return string values
+  instead of `mixed`; this simplifies the interface and makes it consistent:
+  * `NumberConverterInterface::fromHex(string $hex): string`
+  * `NumberConverterInterface::toHex(string $number): string`
+  * `TimeConverterInterface::calculateTime(string $seconds, string $microseconds): array`
+* `UnsupportedOperationException` is now descended from `\LogicException`.
+  Previously, it descended from `\RuntimeException`.
+* When encoding to bytes or decoding from bytes, `OrderedTimeCodec` now checks
+  whether the UUID is an RFC 4122 variant, version 1 UUID. If not, it will throw
+  an exception—`InvalidArgumentException` when using
+  `OrderedTimeCodec::encodeBinary()` and `UnsupportedOperationException` when
+  using `OrderedTimeCodec::decodeBytes()`.
+* Out of the box, `Uuid::fromString()`, `Uuid::fromBytes()`, and
+  `Uuid::fromInteger()` will now return either an `Rfc4122\UuidInterface`
+  instance or an instance of `Nonstandard\Uuid`, depending on whether the input
+  contains an RFC 4122 variant UUID with a valid version identifier. Both
+  implement `UuidInterface`, so BC breaks should not occur if typehints use the
+  interface.
+* By default, the following static methods will now return the specific instance
+  types. This should not cause any BC breaks if typehints target `UuidInterface`:
+  * `Uuid::uuid1` returns `Rfc4122\UuidV1`
+  * `Uuid::uuid3` returns `Rfc4122\UuidV3`
+  * `Uuid::uuid4` returns `Rfc4122\UuidV4`
+  * `Uuid::uuid5` returns `Rfc4122\UuidV5`
+
+### Deprecated
+
+The following functionality is deprecated and will be removed in ramsey/uuid
+5.0.0.
+
+* The following methods from `UuidInterface` and `Uuid` are deprecated. Use their
+  counterparts on the `Rfc4122\FieldsInterface` returned by `Uuid::getFields()`.
+  * `getClockSeqHiAndReservedHex()`
+  * `getClockSeqLowHex()`
+  * `getClockSequenceHex()`
+  * `getFieldsHex()`
+  * `getNodeHex()`
+  * `getTimeHiAndVersionHex()`
+  * `getTimeLowHex()`
+  * `getTimeMidHex()`
+  * `getTimestampHex()`
+  * `getVariant()`
+  * `getVersion()`
+* The following methods from `Uuid` are deprecated. Use the `Rfc4122\FieldsInterface`
+  instance returned by `Uuid::getFields()` to get the `Type\Hexadecimal` value
+  for these fields, and then use the arbitrary-precision arithmetic library of
+  your choice to convert them to string integers.
+  * `getClockSeqHiAndReserved()`
+  * `getClockSeqLow()`
+  * `getClockSequence()`
+  * `getNode()`
+  * `getTimeHiAndVersion()`
+  * `getTimeLow()`
+  * `getTimeMid()`
+  * `getTimestamp()`
+* `getDateTime()` on `UuidInterface` and `Uuid` is deprecated. Use this method
+  only on instances of `Rfc4122\UuidV1`.
+* `getUrn()` on `UuidInterface` and `Uuid` is deprecated. It is available on
+  `Rfc4122\UuidInterface` and classes that implement it.
+* The following methods are deprecated and have no direct replacements. However,
+  you may obtain the same information by calling `UuidInterface::getHex()` and
+  splitting the return value in half.
+  * `UuidInterface::getLeastSignificantBitsHex()`
+  * `UuidInterface::getMostSignificantBitsHex()`
+  * `Uuid::getLeastSignificantBitsHex()`
+  * `Uuid::getMostSignificantBitsHex()`
+  * `Uuid::getLeastSignificantBits()`
+  * `Uuid::getMostSignificantBits()`
+* `UuidInterface::getNumberConverter()` and `Uuid::getNumberConverter()` are
+  deprecated. There is no alternative recommendation, so plan accordingly.
+* `Builder\DefaultUuidBuilder` is deprecated; transition to
+  `Rfc4122\UuidBuilder`.
+* `Converter\Number\BigNumberConverter` is deprecated; transition to
+  `Converter\Number\GenericNumberConverter`.
+* `Converter\Time\BigNumberTimeConverter` is deprecated; transition to
+  `Converter\Time\GenericTimeConverter`.
+* `Provider\TimeProviderInterface::currentTime()` is deprecated; transition to
+  the `getTimestamp()` method on the same interface.
+* The classes for representing and generating *degraded* UUIDs are deprecated.
+  These are no longer necessary; this library now behaves the same on 32-bit and
+  64-bit PHP.
+  * `Builder\DegradedUuidBuilder`
+  * `Converter\Number\DegradedNumberConverter`
+  * `Converter\Time\DegradedTimeConverter`
+  * `DegradedUuid`
+
+### Removed
+
+* Remove the following bytes generators and recommend
+  `Generator\RandomBytesGenerator` as a suitable replacement:
+  * `Generator\MtRandGenerator`
+  * `Generator\OpenSslGenerator`
+  * `Generator\SodiumRandomGenerator`
+* Remove `Exception\UnsatisfiedDependencyException`. This library no longer
+  throws this exception.
+
+
+## 3.9.7 - 2022-12-19
+
+### Fixed
+
+* Add `#[ReturnTypeWillChange]` to `Uuid::jsonSerialize()` method.
+
+
+## 3.9.6 - 2021-09-25
+
+### Fixed
+
+* Switch back to `^8.0` in the PHP version requirement.
+
+
+## 3.9.5 - 2021-09-24
+
+### Fixed
+
+* Indicate support for PHP 8.1, using `~8.1.0` to prevent installations on 8.2
+  until the library is ready.
+
+
+## 3.9.4 - 2021-08-06
+
+### Fixed
+
+* Allow installation of paragonie/random_compat v9.99.100 (for PHP 8 compatibility).
+
+
+## 3.9.3 - 2020-02-20
+
+### Fixed
+
+* For v1 UUIDs, round down for timestamps so that microseconds do not bump the
+  timestamp to the next second.
+
+  As an example, consider the case of timestamp `1` with  `600000` microseconds
+  (`1.600000`). This is the first second after midnight on January 1, 1970, UTC.
+  Previous versions of this library had a bug that would round this to `2`, so
+  the rendered time was `1970-01-01 00:00:02`. This was incorrect. Despite
+  having `600000` microseconds, the time should not round up to the next second.
+  Rather, the time should be `1970-01-01 00:00:01.600000`. Since this version of
+  ramsey/uuid does not support microseconds, the microseconds are dropped, and
+  the time is `1970-01-01 00:00:01`. No rounding should occur.
+
+
+## 3.9.2 - 2019-12-17
+
+### Fixed
+
+* Check whether files returned by `/sys/class/net/*/address` are readable
+  before attempting to read them. This avoids a PHP warning that was being
+  emitted on hosts that do not grant permission to read these files.
+
+
+## 3.9.1 - 2019-12-01
+
+### Fixed
+
+* Fix `RandomNodeProvider` behavior on 32-bit systems. The `RandomNodeProvider`
+  was converting a 6-byte string to a decimal number, which is a 48-bit,
+  unsigned integer. This caused problems on 32-bit systems and has now been
+  resolved.
+
+
+## 3.9.0 - 2019-11-30
+
+### Added
+
+* Add function API as convenience. The functions are available in the
+  `Ramsey\Uuid` namespace.
+  * `v1(int|string|null $node = null, int|null $clockSeq = null): string`
+  * `v3(string|UuidInterface $ns, string $name): string`
+  * `v4(): string`
+  * `v5(string|UuidInterface $ns, string $name): string`
+
+### Changed
+
+* Use paragonie/random-lib instead of ircmaxell/random-lib. This is a
+  non-breaking change.
+* Use a high-strength generator by default, when using `RandomLibAdapter`. This
+  is a non-breaking change.
+
+### Deprecated
+
+These will be removed in ramsey/uuid version 4.0.0:
+
+* `MtRandGenerator`, `OpenSslGenerator`, and `SodiumRandomGenerator` are
+  deprecated in favor of using the default `RandomBytesGenerator`.
+
+### Fixed
+
+* Set `ext-json` as a required dependency in `composer.json`.
+* Use `PHP_OS` instead of `php_uname()` when determining the system OS, for
+  cases when `php_uname()` is disabled for security reasons.
+
+
+## 3.8.0 - 2018-07-19
+
+### Added
+
+* Support discovery of MAC addresses on FreeBSD systems
+* Use a polyfill to provide PHP ctype functions when running on systems where the
+  ctype functions are not part of the PHP build
+* Disallow a trailing newline character when validating UUIDs
+* Annotate thrown exceptions for improved IDE hinting
+
+
+## 3.7.3 - 2018-01-19
+
+### Fixed
+
+* Gracefully handle cases where `glob()` returns false when searching
+  `/sys/class/net/*/address` files on Linux
+* Fix off-by-one error in `DefaultTimeGenerator`
+
+### Security
+
+* Switch to `random_int()` from `mt_rand()` for better random numbers
+
+
+## 3.7.2 - 2018-01-13
+
+### Fixed
+
+* Check sysfs on Linux to determine the node identifier; this provides a
+  reliable way to identify the node on Docker images, etc.
+
+
+## 3.7.1 - 2017-09-22
+
+### Fixed
+
+* Set the multicast bit for random nodes, according to RFC 4122, §4.5
+
+### Security
+
+* Use `random_bytes()` when generating random nodes
+
+
+## 3.7.0 - 2017-08-04
+
+### Added
+
+* Add the following UUID version constants:
+    * `Uuid::UUID_TYPE_TIME`
+    * `Uuid::UUID_TYPE_IDENTIFIER`
+    * `Uuid::UUID_TYPE_HASH_MD5`
+    * `Uuid::UUID_TYPE_RANDOM`
+    * `Uuid::UUID_TYPE_HASH_SHA1`
+
+
+## 3.6.1 - 2017-03-26
+
+### Fixed
+
+* Optimize UUID string decoding by using `str_pad()` instead of `sprintf()`
+
+
+## 3.6.0 - 2017-03-18
+
+### Added
+
+* Add `InvalidUuidStringException`, which is thrown when attempting to decode an
+  invalid string UUID; this does not introduce any BC issues, since the new
+  exception inherits from the previously used `InvalidArgumentException`
+
+### Fixed
+
+* Improve memory usage when generating large quantities of UUIDs (use `str_pad()`
+  and `dechex()` instead of `sprintf()`)
+
+
+## 3.5.2 - 2016-11-22
+
+### Fixed
+
+* Improve test coverage
+
+
+## 3.5.1 - 2016-10-02
+
+### Fixed
+
+* Fix issue where the same UUIDs were not being treated as equal when using
+  mixed cases
+
+
+## 3.5.0 - 2016-08-02
+
+### Added
+
+* Add `OrderedTimeCodec` to store UUID in an optimized way for InnoDB
+
+### Fixed
+
+* Fix invalid node generation in `RandomNodeProvider`
+* Avoid multiple unnecessary system calls by caching failed attempt to retrieve
+  system node
+
+
+## 3.4.1 - 2016-04-23
+
+### Fixed
+
+* Fix test that violated a PHP CodeSniffer rule, breaking the build
+
+
+## 3.4.0 - 2016-04-23
+
+### Added
+
+* Add `TimestampFirstCombCodec` and `TimestampLastCombCodec` codecs to provide
+  the ability to generate [COMB sequential UUIDs] with the timestamp encoded as
+  either the first 48 bits or the last 48 bits
+* Improve logic of `CombGenerator` for COMB sequential UUIDs
+
+
+## 3.3.0 - 2016-03-22
+
+### Security
+
+* Drop the use of OpenSSL as a fallback and use [paragonie/random_compat] to
+  support `RandomBytesGenerator` in versions of PHP earlier than 7.0;
+  this addresses and fixes the [collision issue]
+
+
+## 3.2.0 - 2016-02-17
+
+### Added
+
+* Add `SodiumRandomGenerator` to allow use of the [PECL libsodium extension] as
+  a random bytes generator when creating UUIDs
+
+
+## 3.1.0 - 2015-12-17
+
+### Added
+
+* Implement the PHP `Serializable` interface to provide the ability to
+  serialize/unserialize UUID objects
+
+
+## 3.0.1 - 2015-10-21
+
+### Added
+
+* Adopt the [Contributor Code of Conduct] for this project
+
+
+## 3.0.0 - 2015-09-28
+
+The 3.0.0 release represents a significant step for the ramsey/uuid library.
+While the simple and familiar API used in previous versions remains intact, this
+release provides greater flexibility to integrators, including the ability to
+inject your own number generators, UUID codecs, node and time providers, and
+more.
+
+*Please note: The changelog for 3.0.0 includes all notes from the alpha and beta
+versions leading up to this release.*
+
+### Added
+
+* Add a number of generators that may be used to override the library defaults
+  for generating random bytes (version 4) or time-based (version 1) UUIDs
+  * `CombGenerator` to allow generation of sequential UUIDs
+  * `OpenSslGenerator` to generate random bytes on systems where
+    `openssql_random_pseudo_bytes()` is present
+  * `MtRandGenerator` to provide a fallback in the event other random generators
+    are not present
+  * `RandomLibAdapter` to allow use of [ircmaxell/random-lib]
+  * `RandomBytesGenerator` for use with PHP 7; ramsey/uuid will default to use
+    this generator when running on PHP 7
+  * Refactor time-based (version 1) UUIDs into a `TimeGeneratorInterface` to
+    allow for other sources to generate version 1 UUIDs in this library
+  * `PeclUuidTimeGenerator` and `PeclUuidRandomGenerator` for creating version
+    1 or version 4 UUIDs using the pecl-uuid extension
+* Add a `setTimeGenerator` method on `UuidFactory` to override the default time
+  generator
+* Add option to enable `PeclUuidTimeGenerator` via `FeatureSet`
+* Support GUID generation by configuring a `FeatureSet` to use GUIDs
+* Allow UUIDs to be serialized as JSON through `JsonSerializable`
+
+### Changed
+
+* Change root namespace from "Rhumsaa" to "Ramsey;" in most cases, simply
+  making this change in your applications is the only upgrade path you will
+  need—everything else should work as expected
+* No longer consider `Uuid` class as `final`; everything is now based around
+  interfaces and factories, allowing you to use this package as a base to
+  implement other kinds of UUIDs with different dependencies
+* Return an object of type `DegradedUuid` on 32-bit systems to indicate that
+  certain features are not available
+* Default `RandomLibAdapter` to a medium-strength generator with
+  [ircmaxell/random-lib]; this is configurable, so other generator strengths may
+  be used
+
+### Removed
+
+* Remove `PeclUuidFactory` in favor of using pecl-uuid with generators
+* Remove `timeConverter` and `timeProvider` properties, setters, and getters in
+  both `FeatureSet` and `UuidFactory` as those are now exclusively used by the
+  default `TimeGenerator`
+* Move UUID [Doctrine field type] to [ramsey/uuid-doctrine]
+* Move `uuid` console application to [ramsey/uuid-console]
+* Remove `Uuid::VERSION` package version constant
+
+### Fixed
+
+* Improve GUID support to ensure that:
+  * On little endian (LE) architectures, the byte order of the first three
+    fields is LE
+  * On big endian (BE) architectures, it is the same as a GUID
+  * String representation is always the same
+* Fix exception message for `DegradedNumberConverter::fromHex()`
+
+
+## 3.0.0-beta1 - 2015-08-31
+
+### Fixed
+
+* Improve GUID support to ensure that:
+  * On little endian (LE) architectures, the byte order of the first three
+    fields is LE
+  * On big endian (BE) architectures, it is the same as a GUID
+  * String representation is always the same
+* Fix exception message for `DegradedNumberConverter::fromHex()`
+
+
+## 3.0.0-alpha3 - 2015-07-28
+
+### Added
+
+* Enable use of custom `TimeGenerator` implementations
+* Add a `setTimeGenerator` method on `UuidFactory` to override the default time
+  generator
+* Add option to enable `PeclUuidTimeGenerator` via `FeatureSet`
+
+### Removed
+
+* Remove `timeConverter` and `timeProvider` properties, setters, and getters in
+  both `FeatureSet` and `UuidFactory` as those are now exclusively used by the
+  default `TimeGenerator`
+
+
+## 3.0.0-alpha2 - 2015-07-28
+
+### Added
+
+* Refactor time-based (version 1) UUIDs into a `TimeGeneratorInterface` to allow
+  for other sources to generate version 1 UUIDs in this library
+* Add `PeclUuidTimeGenerator` and `PeclUuidRandomGenerator` for creating version
+  1 or version 4 UUIDs using the pecl-uuid extension
+* Add `RandomBytesGenerator` for use with PHP 7. ramsey/uuid will default to use
+  this generator when running on PHP 7
+
+### Changed
+
+* Default `RandomLibAdapter` to a medium-strength generator with
+  [ircmaxell/random-lib]; this is configurable, so other generator strengths may
+  be used
+
+### Removed
+
+* Remove `PeclUuidFactory` in favor of using pecl-uuid with generators
+
+
+## 3.0.0-alpha1 - 2015-07-16
+
+### Added
+
+* Allow dependency injection through `UuidFactory` and/or extending `FeatureSet`
+  to override any package defaults
+* Add a number of generators that may be used to override the library defaults:
+  * `CombGenerator` to allow generation of sequential UUIDs
+  * `OpenSslGenerator` to generate random bytes on systems where
+    `openssql_random_pseudo_bytes()` is present
+  * `MtRandGenerator` to provide a fallback in the event other random generators
+    are not present
+  * `RandomLibAdapter` to allow use of [ircmaxell/random-lib]
+* Support GUID generation by configuring a `FeatureSet` to use GUIDs
+* Allow UUIDs to be serialized as JSON through `JsonSerializable`
+
+### Changed
+
+* Change root namespace from "Rhumsaa" to "Ramsey;" in most cases, simply
+  making this change in your applications is the only upgrade path you will
+  need—everything else should work as expected
+* No longer consider `Uuid` class as `final`; everything is now based around
+  interfaces and factories, allowing you to use this package as a base to
+  implement other kinds of UUIDs with different dependencies
+* Return an object of type `DegradedUuid` on 32-bit systems to indicate that
+  certain features are not available
+
+### Removed
+
+* Move UUID [Doctrine field type] to [ramsey/uuid-doctrine]
+* Move `uuid` console application to [ramsey/uuid-console]
+* Remove `Uuid::VERSION` package version constant
+
+
+## 2.9.0 - 2016-03-22
+
+### Security
+
+* Drop the use of OpenSSL as a fallback and use [paragonie/random_compat] to
+  support `RandomBytesGenerator` in versions of PHP earlier than 7.0;
+  this addresses and fixes the [collision issue]
+
+
+## 2.8.4 - 2015-12-17
+
+### Added
+
+* Add support for symfony/console v3 in the `uuid` CLI application
+
+
+## 2.8.3 - 2015-08-31
+
+### Fixed
+
+* Fix exception message in `Uuid::calculateUuidTime()`
+
+
+## 2.8.2 - 2015-07-23
+
+### Fixed
+
+* Ensure the release tag makes it into the rhumsaa/uuid package
+
+
+## 2.8.1 - 2015-06-16
+
+### Fixed
+
+* Use `passthru()` and output buffering in `getIfconfig()`
+* Cache the system node in a static variable so that we process it only once per
+  runtime
+
+
+## 2.8.0 - 2014-11-09
+
+### Added
+
+* Add static `fromInteger()` method to create UUIDs from string integer or
+  `Moontoast\Math\BigNumber`
+
+### Fixed
+
+* Improve Doctrine conversion to Uuid or string for the ramsey/uuid [Doctrine field type]
+
+
+## 2.7.4 - 2014-10-29
+
+### Fixed
+
+* Change loop in `generateBytes()` from `foreach` to `for`
+
+
+## 2.7.3 - 2014-08-27
+
+### Fixed
+
+* Fix upper range for `mt_rand` used in version 4 UUIDs
+
+
+## 2.7.2 - 2014-07-28
+
+### Changed
+
+* Upgrade to PSR-4 autoloading
+
+
+## 2.7.1 - 2014-02-19
+
+### Fixed
+
+* Move moontoast/math and symfony/console to require-dev
+* Support symfony/console 2.3 (LTS version)
+
+
+## 2.7.0 - 2014-01-31
+
+### Added
+
+* Add `Uuid::VALID_PATTERN` constant containing a UUID validation regex pattern
+
+
+## 2.6.1 - 2014-01-27
+
+### Fixed
+
+* Fix bug where `uuid` console application could not find the Composer
+  autoloader when installed in another project
+
+
+## 2.6.0 - 2014-01-17
+
+### Added
+
+* Introduce `uuid` console application for generating and decoding UUIDs from
+  CLI (run `./bin/uuid` for details)
+* Add `Uuid::getInteger()` to retrieve a `Moontoast\Math\BigNumber`
+  representation of the 128-bit integer representing the UUID
+* Add `Uuid::getHex()` to retrieve the hexadecimal representation of the UUID
+* Use `netstat` on Linux to capture the node for a version 1 UUID
+* Require moontoast/math as part of the regular package requirements
+
+
+## 2.5.0 - 2013-10-30
+
+### Added
+
+* Use `openssl_random_pseudo_bytes()`, if available, to generate random bytes
+
+
+## 2.4.0 - 2013-07-29
+
+### Added
+
+* Return `null` from `Uuid::getVersion()` if the UUID isn't an RFC 4122 variant
+* Support string UUIDs without dashes passed to `Uuid::fromString()`
+
+
+## 2.3.0 - 2013-07-16
+
+### Added
+
+* Support creation of UUIDs from bytes with `Uuid::fromBytes()`
+
+
+## 2.2.0 - 2013-07-04
+
+### Added
+
+* Add `Doctrine\UuidType::requiresSQLCommentHint()` method
+
+
+## 2.1.2 - 2013-07-03
+
+### Fixed
+
+* Fix cases where the system node was coming back with uppercase hexadecimal
+  digits; this ensures that case in the node is converted to lowercase
+
+
+## 2.1.1 - 2013-04-29
+
+### Fixed
+
+* Fix bug in `Uuid::isValid()` where the NIL UUID was not reported as valid
+
+
+## 2.1.0 - 2013-04-15
+
+### Added
+
+* Allow checking the validity of a UUID through the `Uuid::isValid()` method
+
+
+## 2.0.0 - 2013-02-11
+
+### Added
+
+* Support UUID generation on 32-bit platforms
+
+### Changed
+
+* Mark `Uuid` class `final`
+* Require moontoast/math on 64-bit platforms for
+  `Uuid::getLeastSignificantBits()` and `Uuid::getMostSignificantBits()`; the
+  integers returned by these methods are *unsigned* 64-bit integers and
+  unsupported even on 64-bit builds of PHP
+* Move `UnsupportedOperationException` to the `Exception` subnamespace
+
+
+## 1.1.2 - 2012-11-29
+
+### Fixed
+
+* Relax [Doctrine field type] conversion rules for UUIDs
+
+
+## 1.1.1 - 2012-08-27
+
+### Fixed
+
+* Remove `final` keyword from `Uuid` class
+
+
+## 1.1.0 - 2012-08-06
+
+### Added
+
+* Support ramsey/uuid UUIDs as a Doctrine Database Abstraction Layer (DBAL)
+  field mapping type
+
+
+## 1.0.0 - 2012-07-19
+
+### Added
+
+* Support generation of version 1, 3, 4, and 5 UUIDs
+
+
+[comb sequential uuids]: http://www.informit.com/articles/article.aspx?p=25862&seqNum=7
+[paragonie/random_compat]: https://github.com/paragonie/random_compat
+[collision issue]: https://github.com/ramsey/uuid/issues/80
+[contributor code of conduct]: https://github.com/ramsey/uuid/blob/main/CODE_OF_CONDUCT.md
+[pecl libsodium extension]: http://pecl.php.net/package/libsodium
+[ircmaxell/random-lib]: https://github.com/ircmaxell/RandomLib
+[doctrine field type]: http://doctrine-dbal.readthedocs.org/en/latest/reference/types.html
+[ramsey/uuid-doctrine]: https://github.com/ramsey/uuid-doctrine
+[ramsey/uuid-console]: https://github.com/ramsey/uuid-console
+[version6]: https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis-00#section-5.6
+[version7]: https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis-00#section-5.7
+[version8]: https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis-00#section-5.8
+[max uuids]: https://datatracker.ietf.org/doc/html/draft-peabody-dispatch-new-uuid-format-04#section-5.4