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

from ..model.decorators import vUser, vRoute, dbdefer, vTyp

from ..validate import validate, vBool, vHash, vTel, vEmail

class Interface(object):

    '''class for a xmlrpc user

    '''

    @validate(kwd="detailed", func=vBool, need=False)

    @validate(kwd="id", func=vHash, need=False, maxlength=40)

    @vUser

        '''Gibt den aktuellen Status eines Auftrages oder Mehreren zurück.

        Keywords:

        apikey[string]: Der API Key

        id[hash]: Eine Auftragsnummer

        detailed[boolean]: Details ausgeben

        Return:

        jobs[list]: Eine Liste der Aufträge.

        job.name[string]: Angebener Name

        job.status[string]: Status des Auftrages

        '''

        else:

    @vUser

    @validate(kwd="id", func=vHash,maxlength=40)

    def stop(self, user, id):

        '''Stoppt den angegeben Auftrag.

        Keywords:

        apikey[string]: Der API Key

        id[hash]: Eine Auftragsnummer

        Return:

        '''

        return ""

    @validate(kwd="recipients",func=vTel)

    @vUser

    @vRoute(typ="sms")

    def sms(self, user, message, recipients, route="default", info=""):

        '''Versendet eine SMS.

        Keywords:

        apikey[string]: Der API Key

        message[string]: Nachricht

        recipients[list]: eine Liste von Emfänger-Nummern (gemäß ITU-T E.123)

        route[string|list]: Route über den geschickt werden soll, 

                            oder eine Liste von Routen, um Fallbacks anzugeben

        Return:

        id[hash]: Die ID des Auftrages

        '''

        return ""

    @validate(kwd="recipients",func=vTel)

    @vUser

    @vRoute(typ="fax")

    def fax(self, user, subject, fax, recipients, route="default", info=""):

        '''Versendet ein FAX.

        Keywords:

        apikey[string]: Der API Key

        subject[string]: Der Betreff

        fax[string]: Das PDF base64 kodiert

        recipients[list]: Eine Liste von Emfänger-Nummern (gemäß ITU-T E.123)

        route[string|list]: Route über den geschickt werden soll, 

                            oder eine Liste von Routen, um Fallbacks anzugeben

        Return:

        id[hash]: Die ID des Auftrages

        '''

        return ""

    @validate(kwd="recipients",func=vEmail)

    @vUser

    @vRoute(typ="mail")

    def mail(self, user, subject,  body, recipients, frm, route="default", info=""):

        '''Versendet eine Email.

        Keywords:

        apikey[string]: Der API Key

        subject[string]: Der Betreff

        body[string]: Der Email Body

        recipients[list]: Eine Liste von Emailadressen

        frm[string]: Die Absender Emailadresse

        route[string|list]: Route über den geschickt werden soll, 

                            oder eine Liste von Routen, um Fallbacks anzugeben

        Return:

        id[hash]: Die ID des Auftrages

        '''

        return ""

    @validate(kwd="typ", func=vTyp)

    @vUser

    @dbdefer

        '''Gibt eine Liste aller verfügbaren Provider zurück.

        Keywords:

        apikey[string]: Der API Key

        typ[string]: Der Typ zu dem die Providerloste ausgeben werden soll

                     Einer der Liste ["sms","fax","mail"]

        Return:

        providerlist[list]: Eine Liste aller möglichen Provider

        '''

        user = session.merge(user)

        offers = user.routes(typ)

        return [u[0] for u in offers]

    @validate(kwd="typ", func=vTyp)

    @vUser

    @dbdefer

        '''Gibt den Standardprovider zurück.

        Keywords:

        apikey[string]: Der API Key

        typ[string]: Der Typ zu dem die Providerliste ausgeben werden soll

                     Einer der Liste ["sms","fax","mail"]

        Return:

        provider[string]: Der Standardprovider für den angeben Typ

        '''

        user = session.merge(user)

        offers = user.routes(typ, isDefault=True)

        return [u[0] for u in offers]

    @vUser

    def statistic(self, user):

        '''Gibt eine Statik zurück über die versendendeten Nachrichten und des Preises.

        Keywords:

        apikey[string]: Der API Key

        Return:

        statistic[list]: Eine Liste nach Nachrichtentypen

        '''

        return ""