ulid-transform 1.2.1__cp313-cp313-win32.whl → 1.5.2__cp313-cp313-win32.whl

ulid_transform/ulid_struct.hh

@@ -1,16 +1,18 @@
 #ifndef ULID_STRUCT_HH
 #define ULID_STRUCT_HH
 
+#include <array>
 #include <chrono>
 #include <cstdlib>
 #include <ctime>
 #include <functional>
 #include <random>
+#include <thread>
 #include <vector>
 
 #if _MSC_VER > 0
 typedef uint32_t rand_t;
-# else
+#else
 typedef uint8_t rand_t;
 #endif
 
@@ -20,362 +22,69 @@ namespace ulid {
  * ULID is a 16 byte Universally Unique Lexicographically Sortable Identifier
  * */
 struct ULID {
-	uint8_t data[16];
-
-	ULID() {
-		// for (int i = 0 ; i < 16 ; i++) {
-		// 	data[i] = 0;
-		// }
-
-		// unrolled loop
-		data[0] = 0;
-		data[1] = 0;
-		data[2] = 0;
-		data[3] = 0;
-		data[4] = 0;
-		data[5] = 0;
-		data[6] = 0;
-		data[7] = 0;
-		data[8] = 0;
-		data[9] = 0;
-		data[10] = 0;
-		data[11] = 0;
-		data[12] = 0;
-		data[13] = 0;
-		data[14] = 0;
-		data[15] = 0;
-	}
-
-	ULID(uint64_t val) {
-		// for (int i = 0 ; i < 16 ; i++) {
-		// 	data[15 - i] = static_cast<uint8_t>(val);
-		// 	val >>= 8;
-		// }
-
-		// unrolled loop
-		data[15] = static_cast<uint8_t>(val);
-
-		val >>= 8;
-		data[14] = static_cast<uint8_t>(val);
-
-		val >>= 8;
-		data[13] = static_cast<uint8_t>(val);
-
-		val >>= 8;
-		data[12] = static_cast<uint8_t>(val);
-
-		val >>= 8;
-		data[11] = static_cast<uint8_t>(val);
-
-		val >>= 8;
-		data[10] = static_cast<uint8_t>(val);
-
-		val >>= 8;
-		data[9] = static_cast<uint8_t>(val);
-
-		val >>= 8;
-		data[8] = static_cast<uint8_t>(val);
-
-		data[7] = 0;
-		data[6] = 0;
-		data[5] = 0;
-		data[4] = 0;
-		data[3] = 0;
-		data[2] = 0;
-		data[1] = 0;
-		data[0] = 0;
-	}
-
-	ULID(const ULID& other) {
-		// for (int i = 0 ; i < 16 ; i++) {
-		// 	data[i] = other.data[i];
-		// }
-
-		// unrolled loop
-		data[0] = other.data[0];
-		data[1] = other.data[1];
-		data[2] = other.data[2];
-		data[3] = other.data[3];
-		data[4] = other.data[4];
-		data[5] = other.data[5];
-		data[6] = other.data[6];
-		data[7] = other.data[7];
-		data[8] = other.data[8];
-		data[9] = other.data[9];
-		data[10] = other.data[10];
-		data[11] = other.data[11];
-		data[12] = other.data[12];
-		data[13] = other.data[13];
-		data[14] = other.data[14];
-		data[15] = other.data[15];
-	}
-
-	ULID& operator=(const ULID& other) {
-		// for (int i = 0 ; i < 16 ; i++) {
-		// 	data[i] = other.data[i];
-		// }
-
-		// unrolled loop
-		data[0] = other.data[0];
-		data[1] = other.data[1];
-		data[2] = other.data[2];
-		data[3] = other.data[3];
-		data[4] = other.data[4];
-		data[5] = other.data[5];
-		data[6] = other.data[6];
-		data[7] = other.data[7];
-		data[8] = other.data[8];
-		data[9] = other.data[9];
-		data[10] = other.data[10];
-		data[11] = other.data[11];
-		data[12] = other.data[12];
-		data[13] = other.data[13];
-		data[14] = other.data[14];
-		data[15] = other.data[15];
-
-		return *this;
-	}
-
-	ULID(ULID&& other) {
-		// for (int i = 0 ; i < 16 ; i++) {
-		// 	data[i] = other.data[i];
-		// 	other.data[i] = 0;
-		// }
-
-		// unrolled loop
-		data[0] = other.data[0];
-		other.data[0] = 0;
-
-		data[1] = other.data[1];
-		other.data[1] = 0;
-
-		data[2] = other.data[2];
-		other.data[2] = 0;
-
-		data[3] = other.data[3];
-		other.data[3] = 0;
-
-		data[4] = other.data[4];
-		other.data[4] = 0;
-
-		data[5] = other.data[5];
-		other.data[5] = 0;
-
-		data[6] = other.data[6];
-		other.data[6] = 0;
-
-		data[7] = other.data[7];
-		other.data[7] = 0;
-
-		data[8] = other.data[8];
-		other.data[8] = 0;
-
-		data[9] = other.data[9];
-		other.data[9] = 0;
-
-		data[10] = other.data[10];
-		other.data[10] = 0;
-
-		data[11] = other.data[11];
-		other.data[11] = 0;
-
-		data[12] = other.data[12];
-		other.data[12] = 0;
-
-		data[13] = other.data[13];
-		other.data[13] = 0;
-
-		data[14] = other.data[14];
-		other.data[14] = 0;
-
-		data[15] = other.data[15];
-		other.data[15] = 0;
-	}
-
-	ULID& operator=(ULID&& other) {
-		// for (int i = 0 ; i < 16 ; i++) {
-		// 	data[i] = other.data[i];
-		// 	other.data[i] = 0;
-		// }
-
-		// unrolled loop
-		data[0] = other.data[0];
-		other.data[0] = 0;
-
-		data[1] = other.data[1];
-		other.data[1] = 0;
-
-		data[2] = other.data[2];
-		other.data[2] = 0;
-
-		data[3] = other.data[3];
-		other.data[3] = 0;
-
-		data[4] = other.data[4];
-		other.data[4] = 0;
-
-		data[5] = other.data[5];
-		other.data[5] = 0;
-
-		data[6] = other.data[6];
-		other.data[6] = 0;
-
-		data[7] = other.data[7];
-		other.data[7] = 0;
-
-		data[8] = other.data[8];
-		other.data[8] = 0;
-
-		data[9] = other.data[9];
-		other.data[9] = 0;
-
-		data[10] = other.data[10];
-		other.data[10] = 0;
-
-		data[11] = other.data[11];
-		other.data[11] = 0;
-
-		data[12] = other.data[12];
-		other.data[12] = 0;
-
-		data[13] = other.data[13];
-		other.data[13] = 0;
-
-		data[14] = other.data[14];
-		other.data[14] = 0;
-
-		data[15] = other.data[15];
-		other.data[15] = 0;
-
-		return *this;
-	}
+    uint8_t data[16];
 };
 
 /**
  * EncodeTimestamp will encode the int64_t timestamp to the passed ulid
  * */
-inline void EncodeTimestamp(int64_t timestamp, ULID& ulid) {
-	ulid.data[0] = static_cast<uint8_t>(timestamp >> 40);
-	ulid.data[1] = static_cast<uint8_t>(timestamp >> 32);
-	ulid.data[2] = static_cast<uint8_t>(timestamp >> 24);
-	ulid.data[3] = static_cast<uint8_t>(timestamp >> 16);
-	ulid.data[4] = static_cast<uint8_t>(timestamp >> 8);
-	ulid.data[5] = static_cast<uint8_t>(timestamp);
+inline void EncodeTimestamp(int64_t timestamp, ULID& ulid)
+{
+    ulid.data[0] = static_cast<uint8_t>(timestamp >> 40);
+    ulid.data[1] = static_cast<uint8_t>(timestamp >> 32);
+    ulid.data[2] = static_cast<uint8_t>(timestamp >> 24);
+    ulid.data[3] = static_cast<uint8_t>(timestamp >> 16);
+    ulid.data[4] = static_cast<uint8_t>(timestamp >> 8);
+    ulid.data[5] = static_cast<uint8_t>(timestamp);
 }
 
 /**
  * EncodeTime will encode the time point to the passed ulid
  * */
-inline void EncodeTime(std::chrono::time_point<std::chrono::system_clock> time_point, ULID& ulid) {
-	auto time_ms = std::chrono::time_point_cast<std::chrono::milliseconds>(time_point);
-	int64_t timestamp = time_ms.time_since_epoch().count();
+inline void EncodeTime(std::chrono::time_point<std::chrono::system_clock> time_point, ULID& ulid)
+{
+    auto time_ms = std::chrono::time_point_cast<std::chrono::milliseconds>(time_point);
+    int64_t timestamp = time_ms.time_since_epoch().count();
     EncodeTimestamp(timestamp, ulid);
 }
 
-/**
- * EncodeTimeNow will encode a ULID using the time obtained using std::time(nullptr)
- * */
-inline void EncodeTimeNow(ULID& ulid) {
-	auto time_now = std::chrono::system_clock::from_time_t(time(nullptr));
-	EncodeTime(time_now, ulid);
-}
-
 /**
  * EncodeTimeSystemClockNow will encode a ULID using the time obtained using
  * std::chrono::system_clock::now() by taking the timestamp in milliseconds.
  * */
-inline void EncodeTimeSystemClockNow(ULID& ulid) {
-	EncodeTime(std::chrono::system_clock::now(), ulid);
-}
-
-/**
- * EncodeEntropy will encode the last 10 bytes of the passed uint8_t array with
- * the values generated using the passed random number generator.
- * */
-inline void EncodeEntropy(const std::function<uint8_t()>& rng, ULID& ulid) {
-	ulid.data[6] = rng();
-	ulid.data[7] = rng();
-	ulid.data[8] = rng();
-	ulid.data[9] = rng();
-	ulid.data[10] = rng();
-	ulid.data[11] = rng();
-	ulid.data[12] = rng();
-	ulid.data[13] = rng();
-	ulid.data[14] = rng();
-	ulid.data[15] = rng();
-}
-
-/**
- * EncodeEntropyRand will encode a ulid using std::rand
- *
- * std::rand returns values in [0, RAND_MAX]
- * */
-inline void EncodeEntropyRand(ULID& ulid) {
-	ulid.data[6] = static_cast<uint8_t>((std::rand() * 255ull) / RAND_MAX);
-	ulid.data[7] = static_cast<uint8_t>((std::rand() * 255ull) / RAND_MAX);
-	ulid.data[8] = static_cast<uint8_t>((std::rand() * 255ull) / RAND_MAX);
-	ulid.data[9] = static_cast<uint8_t>((std::rand() * 255ull) / RAND_MAX);
-	ulid.data[10] = static_cast<uint8_t>((std::rand() * 255ull) / RAND_MAX);
-	ulid.data[11] = static_cast<uint8_t>((std::rand() * 255ull) / RAND_MAX);
-	ulid.data[12] = static_cast<uint8_t>((std::rand() * 255ull) / RAND_MAX);
-	ulid.data[13] = static_cast<uint8_t>((std::rand() * 255ull) / RAND_MAX);
-	ulid.data[14] = static_cast<uint8_t>((std::rand() * 255ull) / RAND_MAX);
-	ulid.data[15] = static_cast<uint8_t>((std::rand() * 255ull) / RAND_MAX);
-}
-
-static std::uniform_int_distribution<rand_t> Distribution_0_255(0, 255);
-
-/**
- * EncodeEntropyMt19937 will encode a ulid using std::mt19937
- *
- * It also creates a std::uniform_int_distribution to generate values in [0, 255]
- * */
-inline void EncodeEntropyMt19937(std::mt19937& generator, ULID& ulid) {
-	ulid.data[6] = Distribution_0_255(generator);
-	ulid.data[7] = Distribution_0_255(generator);
-	ulid.data[8] = Distribution_0_255(generator);
-	ulid.data[9] = Distribution_0_255(generator);
-	ulid.data[10] = Distribution_0_255(generator);
-	ulid.data[11] = Distribution_0_255(generator);
-	ulid.data[12] = Distribution_0_255(generator);
-	ulid.data[13] = Distribution_0_255(generator);
-	ulid.data[14] = Distribution_0_255(generator);
-	ulid.data[15] = Distribution_0_255(generator);
-}
-
-/**
- * Encode will create an encoded ULID with a timestamp and a generator.
- * */
-inline void Encode(std::chrono::time_point<std::chrono::system_clock> timestamp, const std::function<uint8_t()>& rng, ULID& ulid) {
-	EncodeTime(timestamp, ulid);
-	EncodeEntropy(rng, ulid);
-}
-
-/**
- * EncodeNowRand = EncodeTimeNow + EncodeEntropyRand.
- * */
-inline void EncodeNowRand(ULID& ulid) {
-	EncodeTimeNow(ulid);
-	EncodeEntropyRand(ulid);
-}
-
-/**
- * Create will create a ULID with a timestamp and a generator.
- * */
-inline ULID Create(std::chrono::time_point<std::chrono::system_clock> timestamp, const std::function<uint8_t()>& rng) {
-	ULID ulid;
-	Encode(timestamp, rng, ulid);
-	return ulid;
+inline void EncodeTimeSystemClockNow(ULID& ulid)
+{
+    EncodeTime(std::chrono::system_clock::now(), ulid);
 }
 
-
 /**
- * CreateNowRand:EncodeNowRand = Create:Encode.
+ * EncodeEntropyMt19937Fast will encode using std::mt19937
+ * with only 3 generated values.
  * */
-inline ULID CreateNowRand() {
-	ULID ulid;
-	EncodeNowRand(ulid);
-	return ulid;
+inline void EncodeEntropyMt19937Fast(ULID& ulid)
+{
+    static thread_local std::mt19937 gen([]() {
+        // Use multiple entropy sources for seeding
+        std::array<uint32_t, 3> seed_data = {
+            static_cast<uint32_t>(std::chrono::high_resolution_clock::now().time_since_epoch().count()),
+            static_cast<uint32_t>(std::random_device {}()),
+            static_cast<uint32_t>(std::hash<std::thread::id> {}(std::this_thread::get_id()))
+        };
+        std::seed_seq seed_seq(seed_data.begin(), seed_data.end());
+        return std::mt19937(seed_seq);
+    }());
+    uint64_t high = (static_cast<uint64_t>(gen()) << 32) | gen();
+    uint32_t low = gen();
+    ulid.data[6] = (high >> 40) & 0xFF;
+    ulid.data[7] = (high >> 32) & 0xFF;
+    ulid.data[8] = (high >> 24) & 0xFF;
+    ulid.data[9] = (high >> 16) & 0xFF;
+    ulid.data[10] = (high >> 8) & 0xFF;
+    ulid.data[11] = high & 0xFF;
+    ulid.data[12] = (low >> 24) & 0xFF;
+    ulid.data[13] = (low >> 16) & 0xFF;
+    ulid.data[14] = (low >> 8) & 0xFF;
+    ulid.data[15] = low & 0xFF;
 }
 
 /**
@@ -404,80 +113,63 @@ static const char Encoding[33] = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
  * entropy:
  * follows similarly, except now all components are set to 5 bits.
  * */
-inline void MarshalTo(const ULID& ulid, char dst[26]) {
-	// 10 byte timestamp
-	dst[0] = Encoding[(ulid.data[0] & 224) >> 5];
-	dst[1] = Encoding[ulid.data[0] & 31];
-	dst[2] = Encoding[(ulid.data[1] & 248) >> 3];
-	dst[3] = Encoding[((ulid.data[1] & 7) << 2) | ((ulid.data[2] & 192) >> 6)];
-	dst[4] = Encoding[(ulid.data[2] & 62) >> 1];
-	dst[5] = Encoding[((ulid.data[2] & 1) << 4) | ((ulid.data[3] & 240) >> 4)];
-	dst[6] = Encoding[((ulid.data[3] & 15) << 1) | ((ulid.data[4] & 128) >> 7)];
-	dst[7] = Encoding[(ulid.data[4] & 124) >> 2];
-	dst[8] = Encoding[((ulid.data[4] & 3) << 3) | ((ulid.data[5] & 224) >> 5)];
-	dst[9] = Encoding[ulid.data[5] & 31];
-
-	// 16 bytes of entropy
-	dst[10] = Encoding[(ulid.data[6] & 248) >> 3];
-	dst[11] = Encoding[((ulid.data[6] & 7) << 2) | ((ulid.data[7] & 192) >> 6)];
-	dst[12] = Encoding[(ulid.data[7] & 62) >> 1];
-	dst[13] = Encoding[((ulid.data[7] & 1) << 4) | ((ulid.data[8] & 240) >> 4)];
-	dst[14] = Encoding[((ulid.data[8] & 15) << 1) | ((ulid.data[9] & 128) >> 7)];
-	dst[15] = Encoding[(ulid.data[9] & 124) >> 2];
-	dst[16] = Encoding[((ulid.data[9] & 3) << 3) | ((ulid.data[10] & 224) >> 5)];
-	dst[17] = Encoding[ulid.data[10] & 31];
-	dst[18] = Encoding[(ulid.data[11] & 248) >> 3];
-	dst[19] = Encoding[((ulid.data[11] & 7) << 2) | ((ulid.data[12] & 192) >> 6)];
-	dst[20] = Encoding[(ulid.data[12] & 62) >> 1];
-	dst[21] = Encoding[((ulid.data[12] & 1) << 4) | ((ulid.data[13] & 240) >> 4)];
-	dst[22] = Encoding[((ulid.data[13] & 15) << 1) | ((ulid.data[14] & 128) >> 7)];
-	dst[23] = Encoding[(ulid.data[14] & 124) >> 2];
-	dst[24] = Encoding[((ulid.data[14] & 3) << 3) | ((ulid.data[15] & 224) >> 5)];
-	dst[25] = Encoding[ulid.data[15] & 31];
-}
-
-/**
- * Marshal will marshal a ULID to a std::string.
- * */
-inline std::string Marshal(const ULID& ulid) {
-	char data[27];
-	data[26] = '\0';
-	MarshalTo(ulid, data);
-	return std::string(data);
+inline void MarshalTo(const ULID& ulid, char dst[26])
+{
+    // 10 byte timestamp
+    dst[0] = Encoding[(ulid.data[0] & 224) >> 5];
+    dst[1] = Encoding[ulid.data[0] & 31];
+    dst[2] = Encoding[(ulid.data[1] & 248) >> 3];
+    dst[3] = Encoding[((ulid.data[1] & 7) << 2) | ((ulid.data[2] & 192) >> 6)];
+    dst[4] = Encoding[(ulid.data[2] & 62) >> 1];
+    dst[5] = Encoding[((ulid.data[2] & 1) << 4) | ((ulid.data[3] & 240) >> 4)];
+    dst[6] = Encoding[((ulid.data[3] & 15) << 1) | ((ulid.data[4] & 128) >> 7)];
+    dst[7] = Encoding[(ulid.data[4] & 124) >> 2];
+    dst[8] = Encoding[((ulid.data[4] & 3) << 3) | ((ulid.data[5] & 224) >> 5)];
+    dst[9] = Encoding[ulid.data[5] & 31];
+
+    // 16 bytes of entropy
+    dst[10] = Encoding[(ulid.data[6] & 248) >> 3];
+    dst[11] = Encoding[((ulid.data[6] & 7) << 2) | ((ulid.data[7] & 192) >> 6)];
+    dst[12] = Encoding[(ulid.data[7] & 62) >> 1];
+    dst[13] = Encoding[((ulid.data[7] & 1) << 4) | ((ulid.data[8] & 240) >> 4)];
+    dst[14] = Encoding[((ulid.data[8] & 15) << 1) | ((ulid.data[9] & 128) >> 7)];
+    dst[15] = Encoding[(ulid.data[9] & 124) >> 2];
+    dst[16] = Encoding[((ulid.data[9] & 3) << 3) | ((ulid.data[10] & 224) >> 5)];
+    dst[17] = Encoding[ulid.data[10] & 31];
+    dst[18] = Encoding[(ulid.data[11] & 248) >> 3];
+    dst[19] = Encoding[((ulid.data[11] & 7) << 2) | ((ulid.data[12] & 192) >> 6)];
+    dst[20] = Encoding[(ulid.data[12] & 62) >> 1];
+    dst[21] = Encoding[((ulid.data[12] & 1) << 4) | ((ulid.data[13] & 240) >> 4)];
+    dst[22] = Encoding[((ulid.data[13] & 15) << 1) | ((ulid.data[14] & 128) >> 7)];
+    dst[23] = Encoding[(ulid.data[14] & 124) >> 2];
+    dst[24] = Encoding[((ulid.data[14] & 3) << 3) | ((ulid.data[15] & 224) >> 5)];
+    dst[25] = Encoding[ulid.data[15] & 31];
 }
 
 /**
  * MarshalBinaryTo will Marshal a ULID to the passed byte array
  * */
-inline void MarshalBinaryTo(const ULID& ulid, uint8_t dst[16]) {
-	// timestamp
-	dst[0] = ulid.data[0];
-	dst[1] = ulid.data[1];
-	dst[2] = ulid.data[2];
-	dst[3] = ulid.data[3];
-	dst[4] = ulid.data[4];
-	dst[5] = ulid.data[5];
-
-	// entropy
-	dst[6] = ulid.data[6];
-	dst[7] = ulid.data[7];
-	dst[8] = ulid.data[8];
-	dst[9] = ulid.data[9];
-	dst[10] = ulid.data[10];
-	dst[11] = ulid.data[11];
-	dst[12] = ulid.data[12];
-	dst[13] = ulid.data[13];
-	dst[14] = ulid.data[14];
-	dst[15] = ulid.data[15];
-}
-
-/**
- * MarshalBinary will Marshal a ULID to a byte vector.
- * */
-inline std::vector<uint8_t> MarshalBinary(const ULID& ulid) {
-	std::vector<uint8_t> dst(16);
-	MarshalBinaryTo(ulid, dst.data());
-	return dst;
+inline void MarshalBinaryTo(const ULID& ulid, uint8_t dst[16])
+{
+    // timestamp
+    dst[0] = ulid.data[0];
+    dst[1] = ulid.data[1];
+    dst[2] = ulid.data[2];
+    dst[3] = ulid.data[3];
+    dst[4] = ulid.data[4];
+    dst[5] = ulid.data[5];
+
+    // entropy
+    dst[6] = ulid.data[6];
+    dst[7] = ulid.data[7];
+    dst[8] = ulid.data[8];
+    dst[9] = ulid.data[9];
+    dst[10] = ulid.data[10];
+    dst[11] = ulid.data[11];
+    dst[12] = ulid.data[12];
+    dst[13] = ulid.data[13];
+    dst[14] = ulid.data[14];
+    dst[15] = ulid.data[15];
 }
 
 /**
@@ -487,230 +179,105 @@ inline std::vector<uint8_t> MarshalBinary(const ULID& ulid) {
  * 65-90 are capital alphabets.
  * */
 static const uint8_t dec[256] = {
-	0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
-	0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
-	0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
-	0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
-
-	0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
-	0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
-	/* 0     1     2     3     4     5     6     7  */
-	0x00, 0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07,
-	/* 8     9                                      */
-	0x08, 0x09, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
-
-	/*    10(A) 11(B) 12(C) 13(D) 14(E) 15(F) 16(G) */
-	0xFF, 0x0A, 0x0B, 0x0C, 0x0D, 0x0E, 0x0F, 0x10,
-	/*17(H)     18(J) 19(K)       20(M) 21(N)       */
-	0x11, 0xFF, 0x12, 0x13, 0xFF, 0x14, 0x15, 0xFF,
-	/*22(P)23(Q)24(R) 25(S) 26(T)       27(V) 28(W) */
-	0x16, 0x17, 0x18, 0x19, 0x1A, 0xFF, 0x1B, 0x1C,
-	/*29(X)30(Y)31(Z)                               */
-	0x1D, 0x1E, 0x1F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
-
-	0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
-	0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
-	0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
-	0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
-
-	0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
-	0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
-	0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
-	0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
-
-	0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
-	0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
-	0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
-	0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
-
-	0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
-	0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
-	0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
-	0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
-
-	0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
-	0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
-	0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
-	0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF
+    0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
+    0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
+    0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
+    0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
+
+    0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
+    0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
+    /* 0     1     2     3     4     5     6     7  */
+    0x00, 0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07,
+    /* 8     9                                      */
+    0x08, 0x09, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
+
+    /*    10(A) 11(B) 12(C) 13(D) 14(E) 15(F) 16(G) */
+    0xFF, 0x0A, 0x0B, 0x0C, 0x0D, 0x0E, 0x0F, 0x10,
+    /*17(H)     18(J) 19(K)       20(M) 21(N)       */
+    0x11, 0xFF, 0x12, 0x13, 0xFF, 0x14, 0x15, 0xFF,
+    /*22(P)23(Q)24(R) 25(S) 26(T)       27(V) 28(W) */
+    0x16, 0x17, 0x18, 0x19, 0x1A, 0xFF, 0x1B, 0x1C,
+    /*29(X)30(Y)31(Z)                               */
+    0x1D, 0x1E, 0x1F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
+
+    0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
+    0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
+    0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
+    0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
+
+    0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
+    0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
+    0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
+    0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
+
+    0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
+    0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
+    0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
+    0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
+
+    0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
+    0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
+    0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
+    0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
+
+    0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
+    0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
+    0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
+    0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF
 };
 
 /**
  * UnmarshalFrom will unmarshal a ULID from the passed character array.
  * */
-inline void UnmarshalFrom(const char str[26], ULID& ulid) {
-	// timestamp
-	ulid.data[0] = (dec[int(str[0])] << 5) | dec[int(str[1])];
-	ulid.data[1] = (dec[int(str[2])] << 3) | (dec[int(str[3])] >> 2);
-	ulid.data[2] = (dec[int(str[3])] << 6) | (dec[int(str[4])] << 1) | (dec[int(str[5])] >> 4);
-	ulid.data[3] = (dec[int(str[5])] << 4) | (dec[int(str[6])] >> 1);
-	ulid.data[4] = (dec[int(str[6])] << 7) | (dec[int(str[7])] << 2) | (dec[int(str[8])] >> 3);
-	ulid.data[5] = (dec[int(str[8])] << 5) | dec[int(str[9])];
-
-	// entropy
-	ulid.data[6] = (dec[int(str[10])] << 3) | (dec[int(str[11])] >> 2);
-	ulid.data[7] = (dec[int(str[11])] << 6) | (dec[int(str[12])] << 1) | (dec[int(str[13])] >> 4);
-	ulid.data[8] = (dec[int(str[13])] << 4) | (dec[int(str[14])] >> 1);
-	ulid.data[9] = (dec[int(str[14])] << 7) | (dec[int(str[15])] << 2) | (dec[int(str[16])] >> 3);
-	ulid.data[10] = (dec[int(str[16])] << 5) | dec[int(str[17])];
-	ulid.data[11] = (dec[int(str[18])] << 3) | (dec[int(str[19])] >> 2);
-	ulid.data[12] = (dec[int(str[19])] << 6) | (dec[int(str[20])] << 1) | (dec[int(str[21])] >> 4);
-	ulid.data[13] = (dec[int(str[21])] << 4) | (dec[int(str[22])] >> 1);
-	ulid.data[14] = (dec[int(str[22])] << 7) | (dec[int(str[23])] << 2) | (dec[int(str[24])] >> 3);
-	ulid.data[15] = (dec[int(str[24])] << 5) | dec[int(str[25])];
-}
-
-/**
- * Unmarshal will create a new ULID by unmarshaling the passed string.
- * */
-inline ULID Unmarshal(const std::string& str) {
-	ULID ulid;
-	UnmarshalFrom(str.c_str(), ulid);
-	return ulid;
+inline void UnmarshalFrom(const char str[26], ULID& ulid)
+{
+    // timestamp
+    ulid.data[0] = (dec[int(str[0])] << 5) | dec[int(str[1])];
+    ulid.data[1] = (dec[int(str[2])] << 3) | (dec[int(str[3])] >> 2);
+    ulid.data[2] = (dec[int(str[3])] << 6) | (dec[int(str[4])] << 1) | (dec[int(str[5])] >> 4);
+    ulid.data[3] = (dec[int(str[5])] << 4) | (dec[int(str[6])] >> 1);
+    ulid.data[4] = (dec[int(str[6])] << 7) | (dec[int(str[7])] << 2) | (dec[int(str[8])] >> 3);
+    ulid.data[5] = (dec[int(str[8])] << 5) | dec[int(str[9])];
+
+    // entropy
+    ulid.data[6] = (dec[int(str[10])] << 3) | (dec[int(str[11])] >> 2);
+    ulid.data[7] = (dec[int(str[11])] << 6) | (dec[int(str[12])] << 1) | (dec[int(str[13])] >> 4);
+    ulid.data[8] = (dec[int(str[13])] << 4) | (dec[int(str[14])] >> 1);
+    ulid.data[9] = (dec[int(str[14])] << 7) | (dec[int(str[15])] << 2) | (dec[int(str[16])] >> 3);
+    ulid.data[10] = (dec[int(str[16])] << 5) | dec[int(str[17])];
+    ulid.data[11] = (dec[int(str[18])] << 3) | (dec[int(str[19])] >> 2);
+    ulid.data[12] = (dec[int(str[19])] << 6) | (dec[int(str[20])] << 1) | (dec[int(str[21])] >> 4);
+    ulid.data[13] = (dec[int(str[21])] << 4) | (dec[int(str[22])] >> 1);
+    ulid.data[14] = (dec[int(str[22])] << 7) | (dec[int(str[23])] << 2) | (dec[int(str[24])] >> 3);
+    ulid.data[15] = (dec[int(str[24])] << 5) | dec[int(str[25])];
 }
 
 /**
  * UnmarshalBinaryFrom will unmarshal a ULID from the passed byte array.
  * */
-inline void UnmarshalBinaryFrom(const uint8_t b[16], ULID& ulid) {
-	// timestamp
-	ulid.data[0] = b[0];
-	ulid.data[1] = b[1];
-	ulid.data[2] = b[2];
-	ulid.data[3] = b[3];
-	ulid.data[4] = b[4];
-	ulid.data[5] = b[5];
-
-	// entropy
-	ulid.data[6] = b[6];
-	ulid.data[7] = b[7];
-	ulid.data[8] = b[8];
-	ulid.data[9] = b[9];
-	ulid.data[10] = b[10];
-	ulid.data[11] = b[11];
-	ulid.data[12] = b[12];
-	ulid.data[13] = b[13];
-	ulid.data[14] = b[14];
-	ulid.data[15] = b[15];
-}
-
-/**
- * Unmarshal will create a new ULID by unmarshaling the passed byte vector.
- * */
-inline ULID UnmarshalBinary(const std::vector<uint8_t>& b) {
-	ULID ulid;
-	UnmarshalBinaryFrom(b.data(), ulid);
-	return ulid;
-}
-
-/**
- * CompareULIDs will compare two ULIDs.
- * returns:
- *     -1 if ulid1 is Lexicographically before ulid2
- *      1 if ulid1 is Lexicographically after ulid2
- *      0 if ulid1 is same as ulid2
- * */
-inline int CompareULIDs(const ULID& ulid1, const ULID& ulid2) {
-	// for (int i = 0 ; i < 16 ; i++) {
-	// 	if (ulid1.data[i] != ulid2.data[i]) {
-	// 		return (ulid1.data[i] < ulid2.data[i]) * -2 + 1;
-	// 	}
-	// }
-
-	// unrolled loop
-
-	if (ulid1.data[0] != ulid2.data[0]) {
-		return (ulid1.data[0] < ulid2.data[0]) * -2 + 1;
-	}
-
-	if (ulid1.data[1] != ulid2.data[1]) {
-		return (ulid1.data[1] < ulid2.data[1]) * -2 + 1;
-	}
-
-	if (ulid1.data[2] != ulid2.data[2]) {
-		return (ulid1.data[2] < ulid2.data[2]) * -2 + 1;
-	}
-
-	if (ulid1.data[3] != ulid2.data[3]) {
-		return (ulid1.data[3] < ulid2.data[3]) * -2 + 1;
-	}
-
-	if (ulid1.data[4] != ulid2.data[4]) {
-		return (ulid1.data[4] < ulid2.data[4]) * -2 + 1;
-	}
-
-	if (ulid1.data[5] != ulid2.data[5]) {
-		return (ulid1.data[5] < ulid2.data[5]) * -2 + 1;
-	}
-
-	if (ulid1.data[6] != ulid2.data[6]) {
-		return (ulid1.data[6] < ulid2.data[6]) * -2 + 1;
-	}
-
-	if (ulid1.data[7] != ulid2.data[7]) {
-		return (ulid1.data[7] < ulid2.data[7]) * -2 + 1;
-	}
-
-	if (ulid1.data[8] != ulid2.data[8]) {
-		return (ulid1.data[8] < ulid2.data[8]) * -2 + 1;
-	}
-
-	if (ulid1.data[9] != ulid2.data[9]) {
-		return (ulid1.data[9] < ulid2.data[9]) * -2 + 1;
-	}
-
-	if (ulid1.data[10] != ulid2.data[10]) {
-		return (ulid1.data[10] < ulid2.data[10]) * -2 + 1;
-	}
-
-	if (ulid1.data[11] != ulid2.data[11]) {
-		return (ulid1.data[11] < ulid2.data[11]) * -2 + 1;
-	}
-
-	if (ulid1.data[12] != ulid2.data[12]) {
-		return (ulid1.data[12] < ulid2.data[12]) * -2 + 1;
-	}
-
-	if (ulid1.data[13] != ulid2.data[13]) {
-		return (ulid1.data[13] < ulid2.data[13]) * -2 + 1;
-	}
-
-	if (ulid1.data[14] != ulid2.data[14]) {
-		return (ulid1.data[14] < ulid2.data[14]) * -2 + 1;
-	}
-
-	if (ulid1.data[15] != ulid2.data[15]) {
-		return (ulid1.data[15] < ulid2.data[15]) * -2 + 1;
-	}
-
-	return 0;
-}
-
-/**
- * Time will extract the timestamp used to generate a ULID
- * */
-inline std::chrono::time_point<std::chrono::system_clock> Time(const ULID& ulid) {
-	int64_t ans = 0;
-
-	ans |= ulid.data[0];
-
-	ans <<= 8;
-	ans |= ulid.data[1];
-
-	ans <<= 8;
-	ans |= ulid.data[2];
-
-	ans <<= 8;
-	ans |= ulid.data[3];
-
-	ans <<= 8;
-	ans |= ulid.data[4];
-
-	ans <<= 8;
-	ans |= ulid.data[5];
-
-	return std::chrono::time_point<std::chrono::system_clock>(std::chrono::milliseconds{ans});
+inline void UnmarshalBinaryFrom(const uint8_t b[16], ULID& ulid)
+{
+    // timestamp
+    ulid.data[0] = b[0];
+    ulid.data[1] = b[1];
+    ulid.data[2] = b[2];
+    ulid.data[3] = b[3];
+    ulid.data[4] = b[4];
+    ulid.data[5] = b[5];
+
+    // entropy
+    ulid.data[6] = b[6];
+    ulid.data[7] = b[7];
+    ulid.data[8] = b[8];
+    ulid.data[9] = b[9];
+    ulid.data[10] = b[10];
+    ulid.data[11] = b[11];
+    ulid.data[12] = b[12];
+    ulid.data[13] = b[13];
+    ulid.data[14] = b[14];
+    ulid.data[15] = b[15];
 }
 
-};  // namespace ulid
+}; // namespace ulid
 
 #endif // ULID_STRUCT_HH