# -*- coding: utf-8 -*-

class InterfaceException(Exception):

    """Exception, that should be reported to external client

    999 -- unknown error

    """

    def __init__(self, code=999, msg="Unknown error."):

        """

        :param integer code: the error code

        :param string msg: the error message

        """

        self.code=code

        self.msg=msg

    def dict(self):

        """dict representation of the error"""

        return {"code":self.code,

                "msg":self.msg,

                }

    def __str__(self):

        return "%i: %s"%(self.code,self.msg)

class UserNotFound(InterfaceException):

    """ 901 -- apikey is unknown -- user not found""" 

    def __init__(self):

        InterfaceException.__init__(self, 901, "Apikey is unknown.")

class JobNotFound(InterfaceException):

    """902 -- jobid is unknown"""

    def __init__(self):

        InterfaceException.__init__(self, 902, "Jobid is unknown.")

class ExternalException(InterfaceException):

    """950 -- error in external api"""

    def __init__(self):

        InterfaceException.__init__(self, 950, "Error in external API.")

class ValidateException(Exception):

    """700 -- validation failed."""

    def __init__(self, code=700, field=None, msg=None):

        """

        :param integer code: the error code

        :param string field: the field, that is not valid 

        :param string msg: the error message

        """

        self.code=code

        self.field=field

        self.msg = msg

        if not msg:

            self.msg='Validation failed.'

        if field and not msg:

            self.msg="Validation of '%s' failed."%field

    def dict(self):

        """dict representation of the error"""

        return {"code":self.code,

                "msg":self.msg,

                "field":self.field,

                }

    def __str__(self):

        return "%i: %s"%(self.code,self.msg)

class InvalidTel(ValidateException):

    """701 -- invalid telnumber"""

    def __init__(self, number,field=None):

        self.number = number

        msg = "No valid telnumber: '%s'"%(number)

        ValidateException.__init__(self, 701, field, msg)

class InvalidMail(ValidateException):

    """702 -- invalid mailaddress"""

    def __init__(self, number,field=None):

        self.number = number

        msg = "No valid email: '%s'"%(number)

        ValidateException.__init__(self, 702, field, msg)

class OfferException(Exception):

    """an Exception in Offer handling"""

    def __init__(self, name):

        self.name = name

class NoRoute(OfferException):

    """no valid route found"""

    def __str__(self):

        return "Not a valid route: %s"%self.name

class NoProvider(OfferException):

    """no provider found"""

    def __str__(self):

        return "Not a valid provider: %s"%self.name

class NoTyp(OfferException):

    """no typ found."""

    def __str__(self):

        return "Not a valid Typ: %s"%self.name

class RejectRecipient(Exception):

    """can't handle the recipient in a route"""

    def __init__(self,recipient, status=None):

        self.recipient = recipient

        self.status = status

    def __str__(self):

        return "Reject recipient(%s): %s"%(str(self.recipient),str(self.status))

class ConfigException(Exception):

    """Exception while loading configuration."""

    def __init__(self,section, name):

        self.section = section

        self.name = name

class UnknownOption(ConfigException):

    """Option is unknown"""

    def __str__(self):

        return "Unknown option '%s' in section '%s'."%(self.name, self.section)

class NeededOption(ConfigException):

    """Option is missing, but needed."""

    def __str__(self):

        return "Option '%s' in section '%s' is missing."%(self.name, self.section)

class NoRouteForTask(Exception):

    """Can't send message to recipient with given offers"""

    pass