CUID2 for Python 3. Next generation GUIDs. Collision-resistant ids optimized for horizontal scaling and performance.

A port of the CUID2 reference implementation by Parallel Drive to Python 3.

📝 Note: Originally taken from https://github.com/overflowdigital before it was unpublished. Thank you to @joshuathompsonlindley for your original contribution!

• Secure: It's not possible to guess the next ID.
• Collision resistant: It's extremely unlikely to generate the same ID twice.
• Horizontally scalable: Generate IDs on multiple machines without coordination.
• Offline-compatible: Generate IDs without a network connection.
• URL and name-friendly: No special characters.

For more information on the theory and usage of CUID2, see the following.

For more information on the improvements of CUID2 over CUID, see the following.

pip install cuid2

You can generate CUIDs directly in the terminal with the following:

$ cuid2

Or you can rely on a CUID wrapper if you don't need any customizations:

from typing import Callable
from cuid2 import cuid_wrapper
cuid_generator: Callable[[], str] = cuid_wrapper()
def main():
  my_cuid: str = cuid_generator()
  next_cuid: str = cuid_generator()

Finally, for more explicit control of the CUID generator, you can instantiate the class directly:

from cuid2 import Cuid
CUID_GENERATOR: Cuid = Cuid(length=10)
def main():
  my_cuid: str = CUID_GENERATOR.generate()
  next_cuid: str = CUID_GENERATOR.generate()