ulid-transform 1.5.2__cp314-cp314t-musllinux_1_2_aarch64.whl

ulid_transform/ulid_wrapper.cpp

@@ -0,0 +1,107 @@
+#include "ulid_wrapper.h"
+
+#ifdef __SIZEOF_INT128__ // http://stackoverflow.com/a/23981011
+#include "ulid_uint128.hh"
+#else
+#include "ulid_struct.hh"
+#endif
+
+/**
+ * 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::EncodeEntropyMt19937Fast(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::EncodeEntropyMt19937Fast(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::EncodeEntropyMt19937Fast(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::EncodeEntropyMt19937Fast(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.5.2.dist-info/METADATA

@@ -0,0 +1,108 @@
+Metadata-Version: 2.4
+Name: ulid-transform
+Version: 1.5.2
+Summary: Create and transform ULIDs
+License-Expression: MIT
+License-File: LICENSE
+Author: J. Nick Koston
+Author-email: nick@koston.org
+Requires-Python: >=3.11
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries
+Project-URL: Bug Tracker, https://github.com/bluetooth-devices/ulid-transform/issues
+Project-URL: Changelog, https://github.com/bluetooth-devices/ulid-transform/blob/main/CHANGELOG.md
+Project-URL: Repository, https://github.com/bluetooth-devices/ulid-transform
+Description-Content-Type: text/markdown
+
+# Fast ULID transformations
+
+<p align="center">
+  <a href="https://github.com/bluetooth-devices/ulid-transform/actions/workflows/ci.yml?query=branch%3Amain">
+    <img src="https://img.shields.io/github/actions/workflow/status/bluetooth-devices/ulid-transform/ci.yml?branch=main&label=CI&logo=github&style=flat-square" alt="CI Status" >
+  </a>
+  <a href="https://codecov.io/gh/bluetooth-devices/ulid-transform">
+    <img src="https://img.shields.io/codecov/c/github/bluetooth-devices/ulid-transform.svg?logo=codecov&logoColor=fff&style=flat-square" alt="Test coverage percentage">
+  </a>
+</p>
+<p align="center">
+  <a href="https://python-poetry.org/">
+    <img src="https://img.shields.io/badge/packaging-poetry-299bd7?style=flat-square&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA4AAAASCAYAAABrXO8xAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAJJSURBVHgBfZLPa1NBEMe/s7tNXoxW1KJQKaUHkXhQvHgW6UHQQ09CBS/6V3hKc/AP8CqCrUcpmop3Cx48eDB4yEECjVQrlZb80CRN8t6OM/teagVxYZi38+Yz853dJbzoMV3MM8cJUcLMSUKIE8AzQ2PieZzFxEJOHMOgMQQ+dUgSAckNXhapU/NMhDSWLs1B24A8sO1xrN4NECkcAC9ASkiIJc6k5TRiUDPhnyMMdhKc+Zx19l6SgyeW76BEONY9exVQMzKExGKwwPsCzza7KGSSWRWEQhyEaDXp6ZHEr416ygbiKYOd7TEWvvcQIeusHYMJGhTwF9y7sGnSwaWyFAiyoxzqW0PM/RjghPxF2pWReAowTEXnDh0xgcLs8l2YQmOrj3N7ByiqEoH0cARs4u78WgAVkoEDIDoOi3AkcLOHU60RIg5wC4ZuTC7FaHKQm8Hq1fQuSOBvX/sodmNJSB5geaF5CPIkUeecdMxieoRO5jz9bheL6/tXjrwCyX/UYBUcjCaWHljx1xiX6z9xEjkYAzbGVnB8pvLmyXm9ep+W8CmsSHQQY77Zx1zboxAV0w7ybMhQmfqdmmw3nEp1I0Z+FGO6M8LZdoyZnuzzBdjISicKRnpxzI9fPb+0oYXsNdyi+d3h9bm9MWYHFtPeIZfLwzmFDKy1ai3p+PDls1Llz4yyFpferxjnyjJDSEy9CaCx5m2cJPerq6Xm34eTrZt3PqxYO1XOwDYZrFlH1fWnpU38Y9HRze3lj0vOujZcXKuuXm3jP+s3KbZVra7y2EAAAAAASUVORK5CYII=" alt="Poetry">
+  </a>
+  <a href="https://github.com/ambv/black">
+    <img src="https://img.shields.io/badge/code%20style-black-000000.svg?style=flat-square" alt="black">
+  </a>
+  <a href="https://github.com/pre-commit/pre-commit">
+    <img src="https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white&style=flat-square" alt="pre-commit">
+  </a>
+  <a href="https://codspeed.io/bluetooth-devices/ulid-transform"><img src="https://img.shields.io/endpoint?url=https://codspeed.io/badge.json" alt="CodSpeed Badge"/></a>
+</p>
+<p align="center">
+  <a href="https://pypi.org/project/ulid-transform/">
+    <img src="https://img.shields.io/pypi/v/ulid-transform.svg?logo=python&logoColor=fff&style=flat-square" alt="PyPI Version">
+  </a>
+  <img src="https://img.shields.io/pypi/pyversions/ulid-transform.svg?style=flat-square&logo=python&amp;logoColor=fff" alt="Supported Python versions">
+  <img src="https://img.shields.io/pypi/l/ulid-transform.svg?style=flat-square" alt="License">
+</p>
+
+Create and transform ULIDs
+
+This library will use the CPP implementation from https://github.com/suyash/ulid if cython is available, and will fallback to pure python if it is not.
+
+## Example
+
+```python
+>>> import ulid_transform
+>>> ulid_transform.ulid_hex()
+'01869a2ea5fb0b43aa056293e47c0a35'
+>>> ulid_transform.ulid_now()
+'0001HZX0NW00GW0X476W5TVBFE'
+>>> ulid_transform.ulid_at_time(1234)
+'000000016JC62D620DGYNG2R8H'
+>>> ulid_transform.ulid_to_bytes('0001HZX0NW00GW0X476W5TVBFE')
+b'\x00\x00c\xfe\x82\xbc\x00!\xc0t\x877\x0b\xad\xad\xee'
+>> ulid_transform.bytes_to_ulid(b"\x01\x86\x99?\xe8\xf3\x11\xbc\xed\xef\x86U.9\x03z")
+'01GTCKZT7K26YEVVW6AMQ3J0VT'
+>>> ulid_transform.ulid_to_bytes_or_none('0001HZX0NW00GW0X476W5TVBFE')
+b'\x00\x00c\xfe\x82\xbc\x00!\xc0t\x877\x0b\xad\xad\xee'
+>>> ulid_transform.ulid_to_bytes_or_none(None)
+>>> ulid_transform.bytes_to_ulid_or_none(b'\x00\x00c\xfe\x82\xbc\x00!\xc0t\x877\x0b\xad\xad\xee')
+'0001HZX0NW00GW0X476W5TVBFE'
+>>> ulid_transform.bytes_to_ulid_or_none(None)
+```
+
+## Installation
+
+Install this via pip (or your favourite package manager):
+
+`pip install ulid-transform`
+
+## Contributors ✨
+
+Thanks to https://github.com/suyash/ulid which provides the cython implementation guts.
+
+Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
+
+<!-- prettier-ignore-start -->
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- markdownlint-disable -->
+<!-- markdownlint-enable -->
+<!-- ALL-CONTRIBUTORS-LIST:END -->
+<!-- prettier-ignore-end -->
+
+This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
+
+## Credits
+
+This package was created with
+[Copier](https://copier.readthedocs.io/) and the
+[browniebroke/pypackage-template](https://github.com/browniebroke/pypackage-template)
+project template.
+

ulid_transform-1.5.2.dist-info/RECORD

@@ -0,0 +1,17 @@
+ulid_transform/__init__.py,sha256=thyiD_vtcTLh6M-B_547NQzEiz2sxetBoHTieXYj6tc,853
+ulid_transform/__init__.pyi,sha256=eRmwQvXnwgj1mhdVokznDZVwOl2Xr_5tEAertTjkI5s,468
+ulid_transform/_py_ulid_impl.py,sha256=hqam9a2A149GUgRzdWdjB2BQ2P_hgTInP1p4JY0Ijz8,10241
+ulid_transform/_ulid_impl.cpython-314-aarch64-linux-musl.so,sha256=Yd_sUwDVCa1rUKI506nlQ3Cr82FfrA1PsCFo6rLqMoM,269041
+ulid_transform/_ulid_impl.cpython-314t-aarch64-linux-musl.so,sha256=57pOPcFPGarm3WUx3eZBSfQ60qgrPOyuxRVT9vVtCn0,269241
+ulid_transform/_ulid_impl.pyx,sha256=C64Ca_ydLglYYadIVgrQvMMVKPbpc6nfaOHTFK66ORU,4441
+ulid_transform/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ulid_transform/ulid_struct.hh,sha256=tXsl6nrXKI_BGwfHWloWrylaaB71ViXt_IZcso28PHM,10301
+ulid_transform/ulid_uint128.hh,sha256=X_f8EzVdCZvhFvYevCX3kM9FMpfrKAapoRPN4YTxbVM,11331
+ulid_transform/ulid_wrapper.cpp,sha256=lJwX2x19okXRMTA8Pew9HzWt-1iofS7RUEIvI65zAdM,3008
+ulid_transform/ulid_wrapper.h,sha256=3Yuy3H5uN-cRNRMbQvL40NPwXwOfCsTe8KtwyxPZrqg,505
+ulid_transform.libs/libgcc_s-2d945d6c.so.1,sha256=dn-5kQf6XkEWhBOx7tnXMZHJQSbDdSYmPhrx8fiYeI8,201673
+ulid_transform.libs/libstdc++-85f2cd6d.so.6.0.33,sha256=VjT6H3rGbIUp02akWf5sJoz8LifUZ4OFZJYGOR_KyeI,3650097
+ulid_transform-1.5.2.dist-info/METADATA,sha256=vMtfUWYKGcFvVbpYXvdDqntiakuO0CQqtoC3AADg3zY,5619
+ulid_transform-1.5.2.dist-info/WHEEL,sha256=JkqnkBKKARxt3NaO7JXzb98blo4sl67hY_iM8_VdDUI,111
+ulid_transform-1.5.2.dist-info/RECORD,,
+ulid_transform-1.5.2.dist-info/licenses/LICENSE,sha256=gieJjxNidEKH1VXLqbV9tuqnmcnqvMqt5xcmktkn5I4,1072

ulid_transform-1.5.2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 2.2.1
+Root-Is-Purelib: false
+Tag: cp314-cp314t-musllinux_1_2_aarch64

ulid_transform-1.5.2.dist-info/licenses/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.