"""
utilities for formatting the datastructures used in pyuca.

Useful mostly for debugging output.
"""
from __future__ import unicode_literals


def hexstrings2int(hexstrings):
    """
    list of hex strings to list of integers

    >>> hexstrings2int(["0000", "0001", "FFFF"])
    [0, 1, 65535]
    """
    return [int(hexstring, 16) for hexstring in hexstrings]


def int2hexstrings(number_list):
    """
    list of integers to list of 4-digit hex strings

    >>> int2hexstrings([0, 1, 65535])
    ['0000', '0001', 'FFFF']
    """
    return [str("{:04X}".format(n)) for n in number_list]


def format_collation_elements(collation_elements):
    """
    format collation element array (list of list of integer weights)

    >>> str(format_collation_elements([[1, 2, 3], [4, 5]]))
    '[0001.0002.0003], [0004.0005]'
    >>> format_collation_elements(None)
    """
    if collation_elements is None:
        return None
    else:
        return ", ".join(
            "[" + ".".join(
                int2hexstrings(collation_element)
            ) + "]" for collation_element in collation_elements
        )


def format_sort_key(sort_key):
    """
    format sort key (list of integers) with | level boundaries
    >>> str(format_sort_key([1, 0, 65535]))
    '0001 | FFFF'
    """
    return " ".join(
        ("{:04X}".format(x) if x else "|") for x in sort_key
    )