# Licensed under a 3-clause BSD style license - see LICENSE.rst
"""
This package reads and writes data formats used by the Virtual
Observatory (VO) initiative, particularly the VOTable XML format.
"""

from astropy import config as _config

from .exceptions import (
    IOWarning,
    UnimplementedWarning,
    VOTableChangeWarning,
    VOTableSpecError,
    VOTableSpecWarning,
    VOWarning,
)
from .table import from_table, is_votable, parse, parse_single_table, validate, writeto

__all__ = [
    "Conf",
    "IOWarning",
    "UnimplementedWarning",
    "VOTableChangeWarning",
    "VOTableSpecError",
    "VOTableSpecWarning",
    "VOWarning",
    "conf",
    "from_table",
    "is_votable",
    "parse",
    "parse_single_table",
    "validate",
    "writeto",
]

VERIFY_OPTIONS = ["ignore", "warn", "exception"]  # First one is default


class Conf(_config.ConfigNamespace):
    """
    Configuration parameters for `astropy.io.votable`.
    """

    verify = _config.ConfigItem(
        VERIFY_OPTIONS,
        "Can be 'exception' (treat fixable violations of the VOTable spec as "
        "exceptions), 'warn' (show warnings for VOTable spec violations), or "
        "'ignore' (silently ignore VOTable spec violations)",
    )


conf = Conf()
