lastuuid 0.1.2__cp310-cp310-win_amd64.whl

lastuuid/__init__.py

@@ -0,0 +1,3 @@
+from .lastuuid import uuid7
+
+__all__ = ["uuid7"]

lastuuid/dummies.py

@@ -0,0 +1,23 @@
+"""A dummy uuid usefull for unit testing purpose."""
+
+from typing import Iterator
+from uuid import UUID
+
+
+def gen_id() -> Iterator[int]:
+    num = 0
+    while True:
+        num += 1
+        yield num
+
+
+next_id = gen_id()
+
+
+def uuidgen(i: int = 0, j: int = 0, k: int = 0, x: int = 0, y: int = 0) -> UUID:
+    """
+    A UUID generator that makes UUIDs more readable for humans.
+    """
+    if i == 0 and y == 0:
+        y = next(next_id)
+    return UUID(f"{i:0>8}-{j:0>4}-{k:0>4}-{x:0>4}-{y:0>12}")

lastuuid/lastuuid.pyi

@@ -0,0 +1,9 @@
+"""Pyo3 binding interface definition."""
+
+from uuid import UUID
+
+
+def uuid7() -> UUID:
+    """
+    Generate an uuid using uuidv7 format, the best format that feet in a BTree.
+    """

lastuuid-0.1.2.dist-info/METADATA

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: lastuuid
+Version: 0.1.2
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Rust
+Summary: UUID gen for the python standard library.
+Keywords: environment,substitution,variables
+Author: Guillaume Gauvrit <guillaume@gauvr.it>
+Author-email: Guillaume Gauvrit <guillaume@gauvr.it>
+License: MIT License
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Homepage, https://github.com/mardiros/lastuuid
+Project-URL: Documentation, https://github.com/mardiros/lastuuid/blob/main/README.md
+Project-URL: Repository, https://github.com/mardiros/lastuuid.git
+Project-URL: Issues, https://github.com/mardiros/lastuuid/issues
+Project-URL: Changelog, https://github.com/mardiros/lastuuid/blob/main/CHANGELOG.md
+
+# lastuuid - yet another uuid library
+
+UUID type is awesome, but, at the moment, the UUID type in the standard library
+does not support the uuid7 format.
+
+This is where lastuuid library is usefull.
+
+## Usage
+
+### UUID7
+
+```python
+>>> from lastuuid import uuid7
+>>> uuid7()
+UUID('019316cc-f99a-77b3-89d5-ed8c3cf1f50e')
+```
+
+There is no parameter here, the uuid is generated from the current time.
+
+The implementation of uuid7 algorithm is made in the uuid7 rust crate.
+
+#### Pydantic
+
+This lib has been created because all the other library that implement uuid7
+create there own UUID type, so its not easy to use with pydantic.
+
+```python
+from uuid import UUID
+from pydantic import BaseModel, Field
+
+from lastuuid import uuid7
+
+
+class Dummy(BaseModel):
+    id: UUID = Field(default_factory=uuid7)
+
+```
+
+#### Performance
+
+On my machine the uuid7 is as fast (or slow) as the native uuid4.
+
+```bash
+$ python -m timeit "from lastuuid import uuid7; uuid7()"
+200000 loops, best of 5: 1.8 usec per loop
+
+$ python -m timeit "from uuid import uuid4; uuid4()"
+200000 loops, best of 5: 1.82 usec per loop
+```
+
+### Testing with uuid without a brain
+
+The uuidgen method is not made for production code, it is not suited to be
+fast, it is here to generate uuid has autoincrement or as redictable ids,
+because UUID are made to create an identifier before it's saved into a
+database.
+
+
+Autoincrement your uuid in a test suite avoid some brain pain:
+
+```python
+>>> from lastuuid.dummies import uuidgen
+>>> uuidgen()
+UUID('00000000-0000-0000-0000-000000000001')
+>>> uuidgen()
+UUID('00000000-0000-0000-0000-000000000002')
+```
+
+Or even more usefull:
+
+UUID predicted, where only the first bunch of bytes needs to be read; or a few,
+to arrange some object ids.
+
+
+```python
+>>> from lastuuid.dummies import uuidgen
+>>> uuidgen(1)
+UUID('00000001-0000-0000-0000-000000000000')
+>>> uuidgen(1, 2, 3, 4, 5)
+UUID('00000001-0002-0003-0004-000000000005')
+```
+

lastuuid-0.1.2.dist-info/RECORD

@@ -0,0 +1,8 @@
+lastuuid-0.1.2.dist-info/METADATA,sha256=rvx50UZUSvA6VpX5t24NKyMcqjh9uHu9LI6LVg-uDsI,2870
+lastuuid-0.1.2.dist-info/WHEEL,sha256=ieLtPNGsC7xoJjcmwA6ZxvTXpcxDlcXaGCM87uD_Bf0,96
+lastuuid/dummies.py,sha256=appIhKdQLL_8Mo5Xb0fzYjBV6w3iJrHZzgk-JNAnej0,520
+lastuuid/lastuuid.pyi,sha256=UWNZIdqlzkbln21QRVGqfOX8sn6FLJUjbG3jlAT22O4,192
+lastuuid/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lastuuid/__init__.py,sha256=GwcZ4cGLHj95prUoK_-Te0TY3gxoLguXp-OEMIJNJzo,52
+lastuuid/lastuuid.cp310-win_amd64.pyd,sha256=Yi_ibq20DG8mJfHr39jg7qvg5aEIM6QhhCsvNWbxL1s,202240
+lastuuid-0.1.2.dist-info/RECORD,,

lastuuid-0.1.2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.7.8)
+Root-Is-Purelib: false
+Tag: cp310-cp310-win_amd64