"""
This module provides convenience functions for saving and loading of odML files.
"""

import os
from .tools.odmlparser import ODMLReader, ODMLWriter


def load(filename, backend="xml", show_warnings=True):
    """
    Load an odML document from file.
    :param filename: Path and filename from where the odML document
                     is to be loaded and parsed.
    :param backend: File format of the file containing the odML document.
                    The default format is XML.
    :param show_warnings: Toggle whether to print warnings to the command line.
    :return: The parsed odML document.
    """
    if not os.path.exists(filename):
        msg = "File \'%s\' was not found!" % \
              (filename if len(filename) < 20 else "...%s" % filename[19:])
        raise FileNotFoundError(msg)

    reader = ODMLReader(backend, show_warnings)
    return reader.from_file(filename)


def save(obj, filename, backend="xml"):
    """
    Save an open odML document to file of a specified format.
    :param obj: odML document do be saved.
    :param filename: Filename and path where the odML document
                     should be saved.
    :param backend: Format in which the odML document is to be saved.
                    The default format is XML.
    """
    writer = ODMLWriter(backend)
    if "." not in filename.split(os.pathsep)[-1]:
        filename = filename + ".%s" % backend
    return writer.write_file(obj, filename)


def display(obj, backend="xml"):
    """
    Print an open odML document to the command line, formatted in the
    specified format.
    :param obj: odML document to be displayed.
    :param backend: Format in which the odML document is to be displayed.
                    The default format is XML.
    """
    writer = ODMLWriter(backend)
    print(writer.to_string(obj))