| author | Sylvain Thénault <sylvain.thenault@logilab.fr> |
| Thu, 13 Aug 2009 09:41:05 +0200 | |
| changeset 2795 | 59965167bef3 |
| parent 2788 | 8d3dbe577d3a |
| child 2799 | b703639614e7 |
| permissions | -rw-r--r-- |
| 0 | 1 |
"""abstract views and templates classes for CubicWeb web client |
2 |
||
3 |
||
4 |
:organization: Logilab |
|
|
1977
606923dff11b
big bunch of copyright / docstring update
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
1756
diff
changeset
|
5 |
:copyright: 2001-2009 LOGILAB S.A. (Paris, FRANCE), license is LGPL v2. |
| 0 | 6 |
: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:
1756
diff
changeset
|
7 |
:license: GNU Lesser General Public License, v2.1 - http://www.gnu.org/licenses |
| 0 | 8 |
""" |
9 |
__docformat__ = "restructuredtext en" |
|
|
1999
b9a8f5995658
obsolete methods
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
1985
diff
changeset
|
10 |
_ = unicode |
| 0 | 11 |
|
12 |
from cStringIO import StringIO |
|
13 |
||
|
2613
5e19c2bb370e
R [all] logilab.common 0.44 provides only deprecated
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
2558
diff
changeset
|
14 |
from logilab.common.deprecation import deprecated |
|
2312
af4d8f75c5db
use xml_escape
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2217
diff
changeset
|
15 |
from logilab.mtconverter import xml_escape |
|
2644
100b81ba3a98
F [view] missing import
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2613
diff
changeset
|
16 |
from rql import nodes |
| 0 | 17 |
|
|
1181
620ec8e6ae19
cleanup, various fix to get something working
sylvain.thenault@logilab.fr
parents:
1144
diff
changeset
|
18 |
from cubicweb import NotAnEntity |
| 1132 | 19 |
from cubicweb.selectors import yes, non_final_entity, nonempty_rset, none_rset |
|
635
305da8d6aa2d
require_group/match_user_group -> match_user_groups
sylvain.thenault@logilab.fr
parents:
633
diff
changeset
|
20 |
from cubicweb.selectors import require_group_compat, accepts_compat |
|
2656
a93ae0f6c0ad
R [base classes] only AppObject remaning, no more AppRsetObject
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2644
diff
changeset
|
21 |
from cubicweb.appobject import AppObject |
|
708
b4728112625f
move utils from cw.common to cw
sylvain.thenault@logilab.fr
parents:
707
diff
changeset
|
22 |
from cubicweb.utils import UStringIO, HTMLStream |
|
2217
3a8cee8f8778
explicit display_name import
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2207
diff
changeset
|
23 |
from cubicweb.schema import display_name |
| 633 | 24 |
|
| 0 | 25 |
# robots control |
26 |
NOINDEX = u'<meta name="ROBOTS" content="NOINDEX" />' |
|
27 |
NOFOLLOW = u'<meta name="ROBOTS" content="NOFOLLOW" />' |
|
28 |
||
29 |
CW_XHTML_EXTENSIONS = '''[ |
|
30 |
<!ATTLIST html xmlns:cubicweb CDATA #FIXED \'http://www.logilab.org/2008/cubicweb\' > |
|
31 |
||
32 |
<!ENTITY % coreattrs |
|
|
522
385ce5e0b30b
cubicweb__loadurl -> cubicweb:lazyloadurl
sylvain.thenault@logilab.fr
parents:
497
diff
changeset
|
33 |
"id ID #IMPLIED |
|
385ce5e0b30b
cubicweb__loadurl -> cubicweb:lazyloadurl
sylvain.thenault@logilab.fr
parents:
497
diff
changeset
|
34 |
class CDATA #IMPLIED |
|
385ce5e0b30b
cubicweb__loadurl -> cubicweb:lazyloadurl
sylvain.thenault@logilab.fr
parents:
497
diff
changeset
|
35 |
style CDATA #IMPLIED |
| 0 | 36 |
title CDATA #IMPLIED |
37 |
||
38 |
cubicweb:sortvalue CDATA #IMPLIED |
|
39 |
cubicweb:target CDATA #IMPLIED |
|
40 |
cubicweb:limit CDATA #IMPLIED |
|
41 |
cubicweb:type CDATA #IMPLIED |
|
42 |
cubicweb:loadtype CDATA #IMPLIED |
|
43 |
cubicweb:wdgtype CDATA #IMPLIED |
|
44 |
cubicweb:initfunc CDATA #IMPLIED |
|
45 |
cubicweb:inputid CDATA #IMPLIED |
|
46 |
cubicweb:tindex CDATA #IMPLIED |
|
47 |
cubicweb:inputname CDATA #IMPLIED |
|
48 |
cubicweb:value CDATA #IMPLIED |
|
49 |
cubicweb:required CDATA #IMPLIED |
|
50 |
cubicweb:accesskey CDATA #IMPLIED |
|
51 |
cubicweb:maxlength CDATA #IMPLIED |
|
52 |
cubicweb:variables CDATA #IMPLIED |
|
53 |
cubicweb:displayactions CDATA #IMPLIED |
|
54 |
cubicweb:fallbackvid CDATA #IMPLIED |
|
|
1498
2c6eec0b46b9
fix imports, cleanup, repair some ajax calls
sylvain.thenault@logilab.fr
parents:
1433
diff
changeset
|
55 |
cubicweb:fname CDATA #IMPLIED |
| 0 | 56 |
cubicweb:vid CDATA #IMPLIED |
57 |
cubicweb:rql CDATA #IMPLIED |
|
58 |
cubicweb:actualrql CDATA #IMPLIED |
|
|
543
c0f2b6378f70
simplification of lazy tabs mechanism
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
522
diff
changeset
|
59 |
cubicweb:rooteid CDATA #IMPLIED |
| 0 | 60 |
cubicweb:dataurl CDATA #IMPLIED |
|
543
c0f2b6378f70
simplification of lazy tabs mechanism
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
522
diff
changeset
|
61 |
cubicweb:size CDATA #IMPLIED |
| 0 | 62 |
cubicweb:tlunit CDATA #IMPLIED |
63 |
cubicweb:loadurl CDATA #IMPLIED |
|
64 |
cubicweb:uselabel CDATA #IMPLIED |
|
| 472 | 65 |
cubicweb:facetargs CDATA #IMPLIED |
66 |
cubicweb:facetName CDATA #IMPLIED |
|
| 0 | 67 |
"> ] ''' |
68 |
||
|
1421
77ee26df178f
doc type handling refactoring: do the ext substitution at the module level
sylvain.thenault@logilab.fr
parents:
1181
diff
changeset
|
69 |
TRANSITIONAL_DOCTYPE = u'<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd" %s>\n' % CW_XHTML_EXTENSIONS |
|
77ee26df178f
doc type handling refactoring: do the ext substitution at the module level
sylvain.thenault@logilab.fr
parents:
1181
diff
changeset
|
70 |
TRANSITIONAL_DOCTYPE_NOEXT = u'<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">\n' |
|
77ee26df178f
doc type handling refactoring: do the ext substitution at the module level
sylvain.thenault@logilab.fr
parents:
1181
diff
changeset
|
71 |
STRICT_DOCTYPE = u'<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd" %s>\n' % CW_XHTML_EXTENSIONS |
|
77ee26df178f
doc type handling refactoring: do the ext substitution at the module level
sylvain.thenault@logilab.fr
parents:
1181
diff
changeset
|
72 |
STRICT_DOCTYPE_NOEXT = u'<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">\n' |
| 0 | 73 |
|
|
661
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
74 |
# base view object ############################################################ |
|
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
75 |
|
|
2656
a93ae0f6c0ad
R [base classes] only AppObject remaning, no more AppRsetObject
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2644
diff
changeset
|
76 |
class View(AppObject): |
| 0 | 77 |
"""abstract view class, used as base for every renderable object such |
78 |
as views, templates, some components...web |
|
79 |
||
80 |
A view is instantiated to render a [part of a] result set. View |
|
81 |
subclasses may be parametred using the following class attributes: |
|
|
543
c0f2b6378f70
simplification of lazy tabs mechanism
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
522
diff
changeset
|
82 |
|
| 0 | 83 |
* `templatable` indicates if the view may be embeded in a main |
84 |
template or if it has to be rendered standalone (i.e. XML for |
|
85 |
instance) |
|
86 |
* if the view is not templatable, it should set the `content_type` class |
|
87 |
attribute to the correct MIME type (text/xhtml by default) |
|
88 |
* the `category` attribute may be used in the interface to regroup related |
|
89 |
objects together |
|
90 |
||
91 |
At instantiation time, the standard `req`, `rset`, and `cursor` |
|
92 |
attributes are added and the `w` attribute will be set at rendering |
|
93 |
time to a write function to use. |
|
94 |
""" |
|
|
816
9cd49a910fce
kill Template class and 'templates' registry
sylvain.thenault@logilab.fr
parents:
781
diff
changeset
|
95 |
__registry__ = 'views' |
|
2656
a93ae0f6c0ad
R [base classes] only AppObject remaning, no more AppRsetObject
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2644
diff
changeset
|
96 |
registered = require_group_compat(AppObject.registered) |
|
543
c0f2b6378f70
simplification of lazy tabs mechanism
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
522
diff
changeset
|
97 |
|
| 0 | 98 |
templatable = True |
99 |
need_navigation = True |
|
100 |
# content_type = 'application/xhtml+xml' # text/xhtml' |
|
101 |
binary = False |
|
102 |
add_to_breadcrumbs = True |
|
103 |
category = 'view' |
|
|
543
c0f2b6378f70
simplification of lazy tabs mechanism
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
522
diff
changeset
|
104 |
|
|
1143
8d097defbf2c
change the way selected/__init__ are used for AppRsetObject
sylvain.thenault@logilab.fr
parents:
1132
diff
changeset
|
105 |
def __init__(self, req=None, rset=None, **kwargs): |
|
8d097defbf2c
change the way selected/__init__ are used for AppRsetObject
sylvain.thenault@logilab.fr
parents:
1132
diff
changeset
|
106 |
super(View, self).__init__(req, rset, **kwargs) |
| 0 | 107 |
self.w = None |
108 |
||
109 |
@property |
|
110 |
def content_type(self): |
|
|
1421
77ee26df178f
doc type handling refactoring: do the ext substitution at the module level
sylvain.thenault@logilab.fr
parents:
1181
diff
changeset
|
111 |
return self.req.html_content_type() |
|
543
c0f2b6378f70
simplification of lazy tabs mechanism
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
522
diff
changeset
|
112 |
|
| 0 | 113 |
def set_stream(self, w=None): |
114 |
if self.w is not None: |
|
115 |
return |
|
116 |
if w is None: |
|
117 |
if self.binary: |
|
118 |
self._stream = stream = StringIO() |
|
119 |
else: |
|
120 |
self._stream = stream = UStringIO() |
|
121 |
w = stream.write |
|
122 |
else: |
|
123 |
stream = None |
|
124 |
self.w = w |
|
125 |
return stream |
|
126 |
||
127 |
# main view interface ##################################################### |
|
|
543
c0f2b6378f70
simplification of lazy tabs mechanism
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
522
diff
changeset
|
128 |
|
| 1723 | 129 |
def render(self, w=None, **context): |
| 0 | 130 |
"""called to render a view object for a result set. |
131 |
||
132 |
This method is a dispatched to an actual method selected |
|
133 |
according to optional row and col parameters, which are locating |
|
134 |
a particular row or cell in the result set: |
|
|
543
c0f2b6378f70
simplification of lazy tabs mechanism
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
522
diff
changeset
|
135 |
|
| 1132 | 136 |
* if row is specified, `cell_call` is called |
| 0 | 137 |
* if none of them is supplied, the view is considered to apply on |
138 |
the whole result set (which may be None in this case), `call` is |
|
139 |
called |
|
140 |
""" |
|
| 1132 | 141 |
row = context.get('row') |
| 0 | 142 |
if row is not None: |
143 |
context.setdefault('col', 0) |
|
144 |
view_func = self.cell_call |
|
145 |
else: |
|
146 |
view_func = self.call |
|
147 |
stream = self.set_stream(w) |
|
148 |
# stream = self.set_stream(context) |
|
149 |
view_func(**context) |
|
150 |
# return stream content if we have created it |
|
151 |
if stream is not None: |
|
152 |
return self._stream.getvalue() |
|
153 |
||
|
2795
59965167bef3
move tal_render to View
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2788
diff
changeset
|
154 |
def tal_render(self, template, variables): |
|
59965167bef3
move tal_render to View
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2788
diff
changeset
|
155 |
"""render a precompiled page template with variables in the given |
|
59965167bef3
move tal_render to View
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2788
diff
changeset
|
156 |
dictionary as context |
|
59965167bef3
move tal_render to View
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2788
diff
changeset
|
157 |
""" |
|
59965167bef3
move tal_render to View
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2788
diff
changeset
|
158 |
from cubicweb.ext.tal import CubicWebContext |
|
59965167bef3
move tal_render to View
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2788
diff
changeset
|
159 |
context = CubicWebContext() |
|
59965167bef3
move tal_render to View
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2788
diff
changeset
|
160 |
context.update({'self': self, 'rset': self.rset, '_' : self.req._, |
|
59965167bef3
move tal_render to View
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2788
diff
changeset
|
161 |
'req': self.req, 'user': self.req.user}) |
|
59965167bef3
move tal_render to View
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2788
diff
changeset
|
162 |
context.update(variables) |
|
59965167bef3
move tal_render to View
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2788
diff
changeset
|
163 |
output = UStringIO() |
|
59965167bef3
move tal_render to View
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2788
diff
changeset
|
164 |
template.expand(context, output) |
|
59965167bef3
move tal_render to View
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2788
diff
changeset
|
165 |
return output.getvalue() |
|
59965167bef3
move tal_render to View
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2788
diff
changeset
|
166 |
|
|
2788
8d3dbe577d3a
R put version info in deprecation warnings
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
2656
diff
changeset
|
167 |
dispatch = deprecated('[3.4] .dispatch is deprecated, use .render')(render) |
| 1723 | 168 |
|
| 0 | 169 |
# should default .call() method add a <div classs="section"> around each |
170 |
# rset item |
|
171 |
add_div_section = True |
|
|
543
c0f2b6378f70
simplification of lazy tabs mechanism
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
522
diff
changeset
|
172 |
|
| 0 | 173 |
def call(self, **kwargs): |
174 |
"""the view is called for an entire result set, by default loop |
|
175 |
other rows of the result set and call the same view on the |
|
176 |
particular row |
|
177 |
||
178 |
Views applicable on None result sets have to override this method |
|
179 |
""" |
|
180 |
rset = self.rset |
|
181 |
if rset is None: |
|
182 |
raise NotImplementedError, self |
|
183 |
wrap = self.templatable and len(rset) > 1 and self.add_div_section |
|
184 |
for i in xrange(len(rset)): |
|
185 |
if wrap: |
|
186 |
self.w(u'<div class="section">') |
|
187 |
self.wview(self.id, rset, row=i, **kwargs) |
|
188 |
if wrap: |
|
189 |
self.w(u"</div>") |
|
190 |
||
191 |
def cell_call(self, row, col, **kwargs): |
|
192 |
"""the view is called for a particular result set cell""" |
|
193 |
raise NotImplementedError, self |
|
|
543
c0f2b6378f70
simplification of lazy tabs mechanism
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
522
diff
changeset
|
194 |
|
| 0 | 195 |
def linkable(self): |
196 |
"""return True if the view may be linked in a menu |
|
|
543
c0f2b6378f70
simplification of lazy tabs mechanism
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
522
diff
changeset
|
197 |
|
| 0 | 198 |
by default views without title are not meant to be displayed |
199 |
""" |
|
200 |
if not getattr(self, 'title', None): |
|
201 |
return False |
|
202 |
return True |
|
203 |
||
204 |
def is_primary(self): |
|
205 |
return self.id == 'primary' |
|
|
543
c0f2b6378f70
simplification of lazy tabs mechanism
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
522
diff
changeset
|
206 |
|
| 0 | 207 |
def url(self): |
208 |
"""return the url associated with this view. Should not be |
|
209 |
necessary for non linkable views, but a default implementation |
|
210 |
is provided anyway. |
|
211 |
""" |
|
|
2468
93853b6f3bad
move all view.url() logic in a single implementation
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2418
diff
changeset
|
212 |
rset = self.rset |
|
93853b6f3bad
move all view.url() logic in a single implementation
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2418
diff
changeset
|
213 |
if rset is None: |
|
93853b6f3bad
move all view.url() logic in a single implementation
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2418
diff
changeset
|
214 |
return self.build_url('view', vid=self.id) |
|
93853b6f3bad
move all view.url() logic in a single implementation
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2418
diff
changeset
|
215 |
coltypes = rset.column_types(0) |
|
93853b6f3bad
move all view.url() logic in a single implementation
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2418
diff
changeset
|
216 |
if len(coltypes) == 1: |
|
93853b6f3bad
move all view.url() logic in a single implementation
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2418
diff
changeset
|
217 |
etype = iter(coltypes).next() |
|
93853b6f3bad
move all view.url() logic in a single implementation
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2418
diff
changeset
|
218 |
if not self.schema.eschema(etype).is_final(): |
|
93853b6f3bad
move all view.url() logic in a single implementation
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2418
diff
changeset
|
219 |
if len(rset) == 1: |
|
93853b6f3bad
move all view.url() logic in a single implementation
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2418
diff
changeset
|
220 |
entity = rset.get_entity(0, 0) |
|
93853b6f3bad
move all view.url() logic in a single implementation
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2418
diff
changeset
|
221 |
return entity.absolute_url(vid=self.id) |
|
93853b6f3bad
move all view.url() logic in a single implementation
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2418
diff
changeset
|
222 |
# don't want to generate /<etype> url if there is some restriction |
|
93853b6f3bad
move all view.url() logic in a single implementation
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2418
diff
changeset
|
223 |
# on something else than the entity type |
|
93853b6f3bad
move all view.url() logic in a single implementation
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2418
diff
changeset
|
224 |
restr = rset.syntax_tree().children[0].where |
|
93853b6f3bad
move all view.url() logic in a single implementation
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2418
diff
changeset
|
225 |
# XXX norestriction is not correct here. For instance, in cases like |
|
93853b6f3bad
move all view.url() logic in a single implementation
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2418
diff
changeset
|
226 |
# "Any P,N WHERE P is Project, P name N" norestriction should equal |
|
93853b6f3bad
move all view.url() logic in a single implementation
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2418
diff
changeset
|
227 |
# True |
|
93853b6f3bad
move all view.url() logic in a single implementation
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2418
diff
changeset
|
228 |
norestriction = (isinstance(restr, nodes.Relation) and |
|
93853b6f3bad
move all view.url() logic in a single implementation
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2418
diff
changeset
|
229 |
restr.is_types_restriction()) |
|
93853b6f3bad
move all view.url() logic in a single implementation
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2418
diff
changeset
|
230 |
if norestriction: |
|
93853b6f3bad
move all view.url() logic in a single implementation
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2418
diff
changeset
|
231 |
return self.build_url(etype.lower(), vid=self.id) |
|
93853b6f3bad
move all view.url() logic in a single implementation
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2418
diff
changeset
|
232 |
return self.build_url('view', rql=rset.printable_rql(), vid=self.id) |
| 0 | 233 |
|
234 |
def set_request_content_type(self): |
|
235 |
"""set the content type returned by this view""" |
|
236 |
self.req.set_content_type(self.content_type) |
|
237 |
||
238 |
# view utilities ########################################################## |
|
| 1433 | 239 |
|
|
1985
9c1db4e06095
move view method's logic on the registry, so it's easier to call it from outside an appobject. Also make rset argument optional
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
1977
diff
changeset
|
240 |
def wview(self, __vid, rset=None, __fallback_vid=None, **kwargs): |
| 0 | 241 |
"""shortcut to self.view method automatically passing self.w as argument |
242 |
""" |
|
243 |
self.view(__vid, rset, __fallback_vid, w=self.w, **kwargs) |
|
| 1433 | 244 |
|
| 819 | 245 |
# XXX Template bw compat |
|
2788
8d3dbe577d3a
R put version info in deprecation warnings
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
2656
diff
changeset
|
246 |
template = deprecated('[3.4] .template is deprecated, use .view')(wview) |
| 0 | 247 |
|
248 |
def whead(self, data): |
|
249 |
self.req.html_headers.write(data) |
|
250 |
||
251 |
def wdata(self, data): |
|
252 |
"""simple helper that escapes `data` and writes into `self.w`""" |
|
|
2312
af4d8f75c5db
use xml_escape
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2217
diff
changeset
|
253 |
self.w(xml_escape(data)) |
| 0 | 254 |
|
255 |
def html_headers(self): |
|
256 |
"""return a list of html headers (eg something to be inserted between |
|
257 |
<head> and </head> of the returned page |
|
258 |
||
259 |
by default return a meta tag to disable robot indexation of the page |
|
260 |
""" |
|
261 |
return [NOINDEX] |
|
|
543
c0f2b6378f70
simplification of lazy tabs mechanism
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
522
diff
changeset
|
262 |
|
| 0 | 263 |
def page_title(self): |
264 |
"""returns a title according to the result set - used for the |
|
265 |
title in the HTML header |
|
266 |
""" |
|
267 |
vtitle = self.req.form.get('vtitle') |
|
268 |
if vtitle: |
|
269 |
return self.req._(vtitle) |
|
270 |
# class defined title will only be used if the resulting title doesn't |
|
271 |
# seem clear enough |
|
272 |
vtitle = getattr(self, 'title', None) or u'' |
|
273 |
if vtitle: |
|
274 |
vtitle = self.req._(vtitle) |
|
275 |
rset = self.rset |
|
276 |
if rset and rset.rowcount: |
|
277 |
if rset.rowcount == 1: |
|
278 |
try: |
|
279 |
entity = self.complete_entity(0) |
|
280 |
# use long_title to get context information if any |
|
281 |
clabel = entity.dc_long_title() |
|
282 |
except NotAnEntity: |
|
283 |
clabel = display_name(self.req, rset.description[0][0]) |
|
284 |
clabel = u'%s (%s)' % (clabel, vtitle) |
|
285 |
else : |
|
286 |
etypes = rset.column_types(0) |
|
287 |
if len(etypes) == 1: |
|
288 |
etype = iter(etypes).next() |
|
289 |
clabel = display_name(self.req, etype, 'plural') |
|
290 |
else : |
|
291 |
clabel = u'#[*] (%s)' % vtitle |
|
292 |
else: |
|
293 |
clabel = vtitle |
|
294 |
return u'%s (%s)' % (clabel, self.req.property_value('ui.site-title')) |
|
295 |
||
296 |
def output_url_builder( self, name, url, args ): |
|
297 |
self.w(u'<script language="JavaScript"><!--\n' \ |
|
298 |
u'function %s( %s ) {\n' % (name, ','.join(args) ) ) |
|
299 |
url_parts = url.split("%s") |
|
300 |
self.w(u' url="%s"' % url_parts[0] ) |
|
301 |
for arg, part in zip(args, url_parts[1:]): |
|
302 |
self.w(u'+str(%s)' % arg ) |
|
303 |
if part: |
|
304 |
self.w(u'+"%s"' % part) |
|
305 |
self.w('\n document.window.href=url;\n') |
|
306 |
self.w('}\n-->\n</script>\n') |
|
307 |
||
308 |
def create_url(self, etype, **kwargs): |
|
309 |
""" return the url of the entity creation form for a given entity type""" |
|
310 |
return self.req.build_url('add/%s'%etype, **kwargs) |
|
311 |
||
312 |
def field(self, label, value, row=True, show_label=True, w=None, tr=True): |
|
313 |
""" read-only field """ |
|
314 |
if w is None: |
|
315 |
w = self.w |
|
316 |
if row: |
|
317 |
w(u'<div class="row">') |
|
318 |
if show_label: |
|
319 |
if tr: |
|
320 |
label = display_name(self.req, label) |
|
321 |
w(u'<span class="label">%s</span>' % label) |
|
322 |
w(u'<div class="field">%s</div>' % value) |
|
323 |
if row: |
|
324 |
w(u'</div>') |
|
| 1433 | 325 |
|
| 0 | 326 |
|
|
543
c0f2b6378f70
simplification of lazy tabs mechanism
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
522
diff
changeset
|
327 |
|
|
640
8e64f12be69c
drop EntityAction usage in cw, upgrade rql_condition and friends
sylvain.thenault@logilab.fr
parents:
635
diff
changeset
|
328 |
# concrete views base classes ################################################# |
|
8e64f12be69c
drop EntityAction usage in cw, upgrade rql_condition and friends
sylvain.thenault@logilab.fr
parents:
635
diff
changeset
|
329 |
|
|
8e64f12be69c
drop EntityAction usage in cw, upgrade rql_condition and friends
sylvain.thenault@logilab.fr
parents:
635
diff
changeset
|
330 |
class EntityView(View): |
| 843 | 331 |
"""base class for views applying on an entity (i.e. uniform result set)""" |
|
781
323656dd85a9
fix import, use non_final_entity instead of implements('Any')
sylvain.thenault@logilab.fr
parents:
757
diff
changeset
|
332 |
__select__ = non_final_entity() |
|
757
01740274e774
remove explicit access to .im_func when overriding `registered`
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
719
diff
changeset
|
333 |
registered = accepts_compat(View.registered) |
|
640
8e64f12be69c
drop EntityAction usage in cw, upgrade rql_condition and friends
sylvain.thenault@logilab.fr
parents:
635
diff
changeset
|
334 |
|
|
8e64f12be69c
drop EntityAction usage in cw, upgrade rql_condition and friends
sylvain.thenault@logilab.fr
parents:
635
diff
changeset
|
335 |
category = 'entityview' |
|
8e64f12be69c
drop EntityAction usage in cw, upgrade rql_condition and friends
sylvain.thenault@logilab.fr
parents:
635
diff
changeset
|
336 |
|
|
8e64f12be69c
drop EntityAction usage in cw, upgrade rql_condition and friends
sylvain.thenault@logilab.fr
parents:
635
diff
changeset
|
337 |
|
| 0 | 338 |
class StartupView(View): |
| 843 | 339 |
"""base class for views which doesn't need a particular result set to be |
340 |
displayed (so they can always be displayed !) |
|
| 0 | 341 |
""" |
| 707 | 342 |
__select__ = none_rset() |
|
757
01740274e774
remove explicit access to .im_func when overriding `registered`
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
719
diff
changeset
|
343 |
registered = require_group_compat(View.registered) |
| 1433 | 344 |
|
| 0 | 345 |
category = 'startupview' |
| 1433 | 346 |
|
| 0 | 347 |
def html_headers(self): |
348 |
"""return a list of html headers (eg something to be inserted between |
|
349 |
<head> and </head> of the returned page |
|
350 |
||
351 |
by default startup views are indexed |
|
352 |
""" |
|
353 |
return [] |
|
354 |
||
355 |
||
356 |
class EntityStartupView(EntityView): |
|
357 |
"""base class for entity views which may also be applied to None |
|
358 |
result set (usually a default rql is provided by the view class) |
|
359 |
""" |
|
|
781
323656dd85a9
fix import, use non_final_entity instead of implements('Any')
sylvain.thenault@logilab.fr
parents:
757
diff
changeset
|
360 |
__select__ = none_rset() | non_final_entity() |
|
543
c0f2b6378f70
simplification of lazy tabs mechanism
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
522
diff
changeset
|
361 |
|
| 0 | 362 |
default_rql = None |
|
543
c0f2b6378f70
simplification of lazy tabs mechanism
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
522
diff
changeset
|
363 |
|
|
2418
8f06e4f02733
optional rset
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2312
diff
changeset
|
364 |
def __init__(self, req, rset=None, **kwargs): |
|
1143
8d097defbf2c
change the way selected/__init__ are used for AppRsetObject
sylvain.thenault@logilab.fr
parents:
1132
diff
changeset
|
365 |
super(EntityStartupView, self).__init__(req, rset, **kwargs) |
| 0 | 366 |
if rset is None: |
367 |
# this instance is not in the "entityview" category |
|
368 |
self.category = 'startupview' |
|
369 |
||
370 |
def startup_rql(self): |
|
| 873 | 371 |
"""return some rql to be executed if the result set is None""" |
| 0 | 372 |
return self.default_rql |
|
543
c0f2b6378f70
simplification of lazy tabs mechanism
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
522
diff
changeset
|
373 |
|
| 0 | 374 |
def call(self, **kwargs): |
| 873 | 375 |
"""override call to execute rql returned by the .startup_rql method if |
376 |
necessary |
|
| 0 | 377 |
""" |
378 |
if self.rset is None: |
|
379 |
self.rset = self.req.execute(self.startup_rql()) |
|
380 |
rset = self.rset |
|
381 |
for i in xrange(len(rset)): |
|
382 |
self.wview(self.id, rset, row=i, **kwargs) |
|
383 |
||
|
543
c0f2b6378f70
simplification of lazy tabs mechanism
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
522
diff
changeset
|
384 |
|
| 0 | 385 |
class AnyRsetView(View): |
386 |
"""base class for views applying on any non empty result sets""" |
|
| 707 | 387 |
__select__ = nonempty_rset() |
|
543
c0f2b6378f70
simplification of lazy tabs mechanism
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
522
diff
changeset
|
388 |
|
| 0 | 389 |
category = 'anyrsetview' |
|
543
c0f2b6378f70
simplification of lazy tabs mechanism
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
522
diff
changeset
|
390 |
|
|
2203
efdd3a9f9028
update to new rql get_description api
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
1999
diff
changeset
|
391 |
def columns_labels(self, mainindex=0, tr=True): |
|
370
7e76f651314b
fix rset xml view
Sylvain Thenault <sylvain.thenault@logilab.fr>
parents:
369
diff
changeset
|
392 |
if tr: |
|
2207
5fad58e603f4
fix translate argument
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2203
diff
changeset
|
393 |
translate = lambda val, req=self.req: display_name(req, val) |
|
370
7e76f651314b
fix rset xml view
Sylvain Thenault <sylvain.thenault@logilab.fr>
parents:
369
diff
changeset
|
394 |
else: |
|
2207
5fad58e603f4
fix translate argument
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2203
diff
changeset
|
395 |
translate = lambda val: val |
|
2203
efdd3a9f9028
update to new rql get_description api
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
1999
diff
changeset
|
396 |
# XXX [0] because of missing Union support |
|
efdd3a9f9028
update to new rql get_description api
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
1999
diff
changeset
|
397 |
rqlstdescr = self.rset.syntax_tree().get_description(mainindex, |
|
efdd3a9f9028
update to new rql get_description api
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
1999
diff
changeset
|
398 |
translate)[0] |
|
369
c8a6edc224bb
new rsetxml view, reusing most code from csvexport view
Sylvain Thenault <sylvain.thenault@logilab.fr>
parents:
361
diff
changeset
|
399 |
labels = [] |
|
2203
efdd3a9f9028
update to new rql get_description api
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
1999
diff
changeset
|
400 |
for colindex, label in enumerate(rqlstdescr): |
|
369
c8a6edc224bb
new rsetxml view, reusing most code from csvexport view
Sylvain Thenault <sylvain.thenault@logilab.fr>
parents:
361
diff
changeset
|
401 |
# compute column header |
|
2203
efdd3a9f9028
update to new rql get_description api
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
1999
diff
changeset
|
402 |
if label == 'Any': # find a better label |
|
2207
5fad58e603f4
fix translate argument
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2203
diff
changeset
|
403 |
label = ','.join(translate(et) |
|
369
c8a6edc224bb
new rsetxml view, reusing most code from csvexport view
Sylvain Thenault <sylvain.thenault@logilab.fr>
parents:
361
diff
changeset
|
404 |
for et in self.rset.column_types(colindex)) |
|
c8a6edc224bb
new rsetxml view, reusing most code from csvexport view
Sylvain Thenault <sylvain.thenault@logilab.fr>
parents:
361
diff
changeset
|
405 |
labels.append(label) |
|
c8a6edc224bb
new rsetxml view, reusing most code from csvexport view
Sylvain Thenault <sylvain.thenault@logilab.fr>
parents:
361
diff
changeset
|
406 |
return labels |
|
543
c0f2b6378f70
simplification of lazy tabs mechanism
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
522
diff
changeset
|
407 |
|
| 1433 | 408 |
|
| 0 | 409 |
# concrete template base classes ############################################## |
410 |
||
|
816
9cd49a910fce
kill Template class and 'templates' registry
sylvain.thenault@logilab.fr
parents:
781
diff
changeset
|
411 |
class MainTemplate(View): |
| 0 | 412 |
"""main template are primary access point to render a full HTML page. |
413 |
There is usually at least a regular main template and a simple fallback |
|
414 |
one to display error if the first one failed |
|
415 |
""" |
|
|
816
9cd49a910fce
kill Template class and 'templates' registry
sylvain.thenault@logilab.fr
parents:
781
diff
changeset
|
416 |
registered = require_group_compat(View.registered) |
| 0 | 417 |
|
418 |
@property |
|
419 |
def doctype(self): |
|
|
2558
81c8b5312f9c
move test on force-html-content-type to xhtml_browser method
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2555
diff
changeset
|
420 |
if self.req.xhtml_browser(): |
|
1421
77ee26df178f
doc type handling refactoring: do the ext substitution at the module level
sylvain.thenault@logilab.fr
parents:
1181
diff
changeset
|
421 |
return STRICT_DOCTYPE |
|
77ee26df178f
doc type handling refactoring: do the ext substitution at the module level
sylvain.thenault@logilab.fr
parents:
1181
diff
changeset
|
422 |
return STRICT_DOCTYPE_NOEXT |
| 0 | 423 |
|
| 1424 | 424 |
def set_stream(self, w=None): |
425 |
if self.w is not None: |
|
| 0 | 426 |
return |
427 |
if w is None: |
|
428 |
if self.binary: |
|
429 |
self._stream = stream = StringIO() |
|
430 |
else: |
|
431 |
self._stream = stream = HTMLStream(self.req) |
|
432 |
w = stream.write |
|
433 |
else: |
|
434 |
stream = None |
|
435 |
self.w = w |
|
436 |
return stream |
|
437 |
||
438 |
def write_doctype(self, xmldecl=True): |
|
439 |
assert isinstance(self._stream, HTMLStream) |
|
440 |
self._stream.doctype = self.doctype |
|
441 |
if not xmldecl: |
|
442 |
self._stream.xmldecl = u'' |
|
|
661
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
443 |
|
| 822 | 444 |
def linkable(self): |
445 |
return False |
|
| 1433 | 446 |
|
|
661
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
447 |
# concrete component base classes ############################################# |
|
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
448 |
|
|
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
449 |
class ReloadableMixIn(object): |
|
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
450 |
"""simple mixin for reloadable parts of UI""" |
| 1433 | 451 |
|
|
661
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
452 |
def user_callback(self, cb, args, msg=None, nonify=False): |
|
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
453 |
"""register the given user callback and return an url to call it ready to be |
|
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
454 |
inserted in html |
|
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
455 |
""" |
|
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
456 |
self.req.add_js('cubicweb.ajax.js') |
|
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
457 |
if nonify: |
|
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
458 |
_cb = cb |
|
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
459 |
def cb(*args): |
|
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
460 |
_cb(*args) |
|
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
461 |
cbname = self.req.register_onetime_callback(cb, *args) |
|
2312
af4d8f75c5db
use xml_escape
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2217
diff
changeset
|
462 |
return self.build_js(cbname, xml_escape(msg or '')) |
| 1433 | 463 |
|
|
661
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
464 |
def build_update_js_call(self, cbname, msg): |
|
2312
af4d8f75c5db
use xml_escape
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2217
diff
changeset
|
465 |
rql = xml_escape(self.rset.printable_rql()) |
|
661
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
466 |
return "javascript:userCallbackThenUpdateUI('%s', '%s', '%s', '%s', '%s', '%s')" % ( |
|
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
467 |
cbname, self.id, rql, msg, self.__registry__, self.div_id()) |
| 1433 | 468 |
|
|
661
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
469 |
def build_reload_js_call(self, cbname, msg): |
|
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
470 |
return "javascript:userCallbackThenReloadPage('%s', '%s')" % (cbname, msg) |
|
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
471 |
|
|
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
472 |
build_js = build_update_js_call # expect updatable component by default |
| 1433 | 473 |
|
|
661
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
474 |
def div_id(self): |
|
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
475 |
return '' |
|
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
476 |
|
|
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
477 |
|
|
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
478 |
class Component(ReloadableMixIn, View): |
|
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
479 |
"""base class for components""" |
|
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
480 |
__registry__ = 'components' |
| 707 | 481 |
__select__ = yes() |
|
1511
514e4e53a3c7
do not set visible property by default
sylvain.thenault@logilab.fr
parents:
1498
diff
changeset
|
482 |
property_defs = {} |
|
661
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
483 |
|
|
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
484 |
def div_class(self): |
|
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
485 |
return '%s %s' % (self.propval('htmlclass'), self.id) |
|
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
486 |
|
|
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
487 |
def div_id(self): |
|
4f61eb8a96b7
properly kill/depreciate component base class, only keep Component
sylvain.thenault@logilab.fr
parents:
660
diff
changeset
|
488 |
return '%sComponent' % self.id |