s4z / plumd

    """Return the file as a string - use on small files only.

    :param fname: Full pathname to a file.

    :type fname: str

    :rtype: dict

    """

    if os.access(fname, os.R_OK):

        with open(fname, 'r') as fd:

            return fd.read()

    return []

class Interval(object):

    """A simple helper class to ensure a loop occours every ltime seconds

    while optionally providing a means to interupt the loop with a

    :class:`threading.Event`.

    :param ltime: The target duration of a loop

    :type ltime: int or float

    :param evt: An event object that will cause the loop to complete early if

        the event is triggered while waiting.

    :type evt: threading.Event

    :raises: ValueError if the passed loop time is not an int or float or is < 0

    As an example, use it like this to loop on an interval:

    :Example:

        >>> import threading

        >>> evt = threading.Event()

        >>> while loop:

        >>>     with Interval(111.1, evt) as timer:

        >>>         do_things_here()

    :type col: int

    :param skip: Skip this many lines of the file.

    :type skip: int

    :rtype: dict

    """

    fdat = {}

    if os.access(fname, os.R_OK):

        with open(fname, 'r') as fd:

            dat = fd.read().split("\n")

            for line in dat[skip:]:

                vals = line.split()

                if len(vals) > col:

                    map_val = vals.pop(col)

                    fdat[map_val] = vals

    return fdat

def get_file_list(fname):

    """Return the file as a string - use on small files only.

    :param fname: Full pathname to a file.

    :type fname: str

    :rtype: dict

    """

    if os.access(fname, os.R_OK):

        with open(fname, 'r') as fd:

            return deque(fd.read().split("\n"))

    return []

def get_file(fname):

    """Return the file as a string - use on small files only.

    :param fname: Full pathname to a file.

    :type fname: str