:mod:`ubinascii` -- binary/ASCII conversions
============================================

.. module:: ubinascii
   :synopsis: binary/ASCII conversions

This module implements conversions between binary data and various
encodings of it in ASCII form (in both directions).

Functions
---------

.. function:: hexlify(data, [sep])

   Convert binary data to hexadecimal representation. Returns bytes string.

   .. admonition:: Difference to CPython
      :class: attention

      If additional argument, `sep` is supplied, it is used as a separator
      between hexadecimal values.

.. function:: unhexlify(data)

   Convert hexadecimal data to binary representation. Returns bytes string.
   (i.e. inverse of hexlify)

.. function:: a2b_base64(data)

   Convert Base64-encoded data to binary representation. Returns bytes string.

.. function:: b2a_base64(data)

   Encode binary data in Base64 format. Returns string.

.. function:: crc32(data[, value])

Compute CRC-32, the 32-bit checksum of data, starting with an initial CRC of value. 
The default initial CRC is zero. The algorithm is consistent with the ZIP file checksum. 
Since the algorithm is designed for use as a checksum algorithm, it is not suitable 
for use as a general hash algorithm. Use as follows::

   import ubinascii
   print(ubinascii.crc32(b"hello world"))
   
   # Or, in two pieces:
   
   crc = ubinascii.crc32(b"hello")
   crc = ubinascii.crc32(b" world", crc)
   print('crc32 = {:#010x}'.format(crc))