import yaml


def read_yaml(filename: str) -> dict:
    """
    Read a YAML file and return the contents.

    Parameters
    ----------
    filename : string
        A ``string`` of the full file path to read.

    Returns
    -------
    dict
        Returns a ``dict`` representing the entire contents of the file.
    """
    with open(filename, 'r') as handler:
        return yaml.safe_load(handler)