Python helper libraries for MMID.
Project description
chatora.mmid
Python helper libraries for MMID. MMID is similar to UUIDv1 but sortable.
Usage
import datetime
import random
import uuid
from chatora.mmid.api import BaseMMID1
BASE_DT = datetime.datetime(2011, 1, 1, tzinfo=datetime.timezone.utc)
class MMID1v0(BaseMMID1):
UUID_VERSION = 4
MMID_VERSION = 0
TS_BIT_LENGTH = 55
EPOCH_DT = datetime.datetime(2010, 1, 1, tzinfo=datetime.timezone.utc)
# Construct
assert MMID1v0().version == 4
assert MMID1v0(dt=BASE_DT).dt == MMID1v0(ts=BASE_DT.timestamp()).dt == BASE_DT
# Sortable, which is useful for RDB column index (PostgreSQL UUID/BYTEA, MySQL BINARY).
assert MMID1v0(dt=BASE_DT) < MMID1v0(dt=BASE_DT + datetime.timedelta(days=1))
clock_seq = random.getrandbits(14)
assert MMID1v0(dt=BASE_DT, clock_seq=clock_seq) == MMID1v0(dt=BASE_DT, clock_seq=clock_seq)
# create_min_instance_from_time()/create_max_instance_from_time() may be useful if case of range query on RDB.
assert MMID1v0.create_min_instance_from_time(
dt=BASE_DT,
) == MMID1v0(hex_='811ed178-c6c0-4000-0000-000000000000')
assert MMID1v0.create_max_instance_from_time(
dt=BASE_DT,
) == MMID1v0(hex_='811ed178-c6c0-4000-ffff-ffffffffffff')
# Compatible with UUID1
uuid1 = uuid.uuid1()
mmid1v0 = MMID1v0(src_uuid1=uuid1)
assert uuid1 == mmid1v0
assert mmid1v0.uuid1 == uuid1
Changelog
0.1 (2019-01-16)
- Birth!
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
chatora.mmid-0.1.1.tar.gz
(9.8 kB
view hashes)
Built Distribution
Close
Hashes for chatora.mmid-0.1.1-py37-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 57b0d364d7782b219b93499a1ff23e26ee535e3b46ad86efb7767514d90798ad |
|
MD5 | 4117f869728d5f0338027a4eba352cc3 |
|
BLAKE2b-256 | 8c9262f8c58c25edc0313275becf63c4c31dd1981a00694807849c86528a770f |