iro/controller/viewinterface.py
author Sandro Knauß <knauss@netzguerilla.net>
Fri, 24 Aug 2012 01:05:06 +0200
branchdevel
changeset 294 0e75bd39767d
parent 275 88d45c846f2b
child 295 dc3cc61c7f6f
permissions -rw-r--r--
adding LICENSE to all files
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
294
0e75bd39767d adding LICENSE to all files
Sandro Knauß <knauss@netzguerilla.net>
parents: 275
diff changeset
     1
# Copyright (c) 2012 netzguerilla.net <iro@netzguerilla.net>
0e75bd39767d adding LICENSE to all files
Sandro Knauß <knauss@netzguerilla.net>
parents: 275
diff changeset
     2
# 
0e75bd39767d adding LICENSE to all files
Sandro Knauß <knauss@netzguerilla.net>
parents: 275
diff changeset
     3
# This file is part of Iro.
0e75bd39767d adding LICENSE to all files
Sandro Knauß <knauss@netzguerilla.net>
parents: 275
diff changeset
     4
# 
0e75bd39767d adding LICENSE to all files
Sandro Knauß <knauss@netzguerilla.net>
parents: 275
diff changeset
     5
# Permission is hereby granted, free of charge, to any person obtaining a copy of
0e75bd39767d adding LICENSE to all files
Sandro Knauß <knauss@netzguerilla.net>
parents: 275
diff changeset
     6
# this software and associated documentation files (the "Software"), to deal in
0e75bd39767d adding LICENSE to all files
Sandro Knauß <knauss@netzguerilla.net>
parents: 275
diff changeset
     7
# the Software without restriction, including without limitation the rights to use,
0e75bd39767d adding LICENSE to all files
Sandro Knauß <knauss@netzguerilla.net>
parents: 275
diff changeset
     8
# copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the
0e75bd39767d adding LICENSE to all files
Sandro Knauß <knauss@netzguerilla.net>
parents: 275
diff changeset
     9
# #Software, and to permit persons to whom the Software is furnished to do so,
0e75bd39767d adding LICENSE to all files
Sandro Knauß <knauss@netzguerilla.net>
parents: 275
diff changeset
    10
# subject to the following conditions:
0e75bd39767d adding LICENSE to all files
Sandro Knauß <knauss@netzguerilla.net>
parents: 275
diff changeset
    11
# 
0e75bd39767d adding LICENSE to all files
Sandro Knauß <knauss@netzguerilla.net>
parents: 275
diff changeset
    12
# The above copyright notice and this permission notice shall be included in
0e75bd39767d adding LICENSE to all files
Sandro Knauß <knauss@netzguerilla.net>
parents: 275
diff changeset
    13
# all copies or substantial portions of the Software.
0e75bd39767d adding LICENSE to all files
Sandro Knauß <knauss@netzguerilla.net>
parents: 275
diff changeset
    14
# 
0e75bd39767d adding LICENSE to all files
Sandro Knauß <knauss@netzguerilla.net>
parents: 275
diff changeset
    15
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
0e75bd39767d adding LICENSE to all files
Sandro Knauß <knauss@netzguerilla.net>
parents: 275
diff changeset
    16
# INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
0e75bd39767d adding LICENSE to all files
Sandro Knauß <knauss@netzguerilla.net>
parents: 275
diff changeset
    17
# PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
0e75bd39767d adding LICENSE to all files
Sandro Knauß <knauss@netzguerilla.net>
parents: 275
diff changeset
    18
# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
0e75bd39767d adding LICENSE to all files
Sandro Knauß <knauss@netzguerilla.net>
parents: 275
diff changeset
    19
# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
0e75bd39767d adding LICENSE to all files
Sandro Knauß <knauss@netzguerilla.net>
parents: 275
diff changeset
    20
# SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
0e75bd39767d adding LICENSE to all files
Sandro Knauß <knauss@netzguerilla.net>
parents: 275
diff changeset
    21
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
    22
# -*- coding: utf-8 -*-
117
351a02310dd8 model restructuring
Sandro Knauß <knauss@netzguerilla.net>
parents: 115
diff changeset
    23
from ..model.decorators import vUser, vRoute, dbdefer, vTyp
135
f8640c663e3e model.job created
Sandro Knauß <knauss@netzguerilla.net>
parents: 127
diff changeset
    24
from ..model.message import SMS, Fax, Mail
f8640c663e3e model.job created
Sandro Knauß <knauss@netzguerilla.net>
parents: 127
diff changeset
    25
136
ca926774e16c now using job.id - integer autoincrement
Sandro Knauß <knauss@netzguerilla.net>
parents: 135
diff changeset
    26
from ..validate import validate, vBool, vTel, vEmail, vInteger
115
323d06431100 restructering validate
Sandro Knauß <knauss@netzguerilla.net>
parents: 114
diff changeset
    27
135
f8640c663e3e model.job created
Sandro Knauß <knauss@netzguerilla.net>
parents: 127
diff changeset
    28
from .task import createJob
f8640c663e3e model.job created
Sandro Knauß <knauss@netzguerilla.net>
parents: 127
diff changeset
    29
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
    30
class Interface(object):
253
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
    31
    '''Interface for views.'''
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
    32
    
115
323d06431100 restructering validate
Sandro Knauß <knauss@netzguerilla.net>
parents: 114
diff changeset
    33
    @validate(kwd="detailed", func=vBool, need=False)
136
ca926774e16c now using job.id - integer autoincrement
Sandro Knauß <knauss@netzguerilla.net>
parents: 135
diff changeset
    34
    @validate(kwd="id", func=vInteger, minv=0, need=False, none_allowed=True)
115
323d06431100 restructering validate
Sandro Knauß <knauss@netzguerilla.net>
parents: 114
diff changeset
    35
    @vUser
125
19b3f383c9ce getting job status form db
Sandro Knauß <knauss@netzguerilla.net>
parents: 121
diff changeset
    36
    @dbdefer
19b3f383c9ce getting job status form db
Sandro Knauß <knauss@netzguerilla.net>
parents: 121
diff changeset
    37
    def status(self, session, user, id=None, detailed=False):
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    38
        '''Returns the status of one or more jobs.
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
    39
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    40
        :param string user: apikey of a user
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    41
        :param integer id: one job id
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    42
        :param `boolean` detailed: return more details about the status
253
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
    43
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
    44
        :return dict: 
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    45
           - `key` -- is the job id
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    46
           - [`key`][**'status'**] -- status of the job
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
    47
253
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
    48
        .. warning:: detailed is not used yet.
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
    49
        
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
    50
        >>> status(APIKEY)
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
    51
        {"1":  {"status":"sended"},
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
    52
         "2":  {"status":"error"},
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
    53
         "10": {"status":"sending"}}
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
    54
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    55
        >>> status(APIKEY,10)
253
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
    56
        {"10": {"status":"sending"}}
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
    57
        '''
125
19b3f383c9ce getting job status form db
Sandro Knauß <knauss@netzguerilla.net>
parents: 121
diff changeset
    58
        user = session.merge(user)
19b3f383c9ce getting job status form db
Sandro Knauß <knauss@netzguerilla.net>
parents: 121
diff changeset
    59
        ret={}
19b3f383c9ce getting job status form db
Sandro Knauß <knauss@netzguerilla.net>
parents: 121
diff changeset
    60
        if not id:
19b3f383c9ce getting job status form db
Sandro Knauß <knauss@netzguerilla.net>
parents: 121
diff changeset
    61
            for job in  user.jobs:
136
ca926774e16c now using job.id - integer autoincrement
Sandro Knauß <knauss@netzguerilla.net>
parents: 135
diff changeset
    62
                ret[str(job.id)]={"status":job.status}
114
1ed072cc6793 reconstructing validate decorator
Sandro Knauß <knauss@netzguerilla.net>
parents: 109
diff changeset
    63
        else:
136
ca926774e16c now using job.id - integer autoincrement
Sandro Knauß <knauss@netzguerilla.net>
parents: 135
diff changeset
    64
            ret[str(id)]={"status":user.job(id).status}
ca926774e16c now using job.id - integer autoincrement
Sandro Knauß <knauss@netzguerilla.net>
parents: 135
diff changeset
    65
        
125
19b3f383c9ce getting job status form db
Sandro Knauß <knauss@netzguerilla.net>
parents: 121
diff changeset
    66
        return ret
200
01c34f22be42 deleting stop function from iro.controller.viewinterface
Sandro Knauß <knauss@netzguerilla.net>
parents: 199
diff changeset
    67
   
115
323d06431100 restructering validate
Sandro Knauß <knauss@netzguerilla.net>
parents: 114
diff changeset
    68
    @validate(kwd="recipients",func=vTel)
323d06431100 restructering validate
Sandro Knauß <knauss@netzguerilla.net>
parents: 114
diff changeset
    69
    @vUser
210
3763babd5e10 refactoring vRoute
Sandro Knauß <knauss@netzguerilla.net>
parents: 206
diff changeset
    70
    @validate(kwd="route", func=vRoute, typ="sms")
115
323d06431100 restructering validate
Sandro Knauß <knauss@netzguerilla.net>
parents: 114
diff changeset
    71
    def sms(self, user, message, recipients, route="default", info=""):
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    72
        '''Send a sms.
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
    73
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    74
        :param string user: apikey of a user
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    75
        :param string message: message
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    76
        :param list recipients:  a list of telefon numbers (use ITU-T E.123)
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    77
        :param route: route to use to send, or a list of routes as fallback
253
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
    78
        :type route: string|list
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    79
        :param string info: a name, to combine different jobs to one billing group
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
    80
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    81
        :return integer: the job id
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
    82
        '''
191
1816e97881ce test viewinterface.sms added
Sandro Knauß <knauss@netzguerilla.net>
parents: 136
diff changeset
    83
        d = createJob(user, recipients, SMS(message), route, info)
1816e97881ce test viewinterface.sms added
Sandro Knauß <knauss@netzguerilla.net>
parents: 136
diff changeset
    84
        def ret(job):
1816e97881ce test viewinterface.sms added
Sandro Knauß <knauss@netzguerilla.net>
parents: 136
diff changeset
    85
            return job.dbjob
1816e97881ce test viewinterface.sms added
Sandro Knauß <knauss@netzguerilla.net>
parents: 136
diff changeset
    86
        d.addCallback(ret)
1816e97881ce test viewinterface.sms added
Sandro Knauß <knauss@netzguerilla.net>
parents: 136
diff changeset
    87
        return d
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
    88
   
115
323d06431100 restructering validate
Sandro Knauß <knauss@netzguerilla.net>
parents: 114
diff changeset
    89
    @validate(kwd="recipients",func=vTel)
323d06431100 restructering validate
Sandro Knauß <knauss@netzguerilla.net>
parents: 114
diff changeset
    90
    @vUser
210
3763babd5e10 refactoring vRoute
Sandro Knauß <knauss@netzguerilla.net>
parents: 206
diff changeset
    91
    @validate(kwd="route",func=vRoute, typ="fax")
115
323d06431100 restructering validate
Sandro Knauß <knauss@netzguerilla.net>
parents: 114
diff changeset
    92
    def fax(self, user, subject, fax, recipients, route="default", info=""):
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    93
        '''Send a fax.
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
    94
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    95
        :param string user: apikey of a user
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    96
        :param string subject: subject
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    97
        :param string fax: content (base64 encoded)
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    98
        :param list recipients:  a list of telefon numbers (use ITU-T E.123)
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    99
        :param route: route to use to send, or a list of routes as fallback
253
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
   100
        :type route: string|list
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   101
        :param string info: a name, to combine different jobs to one billing group
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   102
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   103
        :return integer: the job id
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   104
        '''
198
85ede27b1add tests for controller.viewinterface.fax added
Sandro Knauß <knauss@netzguerilla.net>
parents: 192
diff changeset
   105
        d = createJob(user, recipients, Fax(subject, fax), route, info)
85ede27b1add tests for controller.viewinterface.fax added
Sandro Knauß <knauss@netzguerilla.net>
parents: 192
diff changeset
   106
        def ret(job):
85ede27b1add tests for controller.viewinterface.fax added
Sandro Knauß <knauss@netzguerilla.net>
parents: 192
diff changeset
   107
            return job.dbjob
85ede27b1add tests for controller.viewinterface.fax added
Sandro Knauß <knauss@netzguerilla.net>
parents: 192
diff changeset
   108
        d.addCallback(ret)
85ede27b1add tests for controller.viewinterface.fax added
Sandro Knauß <knauss@netzguerilla.net>
parents: 192
diff changeset
   109
        return d
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   110
199
1bcca1a40769 test for nor explicit frm mailaddress
Sandro Knauß <knauss@netzguerilla.net>
parents: 198
diff changeset
   111
    @validate(kwd="recipients",func=vEmail, allowString=False)
1bcca1a40769 test for nor explicit frm mailaddress
Sandro Knauß <knauss@netzguerilla.net>
parents: 198
diff changeset
   112
    @validate(kwd="frm",func=vEmail, need=False, allowList=False)
115
323d06431100 restructering validate
Sandro Knauß <knauss@netzguerilla.net>
parents: 114
diff changeset
   113
    @vUser
210
3763babd5e10 refactoring vRoute
Sandro Knauß <knauss@netzguerilla.net>
parents: 206
diff changeset
   114
    @validate(kwd="route",func=vRoute, typ="mail")
192
6c708c334f37 test for controller.viewinterface.mail
Sandro Knauß <knauss@netzguerilla.net>
parents: 191
diff changeset
   115
    def mail(self, user, subject, body, recipients, frm=None, route="default", info=""):
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   116
        '''Send a mail.
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   117
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   118
        :param string user: apikey of a user
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   119
        :param string subject: subject
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   120
        :param string body: mail body
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   121
        :param list recipients:  a list of email addresses
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   122
        :param route: route to use to send, or a list of routes as fallback
253
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
   123
        :type route: string|list
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   124
        :param string info: a name, to combine different jobs to one billing group
275
88d45c846f2b docu fixes
Sandro Knauß <knauss@netzguerilla.net>
parents: 268
diff changeset
   125
        :param string frm: sender mail address
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   126
        :return integer: the job id
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   127
        '''
192
6c708c334f37 test for controller.viewinterface.mail
Sandro Knauß <knauss@netzguerilla.net>
parents: 191
diff changeset
   128
        d = createJob(user, recipients, Mail(subject, body, frm), route, info)
6c708c334f37 test for controller.viewinterface.mail
Sandro Knauß <knauss@netzguerilla.net>
parents: 191
diff changeset
   129
        def ret(job):
6c708c334f37 test for controller.viewinterface.mail
Sandro Knauß <knauss@netzguerilla.net>
parents: 191
diff changeset
   130
            return job.dbjob
6c708c334f37 test for controller.viewinterface.mail
Sandro Knauß <knauss@netzguerilla.net>
parents: 191
diff changeset
   131
        d.addCallback(ret)
6c708c334f37 test for controller.viewinterface.mail
Sandro Knauß <knauss@netzguerilla.net>
parents: 191
diff changeset
   132
        return d
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   133
       
115
323d06431100 restructering validate
Sandro Knauß <knauss@netzguerilla.net>
parents: 114
diff changeset
   134
    @validate(kwd="typ", func=vTyp)
323d06431100 restructering validate
Sandro Knauß <knauss@netzguerilla.net>
parents: 114
diff changeset
   135
    @vUser
117
351a02310dd8 model restructuring
Sandro Knauß <knauss@netzguerilla.net>
parents: 115
diff changeset
   136
    @dbdefer
125
19b3f383c9ce getting job status form db
Sandro Knauß <knauss@netzguerilla.net>
parents: 121
diff changeset
   137
    def routes(self, session, user, typ):
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   138
        '''Returns a list of all possible offernames.
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   139
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   140
        :param string user: apikey of a user
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   141
        :param string typ: a typ of message -- one of in this list ["sms","fax","mail"]
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   142
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   143
        :return list: a list of all possible offer names for a typ
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   144
        '''
121
ca63b6776231 putting routes logic to schema
Sandro Knauß <knauss@netzguerilla.net>
parents: 120
diff changeset
   145
        user = session.merge(user)
ca63b6776231 putting routes logic to schema
Sandro Knauß <knauss@netzguerilla.net>
parents: 120
diff changeset
   146
        offers = user.routes(typ)
119
3462c2c90f95 function routes complemented
Sandro Knauß <knauss@netzguerilla.net>
parents: 117
diff changeset
   147
        return [u[0] for u in offers]
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   148
        
115
323d06431100 restructering validate
Sandro Knauß <knauss@netzguerilla.net>
parents: 114
diff changeset
   149
    @validate(kwd="typ", func=vTyp)
323d06431100 restructering validate
Sandro Knauß <knauss@netzguerilla.net>
parents: 114
diff changeset
   150
    @vUser
117
351a02310dd8 model restructuring
Sandro Knauß <knauss@netzguerilla.net>
parents: 115
diff changeset
   151
    @dbdefer
125
19b3f383c9ce getting job status form db
Sandro Knauß <knauss@netzguerilla.net>
parents: 121
diff changeset
   152
    def defaultRoute(self, session, user, typ):
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   153
        '''Returns all default offernames.
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   154
 
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   155
        :param string user: apikey of a user
275
88d45c846f2b docu fixes
Sandro Knauß <knauss@netzguerilla.net>
parents: 268
diff changeset
   156
        :param string typ: a typ of message -- one of in this list ["sms","fax","mail"]
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   157
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   158
        :return list: a list of all possible offer names for a typ
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   159
        '''
121
ca63b6776231 putting routes logic to schema
Sandro Knauß <knauss@netzguerilla.net>
parents: 120
diff changeset
   160
        user = session.merge(user)
201
843a7bcecbc8 renameing Userright.isDefault(bool) -> default(int)
Sandro Knauß <knauss@netzguerilla.net>
parents: 200
diff changeset
   161
        offers = user.routes(typ, default=True)
120
7bde35ad89e0 function defaultRoute complemented
Sandro Knauß <knauss@netzguerilla.net>
parents: 119
diff changeset
   162
        return [u[0] for u in offers]
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   163
115
323d06431100 restructering validate
Sandro Knauß <knauss@netzguerilla.net>
parents: 114
diff changeset
   164
    @vUser
127
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   165
    @dbdefer
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   166
    def bill(self, session, user):
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   167
        '''Returns the bill, of not paid messages.
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   168
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   169
        :param string user: apikey of a user
253
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
   170
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
   171
        :return dict:
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   172
            - `route` -- one offer name ; **"total"** complete sum
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   173
            - [`route`][`info`][**anz**] -- Number of sended messages in one billing group
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   174
            - [`route`][`info`][**price**] -- Price for one billing group
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   175
            - [`route` | **total**][**anz**] -- Number of sended messages for one offer
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   176
            - [`route` | **total**][**price**] -- Price for one offer
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   177
253
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
   178
        >>> bill(APIKEY)
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
   179
        {"route1": {"info1":{"anz":1,"price":2.00},
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
   180
                    "info2":{"anz":2,"price":5.00},
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
   181
                    "anz":3,"price":7.00},
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
   182
        "route2":  {"info1":{"anz":3, "price":1.00},
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
   183
                    "info3":{"anz":4, "price":8.00},
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
   184
                    "anz":7, "price":9.00},
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
   185
        "total":   {"anz":10, "price":16.00}
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
   186
        }
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
   187
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   188
        '''
127
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   189
        ret={'total':{'price':0, 'anz':0}}
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   190
        user=session.merge(user)
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   191
        for route in user.rights:
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   192
            n=route.offer_name
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   193
            ret[n]={'price':0, 'anz':0, 'info':{}}
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   194
            for bill in route.bill:
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   195
                ret[n]['info'][bill.info]={'price':float(bill.price),'anz':bill.anz}
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   196
                ret[n]['price'] += bill.price
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   197
                ret[n]['anz'] += bill.anz
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   198
            ret['total']['price'] += ret[n]['price'] 
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   199
            ret['total']['anz'] += ret[n]['anz'] 
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   200
            ret[n]['price'] = float(ret[n]['price'])
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   201
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   202
        ret['total']['price'] = float(ret['total']['price'])
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   203
        return ret
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   204
126
1ac2439a68b5 adding test function for email- and telefonnumbers.
Sandro Knauß <knauss@netzguerilla.net>
parents: 125
diff changeset
   205
    @validate(kwd="recipients",func=vTel)
1ac2439a68b5 adding test function for email- and telefonnumbers.
Sandro Knauß <knauss@netzguerilla.net>
parents: 125
diff changeset
   206
    def telnumber(self,recipients):
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   207
        '''Return True, if all telnumbers a vaild.
126
1ac2439a68b5 adding test function for email- and telefonnumbers.
Sandro Knauß <knauss@netzguerilla.net>
parents: 125
diff changeset
   208
        
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   209
        :param list recipients:  a list of telnumbers (use ITU-T E.123)
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   210
275
88d45c846f2b docu fixes
Sandro Knauß <knauss@netzguerilla.net>
parents: 268
diff changeset
   211
        :return boolean: True -- all numbers are valid
126
1ac2439a68b5 adding test function for email- and telefonnumbers.
Sandro Knauß <knauss@netzguerilla.net>
parents: 125
diff changeset
   212
        '''
1ac2439a68b5 adding test function for email- and telefonnumbers.
Sandro Knauß <knauss@netzguerilla.net>
parents: 125
diff changeset
   213
        return True
1ac2439a68b5 adding test function for email- and telefonnumbers.
Sandro Knauß <knauss@netzguerilla.net>
parents: 125
diff changeset
   214
1ac2439a68b5 adding test function for email- and telefonnumbers.
Sandro Knauß <knauss@netzguerilla.net>
parents: 125
diff changeset
   215
    @validate(kwd="recipients",func=vEmail)
1ac2439a68b5 adding test function for email- and telefonnumbers.
Sandro Knauß <knauss@netzguerilla.net>
parents: 125
diff changeset
   216
    def email(self,recipients):
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   217
        '''Return True, if all mailadresses a valid.
126
1ac2439a68b5 adding test function for email- and telefonnumbers.
Sandro Knauß <knauss@netzguerilla.net>
parents: 125
diff changeset
   218
        
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   219
        :param list recipients:  a list of mailadresses
126
1ac2439a68b5 adding test function for email- and telefonnumbers.
Sandro Knauß <knauss@netzguerilla.net>
parents: 125
diff changeset
   220
275
88d45c846f2b docu fixes
Sandro Knauß <knauss@netzguerilla.net>
parents: 268
diff changeset
   221
        :return boolean: True -- all addresses are valid
126
1ac2439a68b5 adding test function for email- and telefonnumbers.
Sandro Knauß <knauss@netzguerilla.net>
parents: 125
diff changeset
   222
        '''
1ac2439a68b5 adding test function for email- and telefonnumbers.
Sandro Knauß <knauss@netzguerilla.net>
parents: 125
diff changeset
   223
        return True