scuid is a lightweight Python library for generating collision-resistant IDs optimized for horizontal scaling and high performance. It serves as a slim, alternative implementation of cuid with added flexibility for customization, including support for custom random number generators.
Whether you're building distributed systems or need compact, unique identifiers, scuid offers a simple and efficient solution.
It is a reference port of the scuid source code for Node.js
- Compact, Unique, and Efficient: Generates small, collision-resistant IDs suitable for distributed systems. Compared to UUID v4, MD5, SHA1, and other collision-resistant ID generators, the shorter length of scuid IDs reduces the number of characters and tokens used. This makes scuid particularly advantageous for applications like generative AI, where minimizing token usage is often crucial.
- Customizable and Flexible: Supports custom random number generators and configurable options, enabling tailored solutions for a wide range of use cases.
- Lightweight and High-Performance: Designed to deliver fast ID generation without introducing unnecessary dependencies, ensuring optimal performance.
For more information or to contribute, visit the GitHub repository.
Install scuid using pip:
pip install scuid
Create a unique identifier with just one line:
from scuid import scuid
id = scuid()
print(id)
# Example output: 'ciux3hs0x0000io10cusdm8r2'
Slugs are shorter representations suitable for use in URLs or filenames:
from scuid import slug
slug_value = slug()
print(slug_value)
# Example output: '6x1i0r0'
The fingerprint represents the process and machine where the ID was generated:
from scuid import fingerprint
fp = fingerprint()
print(fp)
# Example output: 'io10'
You can provide a custom random number generator by implementing a random()
method:
from scuid import Scuid
class CustomRNG:
def random(self):
return 0.5 # Always returns 0.5 for demonstration purposes
custom_scuid = Scuid({"rng": CustomRNG().random})
id = custom_scuid.id()
print(id)
You can customize the ID generation process to fit your requirements. Note that altering these options may affect compatibility with the default cuid behavior.
from scuid import Scuid
custom_scuid = Scuid({
"prefix": "c", # Prefix for generated IDs
"base": 36, # Radix for encoding (supports 2-36)
"blockSize": 4, # Size of each padded block
"fill": "0", # Padding character
"pid": 12345, # Custom process ID
"hostname": "customhost", # Custom hostname
"rng": lambda: 0.42, # Custom RNG function
})
id = custom_scuid.id()
print(id)
To verify the correctness and collision resistance of scuid, you can run the included tests:
pytest
The tests simulate real-world scenarios with millions of iterations to ensure the reliability of generated IDs.
This project is licensed under the MIT License. See the LICENSE file for details.