def read(input_file):
    """
    General read in of all possible data from a Quantum Espresso output file.

    **Parameters**

        input_file: *str*
            Quantum Espresso output file to be parsed.

    **Returns**

        data: :class:`results.DFT_out`
            Generic DFT output object containing all parsed results.

    """
    raise Exception('THIS HAS NOT BEEN WRITTEN YET!')
