ciphers.base16
==============

.. py:module:: ciphers.base16


Functions
---------

.. autoapisummary::

   ciphers.base16.base16_decode
   ciphers.base16.base16_encode


Module Contents
---------------

.. py:function:: base16_decode(data: str) -> bytes

   Decodes the given base16 encoded data into bytes.

   >>> base16_decode('48656C6C6F20576F726C6421')
   b'Hello World!'
   >>> base16_decode('48454C4C4F20574F524C4421')
   b'HELLO WORLD!'
   >>> base16_decode('')
   b''
   >>> base16_decode('486')
   Traceback (most recent call last):
     ...
   ValueError: Base16 encoded data is invalid:
   Data does not have an even number of hex digits.
   >>> base16_decode('48656c6c6f20576f726c6421')
   Traceback (most recent call last):
     ...
   ValueError: Base16 encoded data is invalid:
   Data is not uppercase hex or it contains invalid characters.
   >>> base16_decode('This is not base64 encoded data.')
   Traceback (most recent call last):
     ...
   ValueError: Base16 encoded data is invalid:
   Data is not uppercase hex or it contains invalid characters.


.. py:function:: base16_encode(data: bytes) -> str

   Encodes the given bytes into base16.

   >>> base16_encode(b'Hello World!')
   '48656C6C6F20576F726C6421'
   >>> base16_encode(b'HELLO WORLD!')
   '48454C4C4F20574F524C4421'
   >>> base16_encode(b'')
   ''