Promote an item in a list to the first position

promote_item_to_first_position.py

def promote_item_to_first_position(enumerator, key, value):
    """
    Promotes an item to the first index of the list if it isn't already there. It moves the item from it's current
    position and resets the list's indexes. Be careful to not use this on a giant list, because the operation could
    be quite heavy. With small lists the impact is not noticeable.
    :param enumerator:
    :param key:
    :param value:
    :return:
    """
    for idx, item in enumerate(enumerator):
        if item[key] == value:
            if idx != 0:
                del enumerator[idx]
                enumerator.insert(0, item)
            break

    return enumerator