Fast, globally unique, and sortable ID generator.
ePyXID is a Python wrapper around the Rust implementation of xid: xid-rs. It provides a simple and efficient way to generate unique IDs that are sortable by creation time.
- Globally Unique: Each ID is unique across space and time.
- Sortable: IDs are sortable by their creation time.
- Fast: Implemented in Rust for maximum performance.
Install ePyXID using pip:
pip install epyxidGenerate and use ePyXID in your Python projects:
from epyxid import XID
# Create a new XID
xid = XID()
# Create an XID from a string
xid_str = XID.from_string("cnisffq7qo0qnbtbu5gg")
print(f"XID from string: {xid_str}")
# Create an XID from bytes
xid_bytes = XID.from_bytes(b'e\xe5\xc7\xbfG\xd6\x01\xab\xaf\xab\xf1a')
print(f"XID from bytes: {xid_bytes}")
# Print the XID as a string
print(f"XID: {str(xid)}")
# Example output: XID: cnisffq7qo0qnbtbu5gg
# Get the byte representation of the XID
print(f"Bytes: {bytes(xid)}")
# Example output: Bytes: b'e\xe5\xc7\xbfG\xd6\x01\xab\xaf\xab\xf1a'
# Access the creation time of the XID
print(f"Creation Time: {xid.time}")
# Example output: Creation Time: 2024-03-04 16:08:15
xid1 = XID()
xid2 = XID()
# Compare XIDs
print(f"XID1 < XID2: {xid1 < xid2}")
# Use XIDs in a set
xid_set = {xid1, xid2}
print(f"XID Set: {xid_set}")Contributions are welcome! Please open an issue or submit a pull request on GitHub.
This project is licensed under the MIT License.