nonstandard.rst 1.4 KB

12345678910111213141516171819202122232425262728293031323334353637383940
  1. .. _nonstandard:
  2. =================
  3. Nonstandard UUIDs
  4. =================
  5. .. toctree::
  6. :titlesonly:
  7. :hidden:
  8. nonstandard/version6
  9. nonstandard/guid
  10. nonstandard/other
  11. Outside of `RFC 4122`_, other types of UUIDs are in-use, following rules of
  12. their own. Some of these are on their way to becoming accepted standards, while
  13. others have historical reasons for remaining valid today. Still, others are
  14. completely random and do not follow any rules.
  15. For these cases, ramsey/uuid provides a special functionality to handle these
  16. alternate, nonstandard forms.
  17. Version 6: Reordered Time
  18. This is a new version of UUID that combines the features of a
  19. :ref:`version 1 UUID <rfc4122.version1>` with a *monotonically increasing*
  20. UUID. For more details, see :ref:`nonstandard.version6`.
  21. Globally Unique Identifiers (GUIDs)
  22. A globally unique identifier, or GUID, is often used as a synonym for UUID.
  23. A key difference is the order of the bytes. Any `RFC 4122`_ version UUID may
  24. be represented as a GUID. For more details, see :ref:`nonstandard.guid`.
  25. Other Nonstandard UUIDs
  26. Sometimes, UUID string or byte representations don't follow `RFC 4122`_.
  27. Rather than reject these identifiers, ramsey/uuid returns them with the
  28. special Nonstandard\\Uuid instance type. For more details, see
  29. :ref:`nonstandard.other`.
  30. .. _RFC 4122: https://tools.ietf.org/html/rfc4122