diff options
author | Berker Peksag <berker.peksag@gmail.com> | 2016-12-31 20:08:16 +0300 |
---|---|---|
committer | Berker Peksag <berker.peksag@gmail.com> | 2016-12-31 20:08:16 +0300 |
commit | ad26abba7cb612e4ff88b6d5cc02eb5249a7e0a7 (patch) | |
tree | d9abbe65e16adc408fb0583b01ed2a938375cbf0 /Doc | |
parent | d2b70563fdb0a5b40002f913f5b94db56f1b5b3e (diff) | |
download | cpython-ad26abba7cb612e4ff88b6d5cc02eb5249a7e0a7.tar.gz |
Issue #26267: Improve uuid.UUID documentation
* Document how comparison of UUID objects work
* Document str(uuid) returns the braceless standard form
* Add a test for comparison of a UUID object with a non-UUID object
Patch by Ammar Askar.
Diffstat (limited to 'Doc')
-rw-r--r-- | Doc/library/uuid.rst | 7 |
1 files changed, 7 insertions, 0 deletions
diff --git a/Doc/library/uuid.rst b/Doc/library/uuid.rst index 53cbd6c770..91dbca2edd 100644 --- a/Doc/library/uuid.rst +++ b/Doc/library/uuid.rst @@ -45,6 +45,13 @@ random UUID. variant and version number set according to RFC 4122, overriding bits in the given *hex*, *bytes*, *bytes_le*, *fields*, or *int*. + Comparison of UUID objects are made by way of comparing their + :attr:`UUID.int` attributes. Comparison with a non-UUID object + raises a :exc:`TypeError`. + + ``str(uuid)`` returns a string in the form + ``12345678-1234-5678-1234-567812345678`` where the 32 hexadecimal digits + represent the UUID. :class:`UUID` instances have these read-only attributes: |