Skip to content

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

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

Merged
merged 7 commits into from
Jan 27, 2025
Merged

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

merged 7 commits into from
Jan 27, 2025

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/

@picnixz picnixz self-requested a review January 2, 2025 23:11
@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)).

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.

@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.

@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>`.

Copy link
Member

@encukou encukou left a comment

Choose a reason for hiding this comment

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

I think it works better with the section number in the text.

@hugovk
Copy link
Member

hugovk commented Jan 27, 2025

Sure, let's merge.

@ngnpope, thank you your contribution!

@hugovk hugovk merged commit 8ec76d9 into python:main Jan 27, 2025
43 of 44 checks passed
@ngnpope ngnpope deleted the nil-max-uuid branch January 27, 2025 18:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
type-feature A feature request or enhancement
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants