iro/controller/viewinterface.py
author Sandro Knauß <bugs@sandroknauss.de>
Tue, 15 Apr 2025 01:22:19 +0200
changeset 316 63c681b8e92c
parent 311 81916344c63b
permissions -rw-r--r--
fix link to about.
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
311
81916344c63b detailed status implemented
beowulf
parents: 309
diff changeset
    24
from ..model.job import exJobs
135
f8640c663e3e model.job created
Sandro Knauß <knauss@netzguerilla.net>
parents: 127
diff changeset
    25
from ..model.message import SMS, Fax, Mail
f8640c663e3e model.job created
Sandro Knauß <knauss@netzguerilla.net>
parents: 127
diff changeset
    26
136
ca926774e16c now using job.id - integer autoincrement
Sandro Knauß <knauss@netzguerilla.net>
parents: 135
diff changeset
    27
from ..validate import validate, vBool, vTel, vEmail, vInteger
115
323d06431100 restructering validate
Sandro Knauß <knauss@netzguerilla.net>
parents: 114
diff changeset
    28
135
f8640c663e3e model.job created
Sandro Knauß <knauss@netzguerilla.net>
parents: 127
diff changeset
    29
from .task import createJob
f8640c663e3e model.job created
Sandro Knauß <knauss@netzguerilla.net>
parents: 127
diff changeset
    30
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
    31
class Interface(object):
253
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
    32
    '''Interface for views.'''
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
    33
    
115
323d06431100 restructering validate
Sandro Knauß <knauss@netzguerilla.net>
parents: 114
diff changeset
    34
    @validate(kwd="detailed", func=vBool, need=False)
136
ca926774e16c now using job.id - integer autoincrement
Sandro Knauß <knauss@netzguerilla.net>
parents: 135
diff changeset
    35
    @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
    36
    @vUser
125
19b3f383c9ce getting job status form db
Sandro Knauß <knauss@netzguerilla.net>
parents: 121
diff changeset
    37
    @dbdefer
19b3f383c9ce getting job status form db
Sandro Knauß <knauss@netzguerilla.net>
parents: 121
diff changeset
    38
    def status(self, session, user, id=None, detailed=False):
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    39
        '''Returns the status of one or more jobs.
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
    40
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    41
        :param string user: apikey of a user
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    42
        :param integer id: one job id
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    43
        :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
    44
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
    45
        :return dict: 
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    46
           - `key` -- is the job id
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    47
           - [`key`][**'status'**] -- status of the job
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
    48
253
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
    49
        >>> status(APIKEY)
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
    50
        {"1":  {"status":"sended"},
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
    51
         "2":  {"status":"error"},
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
    52
         "10": {"status":"sending"}}
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
    53
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    54
        >>> status(APIKEY,10)
253
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
    55
        {"10": {"status":"sending"}}
311
81916344c63b detailed status implemented
beowulf
parents: 309
diff changeset
    56
81916344c63b detailed status implemented
beowulf
parents: 309
diff changeset
    57
        >>> status(APIKEY,10,True)
81916344c63b detailed status implemented
beowulf
parents: 309
diff changeset
    58
        {"10": {"status":"sending",
81916344c63b detailed status implemented
beowulf
parents: 309
diff changeset
    59
            "tasks": {"recipient1": "sended", "recipient2": "waiting" }}}
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
    60
        '''
125
19b3f383c9ce getting job status form db
Sandro Knauß <knauss@netzguerilla.net>
parents: 121
diff changeset
    61
        user = session.merge(user)
19b3f383c9ce getting job status form db
Sandro Knauß <knauss@netzguerilla.net>
parents: 121
diff changeset
    62
        ret={}
19b3f383c9ce getting job status form db
Sandro Knauß <knauss@netzguerilla.net>
parents: 121
diff changeset
    63
        if not id:
295
dc3cc61c7f6f small fixes and use iro as dbname for testing.
Sandro Knauß <knauss@netzguerilla.net>
parents: 294
diff changeset
    64
            for job in user.jobs:
136
ca926774e16c now using job.id - integer autoincrement
Sandro Knauß <knauss@netzguerilla.net>
parents: 135
diff changeset
    65
                ret[str(job.id)]={"status":job.status}
114
1ed072cc6793 reconstructing validate decorator
Sandro Knauß <knauss@netzguerilla.net>
parents: 109
diff changeset
    66
        else:
136
ca926774e16c now using job.id - integer autoincrement
Sandro Knauß <knauss@netzguerilla.net>
parents: 135
diff changeset
    67
            ret[str(id)]={"status":user.job(id).status}
311
81916344c63b detailed status implemented
beowulf
parents: 309
diff changeset
    68
81916344c63b detailed status implemented
beowulf
parents: 309
diff changeset
    69
            if detailed:
81916344c63b detailed status implemented
beowulf
parents: 309
diff changeset
    70
                def _status(task):
81916344c63b detailed status implemented
beowulf
parents: 309
diff changeset
    71
                    if task.error:
81916344c63b detailed status implemented
beowulf
parents: 309
diff changeset
    72
                        return "Error: " + task.status
81916344c63b detailed status implemented
beowulf
parents: 309
diff changeset
    73
                    elif task.status is None:
81916344c63b detailed status implemented
beowulf
parents: 309
diff changeset
    74
                        return "waiting"
81916344c63b detailed status implemented
beowulf
parents: 309
diff changeset
    75
                    else:
81916344c63b detailed status implemented
beowulf
parents: 309
diff changeset
    76
                        return "sended"
81916344c63b detailed status implemented
beowulf
parents: 309
diff changeset
    77
81916344c63b detailed status implemented
beowulf
parents: 309
diff changeset
    78
                ret[str(id)]["tasks"] = {task.recipient: _status(task) for task in exJobs[id].tasks.values()}
81916344c63b detailed status implemented
beowulf
parents: 309
diff changeset
    79
125
19b3f383c9ce getting job status form db
Sandro Knauß <knauss@netzguerilla.net>
parents: 121
diff changeset
    80
        return ret
200
01c34f22be42 deleting stop function from iro.controller.viewinterface
Sandro Knauß <knauss@netzguerilla.net>
parents: 199
diff changeset
    81
   
115
323d06431100 restructering validate
Sandro Knauß <knauss@netzguerilla.net>
parents: 114
diff changeset
    82
    @validate(kwd="recipients",func=vTel)
323d06431100 restructering validate
Sandro Knauß <knauss@netzguerilla.net>
parents: 114
diff changeset
    83
    @vUser
210
3763babd5e10 refactoring vRoute
Sandro Knauß <knauss@netzguerilla.net>
parents: 206
diff changeset
    84
    @validate(kwd="route", func=vRoute, typ="sms")
115
323d06431100 restructering validate
Sandro Knauß <knauss@netzguerilla.net>
parents: 114
diff changeset
    85
    def sms(self, user, message, recipients, route="default", info=""):
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    86
        '''Send a sms.
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
    87
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    88
        :param string user: apikey of a user
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    89
        :param string message: message
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    90
        :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
    91
        :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
    92
        :type route: string|list
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    93
        :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
    94
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
    95
        :return integer: the job id
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
    96
        '''
191
1816e97881ce test viewinterface.sms added
Sandro Knauß <knauss@netzguerilla.net>
parents: 136
diff changeset
    97
        d = createJob(user, recipients, SMS(message), route, info)
1816e97881ce test viewinterface.sms added
Sandro Knauß <knauss@netzguerilla.net>
parents: 136
diff changeset
    98
        def ret(job):
1816e97881ce test viewinterface.sms added
Sandro Knauß <knauss@netzguerilla.net>
parents: 136
diff changeset
    99
            return job.dbjob
1816e97881ce test viewinterface.sms added
Sandro Knauß <knauss@netzguerilla.net>
parents: 136
diff changeset
   100
        d.addCallback(ret)
1816e97881ce test viewinterface.sms added
Sandro Knauß <knauss@netzguerilla.net>
parents: 136
diff changeset
   101
        return d
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   102
   
115
323d06431100 restructering validate
Sandro Knauß <knauss@netzguerilla.net>
parents: 114
diff changeset
   103
    @validate(kwd="recipients",func=vTel)
323d06431100 restructering validate
Sandro Knauß <knauss@netzguerilla.net>
parents: 114
diff changeset
   104
    @vUser
210
3763babd5e10 refactoring vRoute
Sandro Knauß <knauss@netzguerilla.net>
parents: 206
diff changeset
   105
    @validate(kwd="route",func=vRoute, typ="fax")
115
323d06431100 restructering validate
Sandro Knauß <knauss@netzguerilla.net>
parents: 114
diff changeset
   106
    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
   107
        '''Send a fax.
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   108
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   109
        :param string user: apikey of a user
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   110
        :param string subject: subject
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   111
        :param string fax: content (base64 encoded)
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   112
        :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
   113
        :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
   114
        :type route: string|list
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   115
        :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
   116
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   117
        :return integer: the job id
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   118
        '''
198
85ede27b1add tests for controller.viewinterface.fax added
Sandro Knauß <knauss@netzguerilla.net>
parents: 192
diff changeset
   119
        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
   120
        def ret(job):
85ede27b1add tests for controller.viewinterface.fax added
Sandro Knauß <knauss@netzguerilla.net>
parents: 192
diff changeset
   121
            return job.dbjob
85ede27b1add tests for controller.viewinterface.fax added
Sandro Knauß <knauss@netzguerilla.net>
parents: 192
diff changeset
   122
        d.addCallback(ret)
85ede27b1add tests for controller.viewinterface.fax added
Sandro Knauß <knauss@netzguerilla.net>
parents: 192
diff changeset
   123
        return d
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   124
199
1bcca1a40769 test for nor explicit frm mailaddress
Sandro Knauß <knauss@netzguerilla.net>
parents: 198
diff changeset
   125
    @validate(kwd="recipients",func=vEmail, allowString=False)
1bcca1a40769 test for nor explicit frm mailaddress
Sandro Knauß <knauss@netzguerilla.net>
parents: 198
diff changeset
   126
    @validate(kwd="frm",func=vEmail, need=False, allowList=False)
115
323d06431100 restructering validate
Sandro Knauß <knauss@netzguerilla.net>
parents: 114
diff changeset
   127
    @vUser
210
3763babd5e10 refactoring vRoute
Sandro Knauß <knauss@netzguerilla.net>
parents: 206
diff changeset
   128
    @validate(kwd="route",func=vRoute, typ="mail")
192
6c708c334f37 test for controller.viewinterface.mail
Sandro Knauß <knauss@netzguerilla.net>
parents: 191
diff changeset
   129
    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
   130
        '''Send a mail.
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   131
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   132
        :param string user: apikey of a user
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   133
        :param string subject: subject
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   134
        :param string body: mail body
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   135
        :param list recipients:  a list of email addresses
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   136
        :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
   137
        :type route: string|list
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   138
        :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
   139
        :param string frm: sender mail address
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   140
        :return integer: the job id
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   141
        '''
192
6c708c334f37 test for controller.viewinterface.mail
Sandro Knauß <knauss@netzguerilla.net>
parents: 191
diff changeset
   142
        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
   143
        def ret(job):
6c708c334f37 test for controller.viewinterface.mail
Sandro Knauß <knauss@netzguerilla.net>
parents: 191
diff changeset
   144
            return job.dbjob
6c708c334f37 test for controller.viewinterface.mail
Sandro Knauß <knauss@netzguerilla.net>
parents: 191
diff changeset
   145
        d.addCallback(ret)
6c708c334f37 test for controller.viewinterface.mail
Sandro Knauß <knauss@netzguerilla.net>
parents: 191
diff changeset
   146
        return d
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   147
       
115
323d06431100 restructering validate
Sandro Knauß <knauss@netzguerilla.net>
parents: 114
diff changeset
   148
    @validate(kwd="typ", func=vTyp)
323d06431100 restructering validate
Sandro Knauß <knauss@netzguerilla.net>
parents: 114
diff changeset
   149
    @vUser
117
351a02310dd8 model restructuring
Sandro Knauß <knauss@netzguerilla.net>
parents: 115
diff changeset
   150
    @dbdefer
125
19b3f383c9ce getting job status form db
Sandro Knauß <knauss@netzguerilla.net>
parents: 121
diff changeset
   151
    def routes(self, session, user, typ):
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   152
        '''Returns a list of all possible offernames.
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   153
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   154
        :param string user: apikey of a user
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   155
        :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
   156
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   157
        :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
   158
        '''
121
ca63b6776231 putting routes logic to schema
Sandro Knauß <knauss@netzguerilla.net>
parents: 120
diff changeset
   159
        user = session.merge(user)
ca63b6776231 putting routes logic to schema
Sandro Knauß <knauss@netzguerilla.net>
parents: 120
diff changeset
   160
        offers = user.routes(typ)
119
3462c2c90f95 function routes complemented
Sandro Knauß <knauss@netzguerilla.net>
parents: 117
diff changeset
   161
        return [u[0] for u in offers]
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   162
        
115
323d06431100 restructering validate
Sandro Knauß <knauss@netzguerilla.net>
parents: 114
diff changeset
   163
    @validate(kwd="typ", func=vTyp)
323d06431100 restructering validate
Sandro Knauß <knauss@netzguerilla.net>
parents: 114
diff changeset
   164
    @vUser
117
351a02310dd8 model restructuring
Sandro Knauß <knauss@netzguerilla.net>
parents: 115
diff changeset
   165
    @dbdefer
125
19b3f383c9ce getting job status form db
Sandro Knauß <knauss@netzguerilla.net>
parents: 121
diff changeset
   166
    def defaultRoute(self, session, user, typ):
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   167
        '''Returns all default offernames.
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
275
88d45c846f2b docu fixes
Sandro Knauß <knauss@netzguerilla.net>
parents: 268
diff changeset
   170
        :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
   171
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   172
        :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
   173
        '''
121
ca63b6776231 putting routes logic to schema
Sandro Knauß <knauss@netzguerilla.net>
parents: 120
diff changeset
   174
        user = session.merge(user)
201
843a7bcecbc8 renameing Userright.isDefault(bool) -> default(int)
Sandro Knauß <knauss@netzguerilla.net>
parents: 200
diff changeset
   175
        offers = user.routes(typ, default=True)
120
7bde35ad89e0 function defaultRoute complemented
Sandro Knauß <knauss@netzguerilla.net>
parents: 119
diff changeset
   176
        return [u[0] for u in offers]
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   177
115
323d06431100 restructering validate
Sandro Knauß <knauss@netzguerilla.net>
parents: 114
diff changeset
   178
    @vUser
127
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   179
    @dbdefer
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   180
    def bill(self, session, user):
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   181
        '''Returns the bill, of not paid messages.
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   182
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   183
        :param string user: apikey of a user
253
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
   184
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
   185
        :return dict:
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   186
            - `route` -- one offer name ; **"total"** complete sum
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   187
            - [`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
   188
            - [`route`][`info`][**price**] -- Price for one billing group
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   189
            - [`route` | **total**][**anz**] -- Number of sended messages for one offer
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   190
            - [`route` | **total**][**price**] -- Price for one offer
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   191
253
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
   192
        >>> bill(APIKEY)
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
   193
        {"route1": {"info1":{"anz":1,"price":2.00},
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
   194
                    "info2":{"anz":2,"price":5.00},
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
   195
                    "anz":3,"price":7.00},
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
   196
        "route2":  {"info1":{"anz":3, "price":1.00},
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
   197
                    "info3":{"anz":4, "price":8.00},
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
   198
                    "anz":7, "price":9.00},
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
   199
        "total":   {"anz":10, "price":16.00}
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
   200
        }
e8d56537c9cc start documenting with reST syntax.
Sandro Knauß <knauss@netzguerilla.net>
parents: 250
diff changeset
   201
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   202
        '''
127
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   203
        ret={'total':{'price':0, 'anz':0}}
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   204
        user=session.merge(user)
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   205
        for route in user.rights:
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   206
            n=route.offer_name
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   207
            ret[n]={'price':0, 'anz':0, 'info':{}}
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   208
            for bill in route.bill:
309
7fa1d4713a4f fixe json output
hefee
parents: 295
diff changeset
   209
                ret[n][bill.info]={'price':float(bill.price),'anz':bill.anz}
127
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   210
                ret[n]['price'] += bill.price
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   211
                ret[n]['anz'] += bill.anz
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   212
            ret['total']['price'] += ret[n]['price'] 
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   213
            ret['total']['anz'] += ret[n]['anz'] 
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   214
            ret[n]['price'] = float(ret[n]['price'])
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   215
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   216
        ret['total']['price'] = float(ret['total']['price'])
79966b937274 made bill (aka statistic) function ready
Sandro Knauß <knauss@netzguerilla.net>
parents: 126
diff changeset
   217
        return ret
92
f479738b4879 umbau zu MVC
Sandro Knauß <knauss@netzguerilla.net>
parents:
diff changeset
   218
126
1ac2439a68b5 adding test function for email- and telefonnumbers.
Sandro Knauß <knauss@netzguerilla.net>
parents: 125
diff changeset
   219
    @validate(kwd="recipients",func=vTel)
1ac2439a68b5 adding test function for email- and telefonnumbers.
Sandro Knauß <knauss@netzguerilla.net>
parents: 125
diff changeset
   220
    def telnumber(self,recipients):
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   221
        '''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
   222
        
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   223
        :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
   224
275
88d45c846f2b docu fixes
Sandro Knauß <knauss@netzguerilla.net>
parents: 268
diff changeset
   225
        :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
   226
        '''
1ac2439a68b5 adding test function for email- and telefonnumbers.
Sandro Knauß <knauss@netzguerilla.net>
parents: 125
diff changeset
   227
        return True
1ac2439a68b5 adding test function for email- and telefonnumbers.
Sandro Knauß <knauss@netzguerilla.net>
parents: 125
diff changeset
   228
1ac2439a68b5 adding test function for email- and telefonnumbers.
Sandro Knauß <knauss@netzguerilla.net>
parents: 125
diff changeset
   229
    @validate(kwd="recipients",func=vEmail)
1ac2439a68b5 adding test function for email- and telefonnumbers.
Sandro Knauß <knauss@netzguerilla.net>
parents: 125
diff changeset
   230
    def email(self,recipients):
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   231
        '''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
   232
        
268
d0fcb1cde990 iro.controller.viewinterface: translating
Sandro Knauß <knauss@netzguerilla.net>
parents: 253
diff changeset
   233
        :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
   234
275
88d45c846f2b docu fixes
Sandro Knauß <knauss@netzguerilla.net>
parents: 268
diff changeset
   235
        :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
   236
        '''
1ac2439a68b5 adding test function for email- and telefonnumbers.
Sandro Knauß <knauss@netzguerilla.net>
parents: 125
diff changeset
   237
        return True