QKP.EzId 0.2.1

EzId is a lightweight .NET library for generating unique, sortable, and human-friendly readable identifiers. It implements a 64 bit long ID generation algorithm inspired by Twitter Snowflake and comes packed with a value type that encodes it in a 13-character base32 string.

Usage example

using QKP.EzId;

// Create an EzIdGenerator with a unique generator ID (0-1023)
var generator = new EzIdGenerator<EzId>(generatorId: 1);

// Generate a new ID
EzId id = generator.GetNextId();

// Convert to string
string idString = id.ToString(); // Returns a 13-character base32 string, eg. "07047XF6Q8YPA"

// Parse from string
EzId parsedId = EzId.Parse(idString);

// Implement your own ID type, if you have multiple entities and want them to have own ID type
public class FooId(long id) : EzId(id)
{
}

// Create an FooIdGenerator with a unique generator ID (0-1023)
var fooGenerator = new EzIdGenerator<FooId>(generatorId: 1);

// Generate a new ID
FooId fooId = fooGenerator.GetNextId();

// Convert to string
string fooIdString = fooId.ToString(); // Returns a 13-character base 32 string eg. "07047XF6Q8YPB"