ulid-transform 0.9.0__cp310-cp310-win32.whl → 0.10.1__cp310-cp310-win32.whl

ulid_transform/__init__.py

@@ -1,5 +1,21 @@
-__version__ = "0.9.0"
+__version__ = "0.10.1"
 
-from .ulid_impl import bytes_to_ulid, ulid_at_time, ulid_hex, ulid_now, ulid_to_bytes
+from .ulid_impl import (
+    bytes_to_ulid,
+    bytes_to_ulid_or_none,
+    ulid_at_time,
+    ulid_hex,
+    ulid_now,
+    ulid_to_bytes,
+    ulid_to_bytes_or_none,
+)
 
-__all__ = ["ulid_now", "ulid_at_time", "ulid_hex", "ulid_to_bytes", "bytes_to_ulid"]
+__all__ = [
+    "ulid_now",
+    "ulid_at_time",
+    "ulid_hex",
+    "ulid_to_bytes",
+    "bytes_to_ulid",
+    "ulid_to_bytes_or_none",
+    "bytes_to_ulid_or_none",
+]

ulid_transform/_ulid_impl.pyx

@@ -2,6 +2,7 @@
 from libcpp.string cimport string
 
 from time import time
+from typing import Optional
 
 import cython
 
@@ -28,3 +29,13 @@ def _bytes_to_ulid(ulid_bytes: bytes) -> str:
     if len(ulid_bytes) != 16:
         raise ValueError(f"ULID bytes be 16 bytes: {ulid_bytes}")
     return _cpp_bytes_to_ulid(ulid_bytes).decode("ascii")
+
+def _ulid_to_bytes_or_none(ulid_str: Optional[str]) -> Optional[bytes]:
+    if ulid_str is None or len(ulid_str) != 26:
+        return None
+    return _cpp_ulid_to_bytes(ulid_str.encode("ascii"))
+
+def _bytes_to_ulid_or_none(ulid_bytes: Optional[bytes]) -> Optional[str]:
+    if ulid_bytes is None or len(ulid_bytes) != 16:
+        return None
+    return _cpp_bytes_to_ulid(ulid_bytes).decode("ascii")

ulid_transform/ulid_impl.py

@@ -410,10 +410,33 @@ def bytes_to_ulid(value: bytes) -> str:
     return _encode(value)
 
 
+def ulid_to_bytes_or_none(ulid: str | None) -> bytes | None:
+    """Convert an ulid to bytes."""
+    if ulid is None:
+        return None
+    try:
+        return ulid_to_bytes(ulid)
+    except ValueError:
+        return None
+
+
+def bytes_to_ulid_or_none(_bytes: bytes | None) -> str | None:
+    """Convert bytes to a ulid."""
+    if _bytes is None:
+        return None
+    try:
+        return bytes_to_ulid(_bytes)
+    except ValueError:
+        return None
+
+
 try:
     from ._ulid_impl import (  # type: ignore[no-redef] # noqa: F811 F401 # pragma: no cover
         _bytes_to_ulid as bytes_to_ulid,
     )
+    from ._ulid_impl import (  # type: ignore[no-redef] # noqa: F811 F401 # pragma: no cover
+        _bytes_to_ulid_or_none as bytes_to_ulid_or_none,
+    )
     from ._ulid_impl import (  # type: ignore[no-redef] # noqa: F811 F401 # pragma: no cover
         _ulid_at_time as ulid_at_time,
     )
@@ -423,5 +446,8 @@ try:
     from ._ulid_impl import (  # type: ignore[no-redef] # noqa: F811 F401 # pragma: no cover
         _ulid_to_bytes as ulid_to_bytes,
     )
+    from ._ulid_impl import (  # type: ignore[no-redef] # noqa: F811 F401 # pragma: no cover
+        _ulid_to_bytes_or_none as ulid_to_bytes_or_none,
+    )
 except ImportError:  # pragma: no cover
     pass  # pragma: no cover

{ulid_transform-0.9.0.dist-info → ulid_transform-0.10.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ulid-transform
-Version: 0.9.0
+Version: 0.10.1
 Summary: Create and transform ULIDs
 Home-page: https://github.com/bdraco/ulid-transform
 License: MIT
@@ -15,6 +15,7 @@ Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Software Development :: Libraries
 Project-URL: Bug Tracker, https://github.com/bdraco/ulid-transform/issues
 Project-URL: Changelog, https://github.com/bdraco/ulid-transform/blob/main/CHANGELOG.md
@@ -68,6 +69,12 @@ This library will use the CPP implementation from https://github.com/suyash/ulid
 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

ulid_transform-0.10.1.dist-info/RECORD

@@ -0,0 +1,14 @@
+ulid_transform/__init__.py,sha256=p3JHoB6geHaG050xbrrcyDbWg6c1S7lz_mZ8RKaUHoc,377
+ulid_transform/_ulid_impl.pyx,sha256=Qlhh9TuB5JyxNHhr370W5pgYx5AdZpkvANbBYVLCmWY,1347
+ulid_transform/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ulid_transform/ulid.hh,sha256=RwGduPUOt5AEfAaAkafGaHyhr2yd7vfHJeY0lOXlTPw,312
+ulid_transform/ulid_impl.py,sha256=-OqxT7yi7tloT6EnRMmxLMgSLmGSb-hPhO4kn99vDiU,10934
+ulid_transform/ulid_struct.hh,sha256=Jh326iAyOkEaEpBZr4CY6xOOSXqO_hcsBS37qUcUCeM,20025
+ulid_transform/ulid_uint128.hh,sha256=ibwgd8Qksjc0oG52h8kb7ClJruJe9CyfMQra4B3fk1E,15370
+ulid_transform/ulid_wrapper.cpp,sha256=-S7Eq1ae0bHeEOaY1uWHRn2RA9MQG2PrFcIJSl_37Rg,933
+ulid_transform/ulid_wrapper.h,sha256=H_AaGGLSS3ymjaRh4uUhG-lvFUrwJhnLL0irzDoqgZM,275
+ulid_transform/_ulid_impl.cp310-win32.pyd,sha256=c-Ph7363VI2BpZC_g6VGa_x624UIRYcRMaW-kfAEfd4,48128
+ulid_transform-0.10.1.dist-info/LICENSE,sha256=glXAnenXQvBuN4WzZ8ikikOHF6v3qq4_z8fCZobbgxs,1094
+ulid_transform-0.10.1.dist-info/METADATA,sha256=ydvpOxvAknjpYdK-nYRIh4MinZg1R5YeM21If61j25I,5389
+ulid_transform-0.10.1.dist-info/WHEEL,sha256=Svdtsh_n4IQBUqbkNwiBdP0wkpbnh9mYvfQdH6BQhAs,94
+ulid_transform-0.10.1.dist-info/RECORD,,

{ulid_transform-0.9.0.dist-info → ulid_transform-0.10.1.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 1.7.0
+Generator: poetry-core 1.9.0
 Root-Is-Purelib: false
 Tag: cp310-cp310-win32

ulid_transform-0.9.0.dist-info/RECORD

@@ -1,14 +0,0 @@
-ulid_transform/__init__.py,sha256=Ygji_LvT3WDRjCkum56ZATKaKBDuPVOobFdvnjgKuR8,200
-ulid_transform/_ulid_impl.pyx,sha256=YpiQyHY-1L3n0WZMnfLV2iKxX_UdvdcukunYmb2sfco,906
-ulid_transform/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-ulid_transform/ulid.hh,sha256=RwGduPUOt5AEfAaAkafGaHyhr2yd7vfHJeY0lOXlTPw,312
-ulid_transform/ulid_impl.py,sha256=axxu_OzIg2IbRwomlwJWzUOhkfSqSlSFq4PwwljvG3o,10137
-ulid_transform/ulid_struct.hh,sha256=Jh326iAyOkEaEpBZr4CY6xOOSXqO_hcsBS37qUcUCeM,20025
-ulid_transform/ulid_uint128.hh,sha256=ibwgd8Qksjc0oG52h8kb7ClJruJe9CyfMQra4B3fk1E,15370
-ulid_transform/ulid_wrapper.cpp,sha256=-S7Eq1ae0bHeEOaY1uWHRn2RA9MQG2PrFcIJSl_37Rg,933
-ulid_transform/ulid_wrapper.h,sha256=H_AaGGLSS3ymjaRh4uUhG-lvFUrwJhnLL0irzDoqgZM,275
-ulid_transform/_ulid_impl.cp310-win32.pyd,sha256=DsV5G9fqFw6qGIC9szXC5XiyMHbkTWosGrjCxZBQ28s,44032
-ulid_transform-0.9.0.dist-info/LICENSE,sha256=glXAnenXQvBuN4WzZ8ikikOHF6v3qq4_z8fCZobbgxs,1094
-ulid_transform-0.9.0.dist-info/METADATA,sha256=u-O1V_V9o2imsx2LvthvkmxuhyYXzpcVcSg8LCWiJBo,4989
-ulid_transform-0.9.0.dist-info/WHEEL,sha256=U_aieYgVgnjpBlVf2E_HWIwF1cD-y7OSzO3POi3yL5k,94
-ulid_transform-0.9.0.dist-info/RECORD,,