ulid-transform 1.0.1__cp313-cp313-manylinux_2_17_i686.manylinux2014_i686.whl

ulid_transform/ulid_uint128.hh

@@ -0,0 +1,555 @@
+#ifndef ULID_UINT128_HH
+#define ULID_UINT128_HH
+
+#include <chrono>
+#include <cstdlib>
+#include <ctime>
+#include <functional>
+#include <random>
+#include <vector>
+
+#if _MSC_VER > 0
+typedef uint32_t rand_t;
+# else
+typedef uint8_t rand_t;
+#endif
+
+namespace ulid {
+
+/**
+ * ULID is a 16 byte Universally Unique Lexicographically Sortable Identifier
+ * */
+typedef __uint128_t ULID;
+
+/**
+ * EncodeTimestamp will encode the int64_t timestamp to the passed ulid
+ * */
+inline void EncodeTimestamp(int64_t timestamp, ULID& ulid) {
+	ULID t = static_cast<uint8_t>(timestamp >> 40);
+
+	t <<= 8;
+	t |= static_cast<uint8_t>(timestamp >> 32);
+
+	t <<= 8;
+	t |= static_cast<uint8_t>(timestamp >> 24);
+
+	t <<= 8;
+	t |= static_cast<uint8_t>(timestamp >> 16);
+
+	t <<= 8;
+	t |= static_cast<uint8_t>(timestamp >> 8);
+
+	t <<= 8;
+	t |= static_cast<uint8_t>(timestamp);
+
+	t <<= 80;
+
+	ULID mask = 1;
+	mask <<= 80;
+	mask--;
+
+	ulid = t | (ulid & mask);
+}
+
+/**
+ * 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();
+    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 = (ulid >> 80) << 80;
+
+	ULID e = rng();
+
+	e <<= 8;
+	e |= rng();
+
+	e <<= 8;
+	e |= rng();
+
+	e <<= 8;
+	e |= rng();
+
+	e <<= 8;
+	e |= rng();
+
+	e <<= 8;
+	e |= rng();
+
+	e <<= 8;
+	e |= rng();
+
+	e <<= 8;
+	e |= rng();
+
+	e <<= 8;
+	e |= rng();
+
+	e <<= 8;
+	e |= rng();
+
+	ulid |= e;
+}
+
+/**
+ * EncodeEntropyRand will encode a ulid using std::rand
+ *
+ * std::rand returns values in [0, RAND_MAX]
+ * */
+inline void EncodeEntropyRand(ULID& ulid) {
+	ulid = (ulid >> 80) << 80;
+
+	ULID e = (std::rand() * 255ull) / RAND_MAX;
+
+	e <<= 8;
+	e |= (std::rand() * 255ull) / RAND_MAX;
+
+	e <<= 8;
+	e |= (std::rand() * 255ull) / RAND_MAX;
+
+	e <<= 8;
+	e |= (std::rand() * 255ull) / RAND_MAX;
+
+	e <<= 8;
+	e |= (std::rand() * 255ull) / RAND_MAX;
+
+	e <<= 8;
+	e |= (std::rand() * 255ull) / RAND_MAX;
+
+	e <<= 8;
+	e |= (std::rand() * 255ull) / RAND_MAX;
+
+	e <<= 8;
+	e |= (std::rand() * 255ull) / RAND_MAX;
+
+	e <<= 8;
+	e |= (std::rand() * 255ull) / RAND_MAX;
+
+	e <<= 8;
+	e |= (std::rand() * 255ull) / RAND_MAX;
+
+	ulid |= e;
+}
+
+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 = (ulid >> 80) << 80;
+
+	ULID e = Distribution_0_255(generator);
+
+	e <<= 8;
+	e |= Distribution_0_255(generator);
+
+	e <<= 8;
+	e |= Distribution_0_255(generator);
+
+	e <<= 8;
+	e |= Distribution_0_255(generator);
+
+	e <<= 8;
+	e |= Distribution_0_255(generator);
+
+	e <<= 8;
+	e |= Distribution_0_255(generator);
+
+	e <<= 8;
+	e |= Distribution_0_255(generator);
+
+	e <<= 8;
+	e |= Distribution_0_255(generator);
+
+	e <<= 8;
+	e |= Distribution_0_255(generator);
+
+	e <<= 8;
+	e |= Distribution_0_255(generator);
+
+	ulid |= e;
+}
+
+/**
+ * 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 = 0;
+	Encode(timestamp, rng, ulid);
+	return ulid;
+}
+
+/**
+ * CreateNowRand:EncodeNowRand = Create:Encode.
+ * */
+inline ULID CreateNowRand() {
+	ULID ulid = 0;
+	EncodeNowRand(ulid);
+	return ulid;
+}
+
+/**
+ * Crockford's Base32
+ * */
+static const char Encoding[33] = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+
+/**
+ * MarshalTo will marshal a ULID to the passed character array.
+ *
+ * Implementation taken directly from oklog/ulid
+ * (https://sourcegraph.com/github.com/oklog/ulid@0774f81f6e44af5ce5e91c8d7d76cf710e889ebb/-/blob/ulid.go#L162-190)
+ *
+ * timestamp:
+ * dst[0]: first 3 bits of data[0]
+ * dst[1]: last 5 bits of data[0]
+ * dst[2]: first 5 bits of data[1]
+ * dst[3]: last 3 bits of data[1] + first 2 bits of data[2]
+ * dst[4]: bits 3-7 of data[2]
+ * dst[5]: last bit of data[2] + first 4 bits of data[3]
+ * dst[6]: last 4 bits of data[3] + first bit of data[4]
+ * dst[7]: bits 2-6 of data[4]
+ * dst[8]: last 2 bits of data[4] + first 3 bits of data[5]
+ * dst[9]: last 5 bits of data[5]
+ *
+ * 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[(static_cast<uint8_t>(ulid >> 120) & 224) >> 5];
+	dst[1] = Encoding[static_cast<uint8_t>(ulid >> 120) & 31];
+	dst[2] = Encoding[(static_cast<uint8_t>(ulid >> 112) & 248) >> 3];
+	dst[3] = Encoding[((static_cast<uint8_t>(ulid >> 112) & 7) << 2) | ((static_cast<uint8_t>(ulid >> 104) & 192) >> 6)];
+	dst[4] = Encoding[(static_cast<uint8_t>(ulid >> 104) & 62) >> 1];
+	dst[5] = Encoding[((static_cast<uint8_t>(ulid >> 104) & 1) << 4) | ((static_cast<uint8_t>(ulid >> 96) & 240) >> 4)];
+	dst[6] = Encoding[((static_cast<uint8_t>(ulid >> 96) & 15) << 1) | ((static_cast<uint8_t>(ulid >> 88) & 128) >> 7)];
+	dst[7] = Encoding[(static_cast<uint8_t>(ulid >> 88) & 124) >> 2];
+	dst[8] = Encoding[((static_cast<uint8_t>(ulid >> 88) & 3) << 3) | ((static_cast<uint8_t>(ulid >> 80) & 224) >> 5)];
+	dst[9] = Encoding[static_cast<uint8_t>(ulid >> 80) & 31];
+
+	// 16 bytes of entropy
+	dst[10] = Encoding[(static_cast<uint8_t>(ulid >> 72) & 248) >> 3];
+	dst[11] = Encoding[((static_cast<uint8_t>(ulid >> 72) & 7) << 2) | ((static_cast<uint8_t>(ulid >> 64) & 192) >> 6)];
+	dst[12] = Encoding[(static_cast<uint8_t>(ulid >> 64) & 62) >> 1];
+	dst[13] = Encoding[((static_cast<uint8_t>(ulid >> 64) & 1) << 4) | ((static_cast<uint8_t>(ulid >> 56) & 240) >> 4)];
+	dst[14] = Encoding[((static_cast<uint8_t>(ulid >> 56) & 15) << 1) | ((static_cast<uint8_t>(ulid >> 48) & 128) >> 7)];
+	dst[15] = Encoding[(static_cast<uint8_t>(ulid >> 48) & 124) >> 2];
+	dst[16] = Encoding[((static_cast<uint8_t>(ulid >> 48) & 3) << 3) | ((static_cast<uint8_t>(ulid >> 40) & 224) >> 5)];
+	dst[17] = Encoding[static_cast<uint8_t>(ulid >> 40) & 31];
+	dst[18] = Encoding[(static_cast<uint8_t>(ulid >> 32) & 248) >> 3];
+	dst[19] = Encoding[((static_cast<uint8_t>(ulid >> 32) & 7) << 2) | ((static_cast<uint8_t>(ulid >> 24) & 192) >> 6)];
+	dst[20] = Encoding[(static_cast<uint8_t>(ulid >> 24) & 62) >> 1];
+	dst[21] = Encoding[((static_cast<uint8_t>(ulid >> 24) & 1) << 4) | ((static_cast<uint8_t>(ulid >> 16) & 240) >> 4)];
+	dst[22] = Encoding[((static_cast<uint8_t>(ulid >> 16) & 15) << 1) | ((static_cast<uint8_t>(ulid >> 8) & 128) >> 7)];
+	dst[23] = Encoding[(static_cast<uint8_t>(ulid >> 8) & 124) >> 2];
+	dst[24] = Encoding[((static_cast<uint8_t>(ulid >> 8) & 3) << 3) | (((static_cast<uint8_t>(ulid)) & 224) >> 5)];
+	dst[25] = Encoding[(static_cast<uint8_t>(ulid)) & 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);
+}
+
+/**
+ * MarshalBinaryTo will Marshal a ULID to the passed byte array
+ * */
+inline void MarshalBinaryTo(const ULID& ulid, uint8_t dst[16]) {
+	// timestamp
+	dst[0] = static_cast<uint8_t>(ulid >> 120);
+	dst[1] = static_cast<uint8_t>(ulid >> 112);
+	dst[2] = static_cast<uint8_t>(ulid >> 104);
+	dst[3] = static_cast<uint8_t>(ulid >> 96);
+	dst[4] = static_cast<uint8_t>(ulid >> 88);
+	dst[5] = static_cast<uint8_t>(ulid >> 80);
+
+	// entropy
+	dst[6] = static_cast<uint8_t>(ulid >> 72);
+	dst[7] = static_cast<uint8_t>(ulid >> 64);
+	dst[8] = static_cast<uint8_t>(ulid >> 56);
+	dst[9] = static_cast<uint8_t>(ulid >> 48);
+	dst[10] = static_cast<uint8_t>(ulid >> 40);
+	dst[11] = static_cast<uint8_t>(ulid >> 32);
+	dst[12] = static_cast<uint8_t>(ulid >> 24);
+	dst[13] = static_cast<uint8_t>(ulid >> 16);
+	dst[14] = static_cast<uint8_t>(ulid >> 8);
+	dst[15] = static_cast<uint8_t>(ulid);
+}
+
+/**
+ * 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;
+}
+
+/**
+ * dec storesdecimal encodings for characters.
+ * 0xFF indicates invalid character.
+ * 48-57 are digits.
+ * 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
+};
+
+/**
+ * UnmarshalFrom will unmarshal a ULID from the passed character array.
+ * */
+inline void UnmarshalFrom(const char str[26], ULID& ulid) {
+	// timestamp
+	ulid = (dec[int(str[0])] << 5) | dec[int(str[1])];
+
+	ulid <<= 8;
+	ulid |= (dec[int(str[2])] << 3) | (dec[int(str[3])] >> 2);
+
+	ulid <<= 8;
+	ulid |= (dec[int(str[3])] << 6) | (dec[int(str[4])] << 1) | (dec[int(str[5])] >> 4);
+
+	ulid <<= 8;
+	ulid |= (dec[int(str[5])] << 4) | (dec[int(str[6])] >> 1);
+
+	ulid <<= 8;
+	ulid |= (dec[int(str[6])] << 7) | (dec[int(str[7])] << 2) | (dec[int(str[8])] >> 3);
+
+	ulid <<= 8;
+	ulid |= (dec[int(str[8])] << 5) | dec[int(str[9])];
+
+	// entropy
+	ulid <<= 8;
+	ulid |= (dec[int(str[10])] << 3) | (dec[int(str[11])] >> 2);
+
+	ulid <<= 8;
+	ulid |= (dec[int(str[11])] << 6) | (dec[int(str[12])] << 1) | (dec[int(str[13])] >> 4);
+
+	ulid <<= 8;
+	ulid |= (dec[int(str[13])] << 4) | (dec[int(str[14])] >> 1);
+
+	ulid <<= 8;
+	ulid |= (dec[int(str[14])] << 7) | (dec[int(str[15])] << 2) | (dec[int(str[16])] >> 3);
+
+	ulid <<= 8;
+	ulid |= (dec[int(str[16])] << 5) | dec[int(str[17])];
+
+	ulid <<= 8;
+	ulid |= (dec[int(str[18])] << 3) | (dec[int(str[19])] >> 2);
+
+	ulid <<= 8;
+	ulid |= (dec[int(str[19])] << 6) | (dec[int(str[20])] << 1) | (dec[int(str[21])] >> 4);
+
+	ulid <<= 8;
+	ulid |= (dec[int(str[21])] << 4) | (dec[int(str[22])] >> 1);
+
+	ulid <<= 8;
+	ulid |= (dec[int(str[22])] << 7) | (dec[int(str[23])] << 2) | (dec[int(str[24])] >> 3);
+
+	ulid <<= 8;
+	ulid |= (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;
+}
+
+/**
+ * UnmarshalBinaryFrom will unmarshal a ULID from the passed byte array.
+ * */
+inline void UnmarshalBinaryFrom(const uint8_t b[16], ULID& ulid) {
+	// timestamp
+	ulid = b[0];
+
+	ulid <<= 8;
+	ulid |= b[1];
+
+	ulid <<= 8;
+	ulid |= b[2];
+
+	ulid <<= 8;
+	ulid |= b[3];
+
+	ulid <<= 8;
+	ulid |= b[4];
+
+	ulid <<= 8;
+	ulid |= b[5];
+
+	// entropy
+	ulid <<= 8;
+	ulid |= b[6];
+
+	ulid <<= 8;
+	ulid |= b[7];
+
+	ulid <<= 8;
+	ulid |= b[8];
+
+	ulid <<= 8;
+	ulid |= b[9];
+
+	ulid <<= 8;
+	ulid |= b[10];
+
+	ulid <<= 8;
+	ulid |= b[11];
+
+	ulid <<= 8;
+	ulid |= b[12];
+
+	ulid <<= 8;
+	ulid |= b[13];
+
+	ulid <<= 8;
+	ulid |= b[14];
+
+	ulid <<= 8;
+	ulid |= 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) {
+	return -2 * (ulid1 < ulid2) - 1 * (ulid1 == ulid2) + 1;
+}
+
+/**
+ * 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 |= static_cast<uint8_t>(ulid >> 120);
+
+	ans <<= 8;
+	ans |= static_cast<uint8_t>(ulid >> 112);
+
+	ans <<= 8;
+	ans |= static_cast<uint8_t>(ulid >> 104);
+
+	ans <<= 8;
+	ans |= static_cast<uint8_t>(ulid >> 96);
+
+	ans <<= 8;
+	ans |= static_cast<uint8_t>(ulid >> 88);
+
+	ans <<= 8;
+	ans |= static_cast<uint8_t>(ulid >> 80);
+
+	return std::chrono::time_point<std::chrono::system_clock>(std::chrono::milliseconds{ans});
+}
+
+};  // namespace ulid
+
+#endif // ULID_UINT128_HH

ulid_transform/ulid_wrapper.cpp

@@ -0,0 +1,94 @@
+#include "ulid_wrapper.h"
+#include "ulid.hh"
+
+/**
+* Generate a new text ULID and write it to the provided buffer.
+* The buffer is NOT null-terminated.
+*/
+void _cpp_ulid(char dst[26]) {
+  ulid::ULID ulid;
+  ulid::EncodeTimeSystemClockNow(ulid);
+  ulid::EncodeEntropyRand(ulid);
+  ulid::MarshalTo(ulid, dst);
+}
+
+/**
+* Generate a new binary ULID and write it to the provided buffer.
+*/
+void _cpp_ulid_bytes(uint8_t dst[16]) {
+  ulid::ULID ulid;
+  ulid::EncodeTimeSystemClockNow(ulid);
+  ulid::EncodeEntropyRand(ulid);
+  ulid::MarshalBinaryTo(ulid, dst);
+}
+
+/**
+* Generate a new text ULID at the provided epoch time and write it to the provided buffer.
+* The buffer is NOT null-terminated.
+*/
+void _cpp_ulid_at_time(double epoch_time, char dst[26]) {
+  ulid::ULID ulid;
+  ulid::EncodeTimestamp(static_cast<int64_t>(epoch_time*1000), ulid);
+  ulid::EncodeEntropyRand(ulid);
+  ulid::MarshalTo(ulid, dst);
+}
+
+/**
+* Generate a new binary ULID at the provided epoch time and write it to the provided buffer.
+*/
+void _cpp_ulid_at_time_bytes(double epoch_time, uint8_t dst[16]) {
+  ulid::ULID ulid;
+  ulid::EncodeTimestamp(static_cast<int64_t>(epoch_time*1000), ulid);
+  ulid::EncodeEntropyRand(ulid);
+  ulid::MarshalBinaryTo(ulid, dst);
+}
+
+/**
+* Convert a text ULID to a binary ULID.
+* The buffer passed in must contain at least 26 bytes.
+* Invalid data will result in undefined behavior.
+*/
+void _cpp_ulid_to_bytes(const char * ulid_string, uint8_t dst[16]) {
+  ulid::ULID ulid;
+  ulid::UnmarshalFrom(ulid_string, ulid);
+  ulid::MarshalBinaryTo(ulid, dst);
+}
+
+/**
+* Convert a binary ULID to a text ULID.
+* The buffer passed in must contain at least 16 bytes.
+* The output buffer will NOT be null-terminated.
+*/
+void _cpp_bytes_to_ulid(const uint8_t b[16], char dst[26]) {
+  ulid::ULID ulid;
+  ulid::UnmarshalBinaryFrom(b, ulid);
+  ulid::MarshalTo(ulid, dst);
+}
+
+/**
+* Convert a buffer of exactly 16 bytes to 32 hex characters.
+* The output buffer will NOT be null-terminated.
+*/
+void _cpp_hexlify_16(const uint8_t b[16], char dst[32]) {
+    static const char hexdigits[17] = "0123456789abcdef";
+    int in_index, out_index;
+    for (in_index = out_index = 0; in_index < 16; in_index++) {
+        uint8_t c = b[in_index];
+        dst[out_index++] = hexdigits[c >> 4];
+        dst[out_index++] = hexdigits[c & 0x0f];
+    }
+}
+
+/**
+* Interpret the first 6 bytes of a binary ULID as a timestamp.
+*/
+uint64_t _cpp_bytes_to_timestamp(const uint8_t b[16]) {
+    uint64_t timestamp = 0;
+    timestamp |= static_cast<uint64_t>(b[0]) << 40;
+    timestamp |= static_cast<uint64_t>(b[1]) << 32;
+    timestamp |= static_cast<uint64_t>(b[2]) << 24;
+    timestamp |= static_cast<uint64_t>(b[3]) << 16;
+    timestamp |= static_cast<uint64_t>(b[4]) << 8;
+    timestamp |= static_cast<uint64_t>(b[5]);
+    return timestamp;
+}

ulid_transform/ulid_wrapper.h

@@ -0,0 +1,13 @@
+#ifndef ULID_WRAPPER_H
+#define ULID_WRAPPER_H
+#include <stdint.h>
+
+void _cpp_ulid(char dst[26]);
+void _cpp_ulid_bytes(uint8_t dst[16]);
+void _cpp_ulid_at_time(double epoch_time, char dst[26]);
+void _cpp_ulid_at_time_bytes(double epoch_time, uint8_t dst[16]);
+void _cpp_ulid_to_bytes(const char * ulid_string, uint8_t dst[16]);
+void _cpp_bytes_to_ulid(const uint8_t b[16], char dst[26]);
+void _cpp_hexlify_16(const uint8_t b[16], char dst[32]);
+uint64_t _cpp_bytes_to_timestamp(const uint8_t b[16]);
+#endif

ulid_transform-1.0.1.dist-info/LICENSE

@@ -0,0 +1,22 @@
+
+MIT License
+
+Copyright (c) 2022 J. Nick Koston
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.