1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39
|
Utilities
=========
.. currentmodule:: nacl.utils
.. class:: EncryptedMessage
A ``bytes`` subclass that holds a message that has been encrypted by a
:class:`~nacl.secret.SecretBox` or :class:`~nacl.public.Box`. The full
content of the ``bytes`` object is the combined ``nonce`` and
``ciphertext``.
.. attribute:: nonce
The nonce used during the encryption of the :class:`EncryptedMessage`.
.. attribute:: ciphertext
The ciphertext contained within the :class:`EncryptedMessage`.
.. function:: random(size=32)
Returns a random bytestring with the given ``size``.
:param bytes size: The size of the random bytestring.
:return bytes: The random bytestring.
.. function:: ensure(cond, *args, raising=nacl.exceptions.AssertionError)
Returns if a condition is true, otherwise raise a caller-configurable
:py:class:`Exception`
:param cond: the condition to be checked
:type cond: bool
:param sequence args: the arguments to be passed to the exception's
constructor
:param raising: the exception to be raised if `cond` is `False`
:type raising: exception
|