def test_from_randomness_with_incorrect_size_bytes_raises(valid_bytes_128):
"""
Assert that :func:`~ulid.api.from_randomness` raises a :class:`~ValueError` when given
a type that cannot be represented as exactly 80 bits.
"""
with pytest.raises(ValueError) as ex:
api.from_randomness(valid_bytes_128)
assert ex.match(RANDOMNESS_SIZE_EXC_REGEX)
def test_from_randomness_with_unsupported_type_raises(unsupported_type):
"""
Assert that :func:`~ulid.api.from_randomness` raises a :class:`~ValueError` when given
a type it cannot compute a randomness value from.
"""
with pytest.raises(ValueError) as ex:
api.from_randomness(unsupported_type())
assert ex.match(UNSUPPORTED_RANDOMNESS_TYPE_EXC_REGEX)
def test_from_randomness_ulid_returns_ulid_instance(valid_bytes_128):
"""
Assert that :func:`~ulid.api.from_randomness` returns a new :class:`~ulid.ulid.ULID` instance
from the given random values as a :class:`~ulid.ulid.ULID`.
"""
value = ulid.ULID(valid_bytes_128)
instance = api.from_randomness(value)
assert isinstance(instance, ulid.ULID)
assert instance.randomness() == value.randomness()
def test_from_randomness_str_returns_ulid_instance(valid_bytes_80):
"""
Assert that :func:`~ulid.api.from_randomness` returns a new :class:`~ulid.ulid.ULID` instance
from the given random values as an :class:`~str`.
"""
value = base32.encode_randomness(valid_bytes_80)
instance = api.from_randomness(value)
assert isinstance(instance, ulid.ULID)
assert instance.randomness().str == value
def test_from_randomness_float_returns_ulid_instance(valid_bytes_80):
"""
Assert that :func:`~ulid.api.from_randomness` returns a new :class:`~ulid.ulid.ULID` instance
from the given random values as an :class:`~float`.
"""
value = float(int.from_bytes(valid_bytes_80, byteorder='big'))
instance = api.from_randomness(value)
assert isinstance(instance, ulid.ULID)
assert instance.randomness().int == int(value)
def test_from_randomness_bytes_returns_ulid_instance(buffer_type,
valid_bytes_80):
"""
Assert that :func:`~ulid.api.from_randomness` returns a new :class:`~ulid.ulid.ULID` instance
from the given random values as an object that supports the buffer protocol.
"""
value = buffer_type(valid_bytes_80)
instance = api.from_randomness(value)
assert isinstance(instance, ulid.ULID)
assert instance.randomness().bytes == value
