tiramisu/tiramisu/error.py

# -*- coding: utf-8 -*-
# Copyright (C) 2012-2017 Team tiramisu (see AUTHORS for all contributors)
#
# This program is free software: you can redistribute it and/or modify it
# under the terms of the GNU Lesser General Public License as published by the
# Free Software Foundation, either version 3 of the License, or (at your
# option) any later version.
#
# This program is distributed in the hope that it will be useful, but WITHOUT
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
# FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License for more
# details.
#
# You should have received a copy of the GNU Lesser General Public License
# along with this program.  If not, see <http://www.gnu.org/licenses/>.
# ____________________________________________________________
"user defined exceptions"
from .i18n import _
import sys


def display_list(lst, separator='and'):
    if separator == 'and':
        separator = _('and')
    elif separator == 'or':
        separator = _('or')
    if len(lst) == 0:
        return ''
    elif len(lst) == 1:
        ret = lst[0]
        if sys.version_info[0] < 3 and isinstance(ret, unicode):
            ret = ret.encode('utf8')
        if not isinstance(ret, str):
            ret = str(ret)
        return ret
    else:
        if isinstance(lst, tuple):
            lst = list(lst)
        lst.sort()
        lst_ = []
        for l in lst[:-1]:
            if sys.version_info[0] < 3 and isinstance(l, unicode):
                l = l.encode('utf8')
            elif not isinstance(l, str):
                l = str(l)
            lst_.append(l)
        last = lst[-1]
        if sys.version_info[0] < 3 and isinstance(last, unicode):
            last = last.encode('utf8')
        if not isinstance(last, str):
            last = str(last)
        return ', '.join(lst_) + _(' {} ').format(separator) + last


# Exceptions for an Option
class PropertiesOptionError(AttributeError):
    "attempt to access to an option with a property that is not allowed"
    def __init__(self, msg, proptype, settings=None, datas=None, option_type=None):
        self.proptype = proptype
        self._settings = settings
        self._datas = datas
        self._type = option_type
        self._orig_opt = None
        super(PropertiesOptionError, self).__init__(msg)

    def set_orig_opt(self, opt):
        self._orig_opt = opt

    def __str__(self):
        #this part is a bit slow, so only execute when display
        if self._settings is None:
            req = {}
        else:
            req = self._settings.apply_requires(**self._datas)
        if req != {} or self._orig_opt is not None:
            if req != {}:
                only_one = len(req) == 1
                msg = []
                for action, msg_ in req.items():
                    msg.append('{0} ({1})'.format(action, display_list(msg_)))
            else:
                only_one = len(self.proptype) == 1
                msg = self.proptype
            if only_one:
                prop_msg = _('property')
            else:
                prop_msg = _('properties')
            msg = display_list(msg)
            if self._orig_opt:
                return str(_('cannot access to {0} "{1}" because "{2}" has {3} {4}').format(self._type,
                                                                                      self._orig_opt.impl_get_display_name(),
                                                                                      self._datas['opt'].impl_get_display_name(),
                                                                                      prop_msg,
                                                                                      msg))
            else:
                return str(_('cannot access to {0} "{1}" because has {2} {3}').format(self._type, self._datas['opt'].impl_get_display_name(), prop_msg, msg))
        else:
            return super(PropertiesOptionError, self).__str__()


#____________________________________________________________
# Exceptions for a Config
class ConfigError(Exception):
    """attempt to change an option's owner without a value
    or in case of `_cfgimpl_descr` is None
    or if a calculation cannot be carried out"""
    pass


class ConflictError(Exception):
    "duplicate options are present in a single config"
    pass


#____________________________________________________________
# miscellaneous exceptions
class RequirementError(Exception):
    """a recursive loop occurs in the requirements tree
    requires
    """
    pass


class SlaveError(Exception):
    "problem with a slave's value length"
    pass


class ConstError(TypeError):
    "no uniq value in _NameSpace"
    pass


#Warning
class ValueWarning(UserWarning):  # pragma: optional cover
    """Option could warn user and not raise ValueError.

    Example:

    >>> import warnings
    >>> from tiramisu.error import ValueWarning
    >>> from tiramisu.option import StrOption, OptionDescription
    >>> from tiramisu.config import Config
    >>> warnings.simplefilter("always", ValueWarning)
    >>> def a(val):
    ...  raise ValueError('pouet')
    ...
    >>> s=StrOption('s', '', validator=a, warnings_only=True)
    >>> o=OptionDescription('o', '', [s])
    >>> c=Config(o)
    >>> c.s = 'val'
    StrOption:0: ValueWarning: invalid value val for option s: pouet
    >>> with warnings.catch_warnings(record=True) as w:
    ...     c.s = 'val'
    ...
    >>> w[0].message.opt == s
    True
    >>> print(str(w[0].message))
    invalid value val for option s: pouet
    """
    def __init__(self, msg, opt):
        self.opt = opt
        super(ValueWarning, self).__init__(msg)


class APIError(Exception):
    pass