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

Rename default method #35

Merged
merged 15 commits into from
Nov 29, 2019
Merged

Rename default method #35

merged 15 commits into from
Nov 29, 2019

Conversation

ctavan
Copy link
Collaborator

@ctavan ctavan commented Nov 25, 2019

Discussion in #3 yielded the following conclusions as of 2019-11-25:

  • We only want to support v4 UUIDs initially
  • Exporting them as uuid() might cause confusion should we ever want to support other algoritihms in the future.
  • Using "v4" in the name seems to cause more confusion than clarification since the whole "Version" terminology in the RFC is pretty confusing per se.
  • Using the term "random" to describe v4 UUIDs yielded generally positive feedback and other languages/libraries seem to use it as well.
  • There's general agreement that we should not support algorithms other than v4 random UUIDs for now.

We are still undecided whether we want to propose additional functionality around parsing UUIDs or outputting them in representations other than strings (e.g. bytes).

@rmg feel free to have a look as well!

Discussion in #3 yielded the following conclusions as of 2019-11-25:

- We only want to support v4 UUIDs initially
- Exporting them as uuid() might cause confusion should we ever want to
  support other algoritihms in the future.
- Using "v4" in the name seems to cause more confusion than
  clarification since the whole "Version" terminology in the RFC is
  pretty confusing per se.
- Using the term "random" to describe v4 UUIDs yielded generally
  positive feedback and other languages/libraries seem to use it as
  well.
- There's general agreement that we should not support algorithms other
  than v4 random UUIDs for now.
Discussion in #3 showed that there is general agreement for only
supporting the v4 algorithm.

However, there are concerns that, if we design an API that promotes one
algorithm as the default, this assumption might not hold in the future.
In order to provide a more future-proof API we may therefore only
support certain algorithms, but will likely not treat any of the
supported algorithms in a speacial way.
@ctavan ctavan requested a review from bakkot November 25, 2019 21:38
Copy link
Collaborator

@bcoe bcoe left a comment

Choose a reason for hiding this comment

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

This is looking compelling to me; I think we should add a couple sections to the document based on the discussion in #3, otherwise this is looking good to me.

README.md Show resolved Hide resolved
Copy link
Collaborator

@bcoe bcoe left a comment

Choose a reason for hiding this comment

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

a couple notes, but this is looking good to me.

README.md Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
@ctavan ctavan requested a review from bcoe November 26, 2019 21:12
@bcoe
Copy link
Collaborator

bcoe commented Nov 27, 2019

let's leave this open for a bit and give @broofa, @littledan, and a few other folks a chance to chime in.

Copy link
Collaborator

@broofa broofa left a comment

Choose a reason for hiding this comment

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

A couple minor nits, but otherwise looks good!

README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
ctavan and others added 3 commits November 28, 2019 11:10
@bcoe bcoe merged commit 4543b59 into master Nov 29, 2019
@bcoe bcoe deleted the rename-default-method branch November 29, 2019 00:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants