Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

gh-128427: Add uuid.NIL and uuid.MAX #128429

Open
wants to merge 7 commits into
base: main
Choose a base branch
from
Open

Conversation

ngnpope
Copy link
Contributor

@ngnpope ngnpope commented Jan 2, 2025

Adds constants for Nil and Max UUID formats as per RFC 9562.


📚 Documentation preview 📚: https://cpython-previews--128429.org.readthedocs.build/

Doc/whatsnew/3.14.rst Outdated Show resolved Hide resolved
@picnixz picnixz self-requested a review January 2, 2025 23:11
Doc/library/uuid.rst Outdated Show resolved Hide resolved
Doc/library/uuid.rst Outdated Show resolved Hide resolved
Doc/whatsnew/3.14.rst Show resolved Hide resolved
Lib/test/test_uuid.py Outdated Show resolved Hide resolved
Lib/uuid.py Show resolved Hide resolved
Doc/library/uuid.rst Show resolved Hide resolved
Doc/library/uuid.rst Show resolved Hide resolved
@picnixz
Copy link
Member

picnixz commented Jan 3, 2025

By the way, avoid force-pushing in the future as it makes reviews harder; we eventually squash commits and write our own commit message (force-pushing is accepted in some cases only but those are quite rare (like fixing up a really wrong commit that should not be seen at all, or changing the committer's email/name to due CLA reasons)).

Lib/test/test_uuid.py Outdated Show resolved Hide resolved
Copy link
Member

@picnixz picnixz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I forgot about the version and variant fields which I don't know what to do with.

Lib/test/test_uuid.py Outdated Show resolved Hide resolved
Lib/test/test_uuid.py Outdated Show resolved Hide resolved
Lib/test/test_uuid.py Show resolved Hide resolved
@ngnpope

This comment was marked as resolved.

@picnixz

This comment was marked as resolved.

Copy link
Member

@picnixz picnixz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just two nits and LGTM once a core dev allows it.

Lib/test/test_uuid.py Outdated Show resolved Hide resolved
Lib/test/test_uuid.py Outdated Show resolved Hide resolved
@picnixz picnixz added the type-feature A feature request or enhancement label Jan 13, 2025
@picnixz picnixz self-requested a review January 13, 2025 10:07
Copy link
Member

@hugovk hugovk left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, just a couple of docs suggestions.

.. data:: NIL

A special form of UUID that is specified to have all 128 bits set to zero
according to :rfc:`RFC 9562, §5.9 <9562#section-5.9>`.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Linking directly to the section is helpful, perhaps we only need to mention the RFC number here? If so, we could update the same thing for uuid8 above.

Suggested change
according to :rfc:`RFC 9562, §5.9 <9562#section-5.9>`.
according to :rfc:`RFC 9562 <9562#section-5.9>`.

.. data:: MAX

A special form of UUID that is specified to have all 128 bits set to one
according to :rfc:`RFC 9562, §5.10 <9562#section-5.10>`.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
according to :rfc:`RFC 9562, §5.10 <9562#section-5.10>`.
according to :rfc:`RFC 9562 <9562#section-5.10>`.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
awaiting merge type-feature A feature request or enhancement
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants