author | Pierre-Yves David <pierre-yves.david@logilab.fr> |
Tue, 08 Dec 2009 12:46:45 +0100 | |
changeset 4040 | 00e2f1ae625d |
parent 4007 | 91d11fda4aa0 |
child 4045 | f4a52abb6f4f |
permissions | -rw-r--r-- |
0 | 1 |
"""The edit controller, handling form submitting. |
2 |
||
3 |
:organization: Logilab |
|
1977
606923dff11b
big bunch of copyright / docstring update
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
1948
diff
changeset
|
4 |
:copyright: 2001-2009 LOGILAB S.A. (Paris, FRANCE), license is LGPL v2. |
0 | 5 |
:contact: http://www.logilab.fr/ -- mailto:contact@logilab.fr |
1977
606923dff11b
big bunch of copyright / docstring update
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
1948
diff
changeset
|
6 |
:license: GNU Lesser General Public License, v2.1 - http://www.gnu.org/licenses |
0 | 7 |
""" |
8 |
__docformat__ = "restructuredtext en" |
|
1948 | 9 |
|
0 | 10 |
from decimal import Decimal |
11 |
||
12 |
from rql.utils import rqlvar_maker |
|
13 |
||
14 |
from cubicweb import Binary, ValidationError, typed_eid |
|
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
15 |
from cubicweb.web import INTERNAL_FIELD_VALUE, RequestError, NothingToEdit, ProcessFormError |
0 | 16 |
from cubicweb.web.controller import parse_relations_descr |
17 |
from cubicweb.web.views.basecontrollers import ViewController |
|
18 |
||
19 |
||
20 |
class ToDoLater(Exception): |
|
21 |
"""exception used in the edit controller to indicate that a relation |
|
22 |
can't be handled right now and have to be handled later |
|
23 |
""" |
|
24 |
||
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
25 |
class RqlQuery(object): |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
26 |
def __init__(self): |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
27 |
self.edited = [] |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
28 |
self.restrictions = [] |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
29 |
self.kwargs = {} |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
30 |
|
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
31 |
def insert_query(self, etype): |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
32 |
if self.edited: |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
33 |
rql = 'INSERT %s X: %s' % (etype, ','.join(self.edited)) |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
34 |
else: |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
35 |
rql = 'INSERT %s X' % etype |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
36 |
if self.restrictions: |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
37 |
rql += ' WHERE %s' % ','.join(self.restrictions) |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
38 |
return rql |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
39 |
|
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
40 |
def update_query(self, eid): |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
41 |
varmaker = rqlvar_maker() |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
42 |
var = varmaker.next() |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
43 |
while var in self.kwargs: |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
44 |
var = varmaker.next() |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
45 |
rql = 'SET %s WHERE X eid %%(%s)s' % (','.join(self.edited), var) |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
46 |
if self.restrictions: |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
47 |
rql += ', %s' % ','.join(self.restrictions) |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
48 |
self.kwargs[var] = eid |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
49 |
return rql |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
50 |
|
0 | 51 |
class EditController(ViewController): |
3377
dd9d292b6a6d
use __regid__ instead of id on appobject classes
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
3369
diff
changeset
|
52 |
__regid__ = 'edit' |
0 | 53 |
|
2255
c346af0727ca
more generic way to detect json requests (not yet perfect though)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
1977
diff
changeset
|
54 |
def publish(self, rset=None): |
0 | 55 |
"""edit / create / copy / delete entity / relations""" |
3451
6b46d73823f5
[api] work in progress, use __regid__, cw_*, etc.
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3396
diff
changeset
|
56 |
for key in self._cw.form: |
0 | 57 |
# There should be 0 or 1 action |
58 |
if key.startswith('__action_'): |
|
59 |
cbname = key[1:] |
|
60 |
try: |
|
61 |
callback = getattr(self, cbname) |
|
62 |
except AttributeError: |
|
3451
6b46d73823f5
[api] work in progress, use __regid__, cw_*, etc.
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3396
diff
changeset
|
63 |
raise RequestError(self._cw._('invalid action %r' % key)) |
0 | 64 |
else: |
65 |
return callback() |
|
66 |
self._default_publish() |
|
67 |
self.reset() |
|
68 |
||
69 |
def _default_publish(self): |
|
3451
6b46d73823f5
[api] work in progress, use __regid__, cw_*, etc.
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3396
diff
changeset
|
70 |
req = self._cw |
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
71 |
self.errors = [] |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
72 |
self.relations_rql = [] |
4007
91d11fda4aa0
more api renaming/fixing update
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
3998
diff
changeset
|
73 |
form = req.form |
3921
4f24b6ef3da9
edit controller now informs server side about its main eid through transaction data
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
3689
diff
changeset
|
74 |
# so we're able to know the main entity from the repository side |
4f24b6ef3da9
edit controller now informs server side about its main eid through transaction data
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
3689
diff
changeset
|
75 |
if '__maineid' in form: |
3924
4347654979e8
don't type __maineid, it may not be an eid actually
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
3921
diff
changeset
|
76 |
req.set_shared_data('__maineid', form['__maineid'], querydata=True) |
0 | 77 |
# no specific action, generic edition |
78 |
self._to_create = req.data['eidmap'] = {} |
|
79 |
self._pending_relations = [] |
|
3451
6b46d73823f5
[api] work in progress, use __regid__, cw_*, etc.
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3396
diff
changeset
|
80 |
todelete = self._cw.get_pending_deletes() |
6b46d73823f5
[api] work in progress, use __regid__, cw_*, etc.
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3396
diff
changeset
|
81 |
toinsert = self._cw.get_pending_inserts() |
0 | 82 |
try: |
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
83 |
methodname = req.form.pop('__method', None) |
0 | 84 |
for eid in req.edited_eids(): |
3309
2538daa6651c
we may have some entity forms with nothing to edit for an entity, no RequestError in that case
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
3194
diff
changeset
|
85 |
# __type and eid |
2538daa6651c
we may have some entity forms with nothing to edit for an entity, no RequestError in that case
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
3194
diff
changeset
|
86 |
formparams = req.extract_entity_params(eid, minparams=2) |
0 | 87 |
if methodname is not None: |
2680
66472d85d548
[R] use req.entity_from_eid
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2650
diff
changeset
|
88 |
entity = req.entity_from_eid(eid) |
0 | 89 |
method = getattr(entity, methodname) |
90 |
method(formparams) |
|
91 |
eid = self.edit_entity(formparams) |
|
92 |
except (RequestError, NothingToEdit): |
|
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
93 |
if '__linkto' in req.form and 'eid' in req.form: |
0 | 94 |
self.execute_linkto() |
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
95 |
elif not ('__delete' in req.form or '__insert' in req.form or todelete or toinsert): |
0 | 96 |
raise ValidationError(None, {None: req._('nothing to edit')}) |
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
97 |
for querydef in self.relations_rql: |
3451
6b46d73823f5
[api] work in progress, use __regid__, cw_*, etc.
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3396
diff
changeset
|
98 |
self._cw.execute(*querydef) |
0 | 99 |
# handle relations in newly created entities |
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
100 |
# XXX find a way to merge _pending_relations and relations_rql |
0 | 101 |
if self._pending_relations: |
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
102 |
for form, field, entity in self._pending_relations: |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
103 |
for querydef in self.handle_relation(form, field, entity, True): |
3451
6b46d73823f5
[api] work in progress, use __regid__, cw_*, etc.
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3396
diff
changeset
|
104 |
self._cw.execute(*querydef) |
0 | 105 |
# XXX this processes *all* pending operations of *all* entities |
3384
f76a38731bc1
[forms] work-in-progress: get rid of edits- / edito-
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
2680
diff
changeset
|
106 |
if req.form.has_key('__delete'): |
f76a38731bc1
[forms] work-in-progress: get rid of edits- / edito-
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
2680
diff
changeset
|
107 |
todelete += req.list_form_param('__delete', req.form, pop=True) |
0 | 108 |
if todelete: |
109 |
self.delete_relations(parse_relations_descr(todelete)) |
|
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
110 |
if req.form.has_key('__insert'): |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
111 |
toinsert = req.list_form_param('__insert', req.form, pop=True) |
0 | 112 |
if toinsert: |
113 |
self.insert_relations(parse_relations_descr(toinsert)) |
|
3451
6b46d73823f5
[api] work in progress, use __regid__, cw_*, etc.
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3396
diff
changeset
|
114 |
self._cw.remove_pending_operations() |
1753 | 115 |
|
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
116 |
def _insert_entity(self, etype, eid, rqlquery): |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
117 |
rql = rqlquery.insert_query(etype) |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
118 |
try: |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
119 |
# get the new entity (in some cases, the type might have |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
120 |
# changed as for the File --> Image mutation) |
3451
6b46d73823f5
[api] work in progress, use __regid__, cw_*, etc.
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3396
diff
changeset
|
121 |
entity = self._cw.execute(rql, rqlquery.kwargs).get_entity(0, 0) |
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
122 |
neweid = entity.eid |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
123 |
except ValidationError, ex: |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
124 |
self._to_create[eid] = ex.entity |
3451
6b46d73823f5
[api] work in progress, use __regid__, cw_*, etc.
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3396
diff
changeset
|
125 |
if self._cw.json_request: # XXX (syt) why? |
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
126 |
ex.entity = eid |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
127 |
raise |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
128 |
self._to_create[eid] = neweid |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
129 |
return neweid |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
130 |
|
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
131 |
def _update_entity(self, eid, rqlquery): |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
132 |
rql = rqlquery.update_query(eid) |
3451
6b46d73823f5
[api] work in progress, use __regid__, cw_*, etc.
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3396
diff
changeset
|
133 |
self._cw.execute(rql, rqlquery.kwargs) |
1753 | 134 |
|
0 | 135 |
def edit_entity(self, formparams, multiple=False): |
136 |
"""edit / create / copy an entity and return its eid""" |
|
137 |
etype = formparams['__type'] |
|
3451
6b46d73823f5
[api] work in progress, use __regid__, cw_*, etc.
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3396
diff
changeset
|
138 |
entity = self._cw.vreg['etypes'].etype_class(etype)(self._cw) |
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
139 |
entity.eid = formparams['eid'] |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
140 |
eid = self._get_eid(entity.eid) |
3451
6b46d73823f5
[api] work in progress, use __regid__, cw_*, etc.
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3396
diff
changeset
|
141 |
is_main_entity = self._cw.form.get('__maineid') == formparams['eid'] |
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
142 |
# let a chance to do some entity specific stuff.tn |
1753 | 143 |
entity.pre_web_edit() |
0 | 144 |
# create a rql query from parameters |
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
145 |
rqlquery = RqlQuery() |
0 | 146 |
# process inlined relations at the same time as attributes |
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
147 |
# this will generate less rql queries and might be useful in |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
148 |
# a few dark corners |
3451
6b46d73823f5
[api] work in progress, use __regid__, cw_*, etc.
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3396
diff
changeset
|
149 |
formid = self._cw.form.get('__form_id', 'edition') |
6b46d73823f5
[api] work in progress, use __regid__, cw_*, etc.
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3396
diff
changeset
|
150 |
form = self._cw.vreg['forms'].select(formid, self._cw, entity=entity) |
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
151 |
for field in form.fields: |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
152 |
if form.form_field_modified(field): |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
153 |
self.handle_formfield(form, field, entity, rqlquery) |
0 | 154 |
if eid is None: # creation or copy |
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
155 |
entity.eid = self._insert_entity(etype, formparams['eid'], rqlquery) |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
156 |
elif rqlquery.edited: # edition of an existant entity |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
157 |
self._update_entity(eid, rqlquery) |
3386
ab797c5374b7
[editcontroller] rename is_edited variable into is_main_entity to make things clearer
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3384
diff
changeset
|
158 |
if is_main_entity: |
0 | 159 |
self.notify_edited(entity) |
160 |
if formparams.has_key('__delete'): |
|
3451
6b46d73823f5
[api] work in progress, use __regid__, cw_*, etc.
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3396
diff
changeset
|
161 |
todelete = self._cw.list_form_param('__delete', formparams, pop=True) |
0 | 162 |
self.delete_relations(parse_relations_descr(todelete)) |
163 |
if formparams.has_key('__cloned_eid'): |
|
3631
6176ef2f6488
give correctly typed eid
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
3309
diff
changeset
|
164 |
entity.copy_relations(typed_eid(formparams['__cloned_eid'])) |
0 | 165 |
if formparams.has_key('__insert'): |
3451
6b46d73823f5
[api] work in progress, use __regid__, cw_*, etc.
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3396
diff
changeset
|
166 |
toinsert = self._cw.list_form_param('__insert', formparams, pop=True) |
0 | 167 |
self.insert_relations(parse_relations_descr(toinsert)) |
3386
ab797c5374b7
[editcontroller] rename is_edited variable into is_main_entity to make things clearer
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3384
diff
changeset
|
168 |
if is_main_entity: # only execute linkto for the main entity |
0 | 169 |
self.execute_linkto(eid) |
170 |
return eid |
|
171 |
||
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
172 |
def handle_formfield(self, form, field, entity, rqlquery): |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
173 |
eschema = entity.e_schema |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
174 |
try: |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
175 |
for attr, value in field.process_posted(form): |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
176 |
if not ( |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
177 |
(field.role == 'subject' and eschema.has_subject_relation(field.name)) |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
178 |
or |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
179 |
(field.role == 'object' and eschema.has_object_relation(field.name))): |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
180 |
continue |
3451
6b46d73823f5
[api] work in progress, use __regid__, cw_*, etc.
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3396
diff
changeset
|
181 |
rschema = self._cw.schema.rschema(field.name) |
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
182 |
if rschema.is_final(): |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
183 |
rqlquery.kwargs[attr] = value |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
184 |
rqlquery.edited.append('X %s %%(%s)s' % (attr, attr)) |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
185 |
elif rschema.inlined: |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
186 |
self.handle_inlined_relation(form, field, entity, rqlquery) |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
187 |
else: |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
188 |
self.relations_rql += self.handle_relation( |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
189 |
form, field, entity) |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
190 |
except ProcessFormError, exc: |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
191 |
self.errors.append((field, exc)) |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
192 |
|
0 | 193 |
def _action_apply(self): |
194 |
self._default_publish() |
|
195 |
self.reset() |
|
1753 | 196 |
|
0 | 197 |
def _action_cancel(self): |
3451
6b46d73823f5
[api] work in progress, use __regid__, cw_*, etc.
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3396
diff
changeset
|
198 |
errorurl = self._cw.form.get('__errorurl') |
0 | 199 |
if errorurl: |
3451
6b46d73823f5
[api] work in progress, use __regid__, cw_*, etc.
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3396
diff
changeset
|
200 |
self._cw.cancel_edition(errorurl) |
6b46d73823f5
[api] work in progress, use __regid__, cw_*, etc.
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3396
diff
changeset
|
201 |
self._cw.message = self._cw._('edit canceled') |
0 | 202 |
return self.reset() |
203 |
||
204 |
def _action_delete(self): |
|
3451
6b46d73823f5
[api] work in progress, use __regid__, cw_*, etc.
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3396
diff
changeset
|
205 |
self.delete_entities(self._cw.edited_eids(withtype=True)) |
0 | 206 |
return self.reset() |
207 |
||
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
208 |
def _relation_values(self, form, field, entity, late=False): |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
209 |
"""handle edition for the (rschema, x) relation of the given entity |
0 | 210 |
""" |
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
211 |
values = set() |
3463
bc2ee1d059fd
[editcontroller] fix bad method name: s/process_form_data/process_form_value
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3451
diff
changeset
|
212 |
for eid in field.process_form_value(form): |
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
213 |
if not eid: # AutoCompletionWidget |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
214 |
continue |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
215 |
typed_eid = self._get_eid(eid) |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
216 |
if typed_eid is None: |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
217 |
if late: |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
218 |
# eid is still None while it's already a late call |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
219 |
# this mean that the associated entity has not been created |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
220 |
raise Exception("eid %s is still not created" % eid) |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
221 |
self._pending_relations.append( (form, field, entity) ) |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
222 |
return None |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
223 |
values.add(typed_eid) |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
224 |
return values |
0 | 225 |
|
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
226 |
def handle_inlined_relation(self, form, field, entity, rqlquery): |
0 | 227 |
"""handle edition for the (rschema, x) relation of the given entity |
228 |
""" |
|
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
229 |
origvalues = set(row[0] for row in entity.related(field.name, field.role)) |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
230 |
values = self._relation_values(form, field, entity) |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
231 |
if values is None or values == origvalues: |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
232 |
return # not edited / not modified / to do later |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
233 |
attr = field.name |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
234 |
if values: |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
235 |
rqlquery.kwargs[attr] = iter(values).next() |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
236 |
rqlquery.edition.append('X %s %s' % (attr, attr.upper())) |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
237 |
rqlquery.restrictions.append('%s eid %%(%s)s' % (attr.upper(), attr)) |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
238 |
elif entity.has_eid(): |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
239 |
self.relations_rql += self.handle_relation(form, field, entity) |
0 | 240 |
|
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
241 |
def handle_relation(self, form, field, entity, late=False): |
0 | 242 |
"""handle edition for the (rschema, x) relation of the given entity |
243 |
""" |
|
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
244 |
origvalues = set(row[0] for row in entity.related(field.name, field.role)) |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
245 |
values = self._relation_values(form, field, entity, late) |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
246 |
if values is None or values == origvalues: |
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
247 |
return # not edited / not modified / to do later |
0 | 248 |
etype = entity.e_schema |
3451
6b46d73823f5
[api] work in progress, use __regid__, cw_*, etc.
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3396
diff
changeset
|
249 |
rschema = self._cw.schema.rschema(field.name) |
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
250 |
if field.role == 'subject': |
0 | 251 |
desttype = rschema.objects(etype)[0] |
252 |
card = rschema.rproperty(etype, desttype, 'cardinality')[0] |
|
253 |
subjvar, objvar = 'X', 'Y' |
|
254 |
else: |
|
255 |
desttype = rschema.subjects(etype)[0] |
|
256 |
card = rschema.rproperty(desttype, etype, 'cardinality')[1] |
|
257 |
subjvar, objvar = 'Y', 'X' |
|
258 |
eid = entity.eid |
|
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
259 |
if field.role == 'object' or not rschema.inlined or not values: |
0 | 260 |
# this is not an inlined relation or no values specified, |
261 |
# explicty remove relations |
|
1798
cc86fe8efaaa
pass default values along the whole call chain, fix hidden field update bug
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents:
1765
diff
changeset
|
262 |
rql = 'DELETE %s %s %s WHERE X eid %%(x)s, Y eid %%(y)s' % ( |
cc86fe8efaaa
pass default values along the whole call chain, fix hidden field update bug
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents:
1765
diff
changeset
|
263 |
subjvar, rschema, objvar) |
0 | 264 |
for reid in origvalues.difference(values): |
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
265 |
yield (rql, {'x': eid, 'y': reid}, ('x', 'y')) |
1798
cc86fe8efaaa
pass default values along the whole call chain, fix hidden field update bug
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents:
1765
diff
changeset
|
266 |
seteids = values.difference(origvalues) |
cc86fe8efaaa
pass default values along the whole call chain, fix hidden field update bug
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents:
1765
diff
changeset
|
267 |
if seteids: |
cc86fe8efaaa
pass default values along the whole call chain, fix hidden field update bug
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents:
1765
diff
changeset
|
268 |
rql = 'SET %s %s %s WHERE X eid %%(x)s, Y eid %%(y)s' % ( |
cc86fe8efaaa
pass default values along the whole call chain, fix hidden field update bug
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents:
1765
diff
changeset
|
269 |
subjvar, rschema, objvar) |
cc86fe8efaaa
pass default values along the whole call chain, fix hidden field update bug
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents:
1765
diff
changeset
|
270 |
for reid in seteids: |
3387
a357d4147eee
[forms] work-in-progress, big editcontroller refactoring: let fields/widgets process posted data
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
3386
diff
changeset
|
271 |
yield (rql, {'x': eid, 'y': reid}, ('x', 'y')) |
1753 | 272 |
|
0 | 273 |
def _get_eid(self, eid): |
274 |
# should be either an int (existant entity) or a variable (to be |
|
275 |
# created entity) |
|
276 |
assert eid or eid == 0, repr(eid) # 0 is a valid eid |
|
277 |
try: |
|
278 |
return typed_eid(eid) |
|
279 |
except ValueError: |
|
280 |
try: |
|
281 |
return self._to_create[eid] |
|
282 |
except KeyError: |
|
283 |
self._to_create[eid] = None |
|
284 |
return None |
|
285 |
||
286 |
def _linked_eids(self, eids, late=False): |
|
287 |
"""return a list of eids if they are all known, else raise ToDoLater |
|
288 |
""" |
|
289 |
||
1753 | 290 |