https://github.com/python/cpython/commit/63fffb15f5e6b32c8e15eee40edae653eb0f6688
commit: 63fffb15f5e6b32c8e15eee40edae653eb0f6688
branch: main
author: Weilin Du <108666168+lamentxu...@users.noreply.github.com>
committer: picnixz <10796600+picn...@users.noreply.github.com>
date: 2025-08-18T11:24:19Z
summary:
gh-137847: Add examples for UUIDv6-8 (#137848)
Co-authored-by: Bénédikt Tran <10796600+picn...@users.noreply.github.com>
files:
M Doc/library/uuid.rst
diff --git a/Doc/library/uuid.rst b/Doc/library/uuid.rst
index 6698e6d3f43c43..aa4f1bf940bc5c 100644
--- a/Doc/library/uuid.rst
+++ b/Doc/library/uuid.rst
@@ -411,7 +411,7 @@ Here are some examples of typical usage of the :mod:`uuid`
module::
>>> import uuid
>>> # make a UUID based on the host ID and current time
- >>> uuid.uuid1()
+ >>> uuid.uuid1() # doctest: +SKIP
UUID('a8098c1a-f86e-11da-bd1a-00112444be1e')
>>> # make a UUID using an MD5 hash of a namespace UUID and a name
@@ -449,15 +449,24 @@ Here are some examples of typical usage of the
:mod:`uuid` module::
>>> uuid.MAX
UUID('ffffffff-ffff-ffff-ffff-ffffffffffff')
+ >>> # same as UUIDv1 but with fields reordered to improve DB locality
+ >>> uuid.uuid6() # doctest: +SKIP
+ UUID('1f0799c0-98b9-62db-92c6-a0d365b91053')
+
>>> # get UUIDv7 creation (local) time as a timestamp in milliseconds
>>> u = uuid.uuid7()
>>> u.time # doctest: +SKIP
1743936859822
+
>>> # get UUIDv7 creation (local) time as a datetime object
>>> import datetime as dt
>>> dt.datetime.fromtimestamp(u.time / 1000) # doctest: +SKIP
datetime.datetime(...)
+ >>> # make a UUID with custom blocks
+ >>> uuid.uuid8(0x12345678, 0x9abcdef0, 0x11223344)
+ UUID('00001234-5678-8ef0-8000-000011223344')
+
.. _uuid-cli-example:
_______________________________________________
Python-checkins mailing list -- python-checkins@python.org
To unsubscribe send an email to python-checkins-le...@python.org
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: arch...@mail-archive.com
