sdata 1.5.0__py3-none-any.whl

sdata/contrib/timeflake/flake.py

@@ -0,0 +1,69 @@
+import time
+import uuid
+from functools import lru_cache
+
+from sdata.contrib.timeflake.utils import atoi, itoa
+
+BASE62 = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz"
+HEX = "0123456789abcdef"
+MAX_TIMESTAMP = 281474976710655
+MAX_RANDOM = 1208925819614629174706175
+MAX_TIMEFLAKE = 340282366920938463463374607431768211455
+
+
+class Timeflake:
+    def __init__(self, from_bytes: bytes):
+        if from_bytes is None:
+            raise ValueError("from_bytes is a required parameter")
+        self._bytes = from_bytes
+        # Validate flake
+        as_int = self.int
+        if as_int < 0 or MAX_TIMEFLAKE < as_int:
+            raise ValueError("Invalid flake provided")
+
+    @property
+    def bytes(self) -> bytes:
+        return self._bytes
+
+    @property
+    def uuid(self) -> uuid.UUID:
+        return uuid.UUID(bytes=self.bytes)
+
+    @property
+    def int(self) -> int:
+        return int.from_bytes(self.bytes, "big", signed=False)
+
+    @property
+    @lru_cache(1)
+    def hex(self) -> str:
+        return itoa(self.int, HEX, padding=32)
+
+    @property
+    @lru_cache(1)
+    def base62(self) -> str:
+        return itoa(self.int, BASE62, padding=22)
+
+    @property
+    def timestamp(self) -> int:
+        return self.int >> 80
+
+    @property
+    def random(self) -> int:
+        return self.int & MAX_RANDOM
+
+    def __hash__(self) -> int:
+        return self.int
+
+    def __eq__(self, other) -> bool:
+        if not isinstance(other, Timeflake):
+            return False
+        return other.int == self.int
+
+    def __lt__(self, other) -> bool:
+        return self.int < other.int
+
+    def __repr__(self) -> str:
+        return f"Timeflake('{self.hex}')"
+
+    def __str__(self) -> str:
+        return self.base62

sdata/contrib/timeflake/utils.py

@@ -0,0 +1,47 @@
+from functools import lru_cache
+
+
+@lru_cache(2)
+def _index_alphabet(alphabet):
+    return {char: i for i, char in enumerate(alphabet)}
+
+
+def itoa(value, alphabet, padding=None):
+    """
+    Converts an int value to a str, using the given alphabet.
+    Padding can be computed as: ceil(log of max_val base alphabet_len)
+    """
+    if value < 0:
+        raise ValueError("Only positive numbers are allowed")
+    elif value == 0:
+        return alphabet[0]
+
+    result = ""
+    base = len(alphabet)
+
+    while value:
+        value, rem = divmod(value, base)
+        result = alphabet[rem] + result
+
+    if padding:
+        fill = max(padding - len(result), 0)
+        result = (alphabet[0] * fill) + result
+
+    return result
+
+
+def atoi(value, alphabet):
+    """
+    Converts a str value to an int, using the given alphabet.
+    """
+    if value == alphabet[0]:
+        return 0
+
+    index = _index_alphabet(alphabet)
+    result = 0
+    base = len(alphabet)
+
+    for char in value:
+        result = result * base + index[char]
+
+    return result

sdata/deprecated/__init__.py

@@ -0,0 +1,10 @@
+# -*- coding: utf-8 -*-
+"""Deprecated sdata-Module.
+
+Hier liegen abgelöste, nicht mehr weiterentwickelte Klassen. ``Data`` wird durch
+:class:`sdata.sclass.dataframe.DataFrame` ersetzt und nur aus
+Kompatibilitätsgründen weiter exportiert.
+
+Bewusst ohne ``from sdata import ...`` (Zirkularität) und aus der Coverage
+ausgeblendet.
+"""