author | Sylvain Thénault <sylvain.thenault@logilab.fr> |
Fri, 07 Aug 2009 12:51:56 +0200 | |
changeset 2729 | d3dbd135f319 |
parent 2658 | 5535857eeaa5 |
child 2778 | 3f6dfc312760 |
child 2871 | 83c5499e1436 |
permissions | -rw-r--r-- |
0 | 1 |
"""Base class for entity objects manipulated in clients |
2 |
||
3 |
:organization: Logilab |
|
1977
606923dff11b
big bunch of copyright / docstring update
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
1904
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:
1904
diff
changeset
|
6 |
:license: GNU Lesser General Public License, v2.1 - http://www.gnu.org/licenses |
0 | 7 |
""" |
8 |
__docformat__ = "restructuredtext en" |
|
9 |
||
1154 | 10 |
from warnings import warn |
11 |
||
0 | 12 |
from logilab.common import interface |
13 |
from logilab.common.compat import all |
|
14 |
from logilab.common.decorators import cached |
|
2613
5e19c2bb370e
R [all] logilab.common 0.44 provides only deprecated
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
2421
diff
changeset
|
15 |
from logilab.common.deprecation import deprecated |
2312
af4d8f75c5db
use xml_escape
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2125
diff
changeset
|
16 |
from logilab.mtconverter import TransformData, TransformError, xml_escape |
631
99f5852f8604
major selector refactoring (mostly to avoid looking for select parameters on the target class), start accept / interface unification)
sylvain.thenault@logilab.fr
parents:
479
diff
changeset
|
17 |
|
0 | 18 |
from rql.utils import rqlvar_maker |
19 |
||
20 |
from cubicweb import Unauthorized |
|
21 |
from cubicweb.rset import ResultSet |
|
692
800592b8d39b
replace deprecated cubicweb.common.selectors by its new module path (cubicweb.selectors)
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
631
diff
changeset
|
22 |
from cubicweb.selectors import yes |
2656
a93ae0f6c0ad
R [base classes] only AppObject remaning, no more AppRsetObject
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2650
diff
changeset
|
23 |
from cubicweb.appobject import AppObject |
709 | 24 |
from cubicweb.schema import RQLVocabularyConstraint, RQLConstraint, bw_normalize_etype |
25 |
||
2421
08d42928fe36
does not make sense any more
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents:
2381
diff
changeset
|
26 |
from cubicweb.common.uilib import printable_value, soup2xhtml |
08d42928fe36
does not make sense any more
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents:
2381
diff
changeset
|
27 |
from cubicweb.common.mixins import MI_REL_TRIGGERS |
08d42928fe36
does not make sense any more
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents:
2381
diff
changeset
|
28 |
from cubicweb.common.mttransforms import ENGINE |
0 | 29 |
|
30 |
_marker = object() |
|
31 |
||
32 |
def greater_card(rschema, subjtypes, objtypes, index): |
|
33 |
for subjtype in subjtypes: |
|
34 |
for objtype in objtypes: |
|
35 |
card = rschema.rproperty(subjtype, objtype, 'cardinality')[index] |
|
36 |
if card in '+*': |
|
37 |
return card |
|
38 |
return '1' |
|
39 |
||
40 |
||
1498
2c6eec0b46b9
fix imports, cleanup, repair some ajax calls
sylvain.thenault@logilab.fr
parents:
1474
diff
changeset
|
41 |
_MODE_TAGS = set(('link', 'create')) |
2c6eec0b46b9
fix imports, cleanup, repair some ajax calls
sylvain.thenault@logilab.fr
parents:
1474
diff
changeset
|
42 |
_CATEGORY_TAGS = set(('primary', 'secondary', 'generic', 'generated')) # , 'metadata')) |
0 | 43 |
|
1154 | 44 |
try: |
1498
2c6eec0b46b9
fix imports, cleanup, repair some ajax calls
sylvain.thenault@logilab.fr
parents:
1474
diff
changeset
|
45 |
from cubicweb.web import formwidgets, uicfg |
0 | 46 |
|
1498
2c6eec0b46b9
fix imports, cleanup, repair some ajax calls
sylvain.thenault@logilab.fr
parents:
1474
diff
changeset
|
47 |
def _dispatch_rtags(tags, rtype, role, stype, otype): |
1154 | 48 |
for tag in tags: |
1498
2c6eec0b46b9
fix imports, cleanup, repair some ajax calls
sylvain.thenault@logilab.fr
parents:
1474
diff
changeset
|
49 |
if tag in _MODE_TAGS: |
1739 | 50 |
uicfg.actionbox_appearsin_addmenu.tag_relation( |
51 |
(stype, rtype, otype, role), tag == 'create') |
|
1498
2c6eec0b46b9
fix imports, cleanup, repair some ajax calls
sylvain.thenault@logilab.fr
parents:
1474
diff
changeset
|
52 |
elif tag in _CATEGORY_TAGS: |
1739 | 53 |
uicfg.autoform_section.tag_relation((stype, rtype, otype, role), |
54 |
tag) |
|
1177
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
55 |
elif tag == 'inlineview': |
1739 | 56 |
uicfg.autoform_is_inlined.tag_relation((stype, rtype, otype, role), True) |
1154 | 57 |
else: |
58 |
raise ValueError(tag) |
|
1471
c889c3bcf5ec
new parent_classes method (cached)
sylvain.thenault@logilab.fr
parents:
1435
diff
changeset
|
59 |
|
1154 | 60 |
except ImportError: |
1734
e8673144bc74
access to rwidgets through uicfg, removing buggy import breaking bw compat on the way
sylvain.thenault@logilab.fr
parents:
1721
diff
changeset
|
61 |
|
1498
2c6eec0b46b9
fix imports, cleanup, repair some ajax calls
sylvain.thenault@logilab.fr
parents:
1474
diff
changeset
|
62 |
_dispatch_rtags = None |
1177
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
63 |
|
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
64 |
def _get_etype(bases, classdict): |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
65 |
try: |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
66 |
return classdict['id'] |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
67 |
except KeyError: |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
68 |
for base in bases: |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
69 |
etype = getattr(base, 'id', None) |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
70 |
if etype and etype != 'Any': |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
71 |
return etype |
1474 | 72 |
|
1177
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
73 |
def _get_defs(attr, name, bases, classdict): |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
74 |
try: |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
75 |
yield name, classdict.pop(attr) |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
76 |
except KeyError: |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
77 |
for base in bases: |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
78 |
try: |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
79 |
value = getattr(base, attr) |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
80 |
delattr(base, attr) |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
81 |
yield base.__name__, value |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
82 |
except AttributeError: |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
83 |
continue |
1474 | 84 |
|
1498
2c6eec0b46b9
fix imports, cleanup, repair some ajax calls
sylvain.thenault@logilab.fr
parents:
1474
diff
changeset
|
85 |
class _metaentity(type): |
0 | 86 |
"""this metaclass sets the relation tags on the entity class |
87 |
and deals with the `widgets` attribute |
|
88 |
""" |
|
89 |
def __new__(mcs, name, bases, classdict): |
|
90 |
# collect baseclass' rtags |
|
1177
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
91 |
etype = _get_etype(bases, classdict) |
1498
2c6eec0b46b9
fix imports, cleanup, repair some ajax calls
sylvain.thenault@logilab.fr
parents:
1474
diff
changeset
|
92 |
if etype and _dispatch_rtags is not None: |
1177
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
93 |
for name, rtags in _get_defs('__rtags__', name, bases, classdict): |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
94 |
warn('%s: __rtags__ is deprecated' % name, DeprecationWarning) |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
95 |
for relation, tags in rtags.iteritems(): |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
96 |
# tags must become an iterable |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
97 |
if isinstance(tags, basestring): |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
98 |
tags = (tags,) |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
99 |
# relation must become a 3-uple (rtype, targettype, role) |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
100 |
if isinstance(relation, basestring): |
1498
2c6eec0b46b9
fix imports, cleanup, repair some ajax calls
sylvain.thenault@logilab.fr
parents:
1474
diff
changeset
|
101 |
_dispatch_rtags(tags, relation, 'subject', etype, '*') |
2c6eec0b46b9
fix imports, cleanup, repair some ajax calls
sylvain.thenault@logilab.fr
parents:
1474
diff
changeset
|
102 |
_dispatch_rtags(tags, relation, 'object', '*', etype) |
1177
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
103 |
elif len(relation) == 1: # useful ? |
1498
2c6eec0b46b9
fix imports, cleanup, repair some ajax calls
sylvain.thenault@logilab.fr
parents:
1474
diff
changeset
|
104 |
_dispatch_rtags(tags, relation[0], 'subject', etype, '*') |
2c6eec0b46b9
fix imports, cleanup, repair some ajax calls
sylvain.thenault@logilab.fr
parents:
1474
diff
changeset
|
105 |
_dispatch_rtags(tags, relation[0], 'object', '*', etype) |
1177
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
106 |
elif len(relation) == 2: |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
107 |
rtype, ttype = relation |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
108 |
ttype = bw_normalize_etype(ttype) # XXX bw compat |
1498
2c6eec0b46b9
fix imports, cleanup, repair some ajax calls
sylvain.thenault@logilab.fr
parents:
1474
diff
changeset
|
109 |
_dispatch_rtags(tags, rtype, 'subject', etype, ttype) |
2c6eec0b46b9
fix imports, cleanup, repair some ajax calls
sylvain.thenault@logilab.fr
parents:
1474
diff
changeset
|
110 |
_dispatch_rtags(tags, rtype, 'object', ttype, etype) |
1177
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
111 |
elif len(relation) == 3: |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
112 |
rtype, ttype, role = relation |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
113 |
ttype = bw_normalize_etype(ttype) |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
114 |
if role == 'subject': |
1498
2c6eec0b46b9
fix imports, cleanup, repair some ajax calls
sylvain.thenault@logilab.fr
parents:
1474
diff
changeset
|
115 |
_dispatch_rtags(tags, rtype, 'subject', etype, ttype) |
1177
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
116 |
else: |
1498
2c6eec0b46b9
fix imports, cleanup, repair some ajax calls
sylvain.thenault@logilab.fr
parents:
1474
diff
changeset
|
117 |
_dispatch_rtags(tags, rtype, 'object', ttype, etype) |
1154 | 118 |
else: |
1177
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
119 |
raise ValueError('bad rtag definition (%r)' % (relation,)) |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
120 |
for name, widgets in _get_defs('widgets', name, bases, classdict): |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
121 |
warn('%s: widgets is deprecated' % name, DeprecationWarning) |
7074698c6522
fix support for old __rtags__ and widgets
sylvain.thenault@logilab.fr
parents:
1154
diff
changeset
|
122 |
for rtype, wdgname in widgets.iteritems(): |
1804 | 123 |
if wdgname in ('URLWidget', 'EmbededURLWidget', 'RawDynamicComboBoxWidget'): |
1269 | 124 |
warn('%s widget is deprecated' % wdgname, DeprecationWarning) |
125 |
continue |
|
1313
9cff1eee0208
put class, not class name into rwidgets. New rfields rtags to specify a field for a relation
sylvain.thenault@logilab.fr
parents:
1269
diff
changeset
|
126 |
if wdgname == 'StringWidget': |
9cff1eee0208
put class, not class name into rwidgets. New rfields rtags to specify a field for a relation
sylvain.thenault@logilab.fr
parents:
1269
diff
changeset
|
127 |
wdgname = 'TextInput' |
9cff1eee0208
put class, not class name into rwidgets. New rfields rtags to specify a field for a relation
sylvain.thenault@logilab.fr
parents:
1269
diff
changeset
|
128 |
widget = getattr(formwidgets, wdgname) |
1582 | 129 |
assert hasattr(widget, 'render') |
1754
c9c7618a90de
autoform_widget superseeded by autoform_field_kwargs (api change addiction :-/)
sylvain.thenault@logilab.fr
parents:
1739
diff
changeset
|
130 |
uicfg.autoform_field_kwargs.tag_subject_of( |
c9c7618a90de
autoform_widget superseeded by autoform_field_kwargs (api change addiction :-/)
sylvain.thenault@logilab.fr
parents:
1739
diff
changeset
|
131 |
(etype, rtype, '*'), {'widget': widget}) |
1498
2c6eec0b46b9
fix imports, cleanup, repair some ajax calls
sylvain.thenault@logilab.fr
parents:
1474
diff
changeset
|
132 |
return super(_metaentity, mcs).__new__(mcs, name, bases, classdict) |
0 | 133 |
|
134 |
||
2656
a93ae0f6c0ad
R [base classes] only AppObject remaning, no more AppRsetObject
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2650
diff
changeset
|
135 |
class Entity(AppObject, dict): |
0 | 136 |
"""an entity instance has e_schema automagically set on |
137 |
the class and instances has access to their issuing cursor. |
|
1474 | 138 |
|
0 | 139 |
A property is set for each attribute and relation on each entity's type |
140 |
class. Becare that among attributes, 'eid' is *NEITHER* stored in the |
|
141 |
dict containment (which acts as a cache for other attributes dynamically |
|
142 |
fetched) |
|
143 |
||
144 |
:type e_schema: `cubicweb.schema.EntitySchema` |
|
145 |
:ivar e_schema: the entity's schema |
|
146 |
||
147 |
:type rest_var: str |
|
148 |
:cvar rest_var: indicates which attribute should be used to build REST urls |
|
149 |
If None is specified, the first non-meta attribute will |
|
150 |
be used |
|
1474 | 151 |
|
0 | 152 |
:type skip_copy_for: list |
153 |
:cvar skip_copy_for: a list of relations that should be skipped when copying |
|
154 |
this kind of entity. Note that some relations such |
|
155 |
as composite relations or relations that have '?1' as object |
|
156 |
cardinality |
|
157 |
""" |
|
1498
2c6eec0b46b9
fix imports, cleanup, repair some ajax calls
sylvain.thenault@logilab.fr
parents:
1474
diff
changeset
|
158 |
__metaclass__ = _metaentity |
0 | 159 |
__registry__ = 'etypes' |
717 | 160 |
__select__ = yes() |
1264
fe2934a7df7f
cleanup, avoid spurious warning
sylvain.thenault@logilab.fr
parents:
1177
diff
changeset
|
161 |
|
1474 | 162 |
# class attributes that must be set in class definition |
0 | 163 |
id = None |
164 |
rest_attr = None |
|
1138
22f634977c95
make pylint happy, fix some bugs on the way
sylvain.thenault@logilab.fr
parents:
1132
diff
changeset
|
165 |
fetch_attrs = None |
0 | 166 |
skip_copy_for = () |
1264
fe2934a7df7f
cleanup, avoid spurious warning
sylvain.thenault@logilab.fr
parents:
1177
diff
changeset
|
167 |
# class attributes set automatically at registration time |
fe2934a7df7f
cleanup, avoid spurious warning
sylvain.thenault@logilab.fr
parents:
1177
diff
changeset
|
168 |
e_schema = None |
1474 | 169 |
|
0 | 170 |
MODE_TAGS = set(('link', 'create')) |
171 |
CATEGORY_TAGS = set(('primary', 'secondary', 'generic', 'generated')) # , 'metadata')) |
|
172 |
@classmethod |
|
173 |
def __initialize__(cls): |
|
174 |
"""initialize a specific entity class by adding descriptors to access |
|
175 |
entity type's attributes and relations |
|
176 |
""" |
|
177 |
etype = cls.id |
|
178 |
assert etype != 'Any', etype |
|
179 |
cls.e_schema = eschema = cls.schema.eschema(etype) |
|
180 |
for rschema, _ in eschema.attribute_definitions(): |
|
181 |
if rschema.type == 'eid': |
|
182 |
continue |
|
183 |
setattr(cls, rschema.type, Attribute(rschema.type)) |
|
184 |
mixins = [] |
|
185 |
for rschema, _, x in eschema.relation_definitions(): |
|
186 |
if (rschema, x) in MI_REL_TRIGGERS: |
|
187 |
mixin = MI_REL_TRIGGERS[(rschema, x)] |
|
188 |
if not (issubclass(cls, mixin) or mixin in mixins): # already mixed ? |
|
189 |
mixins.append(mixin) |
|
190 |
for iface in getattr(mixin, '__implements__', ()): |
|
191 |
if not interface.implements(cls, iface): |
|
192 |
interface.extend(cls, iface) |
|
193 |
if x == 'subject': |
|
194 |
setattr(cls, rschema.type, SubjectRelation(rschema)) |
|
195 |
else: |
|
196 |
attr = 'reverse_%s' % rschema.type |
|
197 |
setattr(cls, attr, ObjectRelation(rschema)) |
|
198 |
if mixins: |
|
199 |
cls.__bases__ = tuple(mixins + [p for p in cls.__bases__ if not p is object]) |
|
200 |
cls.debug('plugged %s mixins on %s', mixins, etype) |
|
1474 | 201 |
|
0 | 202 |
@classmethod |
203 |
def fetch_rql(cls, user, restriction=None, fetchattrs=None, mainvar='X', |
|
204 |
settype=True, ordermethod='fetch_order'): |
|
205 |
"""return a rql to fetch all entities of the class type""" |
|
206 |
restrictions = restriction or [] |
|
207 |
if settype: |
|
208 |
restrictions.append('%s is %s' % (mainvar, cls.id)) |
|
209 |
if fetchattrs is None: |
|
210 |
fetchattrs = cls.fetch_attrs |
|
211 |
selection = [mainvar] |
|
212 |
orderby = [] |
|
213 |
# start from 26 to avoid possible conflicts with X |
|
214 |
varmaker = rqlvar_maker(index=26) |
|
215 |
cls._fetch_restrictions(mainvar, varmaker, fetchattrs, selection, |
|
216 |
orderby, restrictions, user, ordermethod) |
|
217 |
rql = 'Any %s' % ','.join(selection) |
|
218 |
if orderby: |
|
219 |
rql += ' ORDERBY %s' % ','.join(orderby) |
|
220 |
rql += ' WHERE %s' % ', '.join(restrictions) |
|
221 |
return rql |
|
1474 | 222 |
|
0 | 223 |
@classmethod |
224 |
def _fetch_restrictions(cls, mainvar, varmaker, fetchattrs, |
|
225 |
selection, orderby, restrictions, user, |
|
226 |
ordermethod='fetch_order', visited=None): |
|
227 |
eschema = cls.e_schema |
|
228 |
if visited is None: |
|
229 |
visited = set((eschema.type,)) |
|
230 |
elif eschema.type in visited: |
|
231 |
# avoid infinite recursion |
|
232 |
return |
|
233 |
else: |
|
234 |
visited.add(eschema.type) |
|
235 |
_fetchattrs = [] |
|
236 |
for attr in fetchattrs: |
|
237 |
try: |
|
238 |
rschema = eschema.subject_relation(attr) |
|
239 |
except KeyError: |
|
240 |
cls.warning('skipping fetch_attr %s defined in %s (not found in schema)', |
|
241 |
attr, cls.id) |
|
242 |
continue |
|
243 |
if not user.matching_groups(rschema.get_groups('read')): |
|
244 |
continue |
|
245 |
var = varmaker.next() |
|
246 |
selection.append(var) |
|
247 |
restriction = '%s %s %s' % (mainvar, attr, var) |
|
248 |
restrictions.append(restriction) |
|
249 |
if not rschema.is_final(): |
|
250 |
# XXX this does not handle several destination types |
|
251 |
desttype = rschema.objects(eschema.type)[0] |
|
252 |
card = rschema.rproperty(eschema, desttype, 'cardinality')[0] |
|
253 |
if card not in '?1': |
|
254 |
selection.pop() |
|
255 |
restrictions.pop() |
|
256 |
continue |
|
257 |
if card == '?': |
|
258 |
restrictions[-1] += '?' # left outer join if not mandatory |
|
2650
18aec79ec3a3
R [vreg] important refactoring of the vregistry, moving behaviour to end dictionnary (and so leaving room for more flexibility ; keep bw compat ; update api usage in cw
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2647
diff
changeset
|
259 |
destcls = cls.vreg['etypes'].etype_class(desttype) |
0 | 260 |
destcls._fetch_restrictions(var, varmaker, destcls.fetch_attrs, |
261 |
selection, orderby, restrictions, |
|
262 |
user, ordermethod, visited=visited) |
|
263 |
orderterm = getattr(cls, ordermethod)(attr, var) |
|
264 |
if orderterm: |
|
265 |
orderby.append(orderterm) |
|
266 |
return selection, orderby, restrictions |
|
267 |
||
1471
c889c3bcf5ec
new parent_classes method (cached)
sylvain.thenault@logilab.fr
parents:
1435
diff
changeset
|
268 |
@classmethod |
c889c3bcf5ec
new parent_classes method (cached)
sylvain.thenault@logilab.fr
parents:
1435
diff
changeset
|
269 |
@cached |
c889c3bcf5ec
new parent_classes method (cached)
sylvain.thenault@logilab.fr
parents:
1435
diff
changeset
|
270 |
def parent_classes(cls): |
2650
18aec79ec3a3
R [vreg] important refactoring of the vregistry, moving behaviour to end dictionnary (and so leaving room for more flexibility ; keep bw compat ; update api usage in cw
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2647
diff
changeset
|
271 |
parents = [cls.vreg['etypes'].etype_class(e.type) |
18aec79ec3a3
R [vreg] important refactoring of the vregistry, moving behaviour to end dictionnary (and so leaving room for more flexibility ; keep bw compat ; update api usage in cw
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2647
diff
changeset
|
272 |
for e in cls.e_schema.ancestors()] |
18aec79ec3a3
R [vreg] important refactoring of the vregistry, moving behaviour to end dictionnary (and so leaving room for more flexibility ; keep bw compat ; update api usage in cw
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2647
diff
changeset
|
273 |
parents.append(cls.vreg['etypes'].etype_class('Any')) |
1471
c889c3bcf5ec
new parent_classes method (cached)
sylvain.thenault@logilab.fr
parents:
1435
diff
changeset
|
274 |
return parents |
c889c3bcf5ec
new parent_classes method (cached)
sylvain.thenault@logilab.fr
parents:
1435
diff
changeset
|
275 |
|
1840
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
276 |
@classmethod |
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
277 |
@cached |
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
278 |
def _rest_attr_info(cls): |
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
279 |
mainattr, needcheck = 'eid', True |
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
280 |
if cls.rest_attr: |
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
281 |
mainattr = cls.rest_attr |
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
282 |
needcheck = not cls.e_schema.has_unique_values(mainattr) |
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
283 |
else: |
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
284 |
for rschema in cls.e_schema.subject_relations(): |
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
285 |
if rschema.is_final() and rschema != 'eid' and cls.e_schema.has_unique_values(rschema): |
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
286 |
mainattr = str(rschema) |
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
287 |
needcheck = False |
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
288 |
break |
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
289 |
if mainattr == 'eid': |
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
290 |
needcheck = False |
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
291 |
return mainattr, needcheck |
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
292 |
|
1435
6cd6172718bb
allow to instantiate an entity without rset
sylvain.thenault@logilab.fr
parents:
1363
diff
changeset
|
293 |
def __init__(self, req, rset=None, row=None, col=0): |
2656
a93ae0f6c0ad
R [base classes] only AppObject remaning, no more AppRsetObject
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2650
diff
changeset
|
294 |
AppObject.__init__(self, req, rset, row, col) |
0 | 295 |
dict.__init__(self) |
296 |
self._related_cache = {} |
|
297 |
if rset is not None: |
|
298 |
self.eid = rset[row][col] |
|
299 |
else: |
|
300 |
self.eid = None |
|
301 |
self._is_saved = True |
|
1474 | 302 |
|
0 | 303 |
def __repr__(self): |
304 |
return '<Entity %s %s %s at %s>' % ( |
|
305 |
self.e_schema, self.eid, self.keys(), id(self)) |
|
306 |
||
307 |
def __nonzero__(self): |
|
308 |
return True |
|
309 |
||
310 |
def __hash__(self): |
|
311 |
return id(self) |
|
312 |
||
313 |
def pre_add_hook(self): |
|
314 |
"""hook called by the repository before doing anything to add the entity |
|
315 |
(before_add entity hooks have not been called yet). This give the |
|
316 |
occasion to do weird stuff such as autocast (File -> Image for instance). |
|
1474 | 317 |
|
0 | 318 |
This method must return the actual entity to be added. |
319 |
""" |
|
320 |
return self |
|
1474 | 321 |
|
0 | 322 |
def set_eid(self, eid): |
323 |
self.eid = self['eid'] = eid |
|
324 |
||
325 |
def has_eid(self): |
|
326 |
"""return True if the entity has an attributed eid (False |
|
327 |
meaning that the entity has to be created |
|
328 |
""" |
|
329 |
try: |
|
330 |
int(self.eid) |
|
331 |
return True |
|
332 |
except (ValueError, TypeError): |
|
333 |
return False |
|
334 |
||
335 |
def is_saved(self): |
|
336 |
"""during entity creation, there is some time during which the entity |
|
337 |
has an eid attributed though it's not saved (eg during before_add_entity |
|
338 |
hooks). You can use this method to ensure the entity has an eid *and* is |
|
339 |
saved in its source. |
|
340 |
""" |
|
341 |
return self.has_eid() and self._is_saved |
|
1474 | 342 |
|
0 | 343 |
@cached |
344 |
def metainformation(self): |
|
345 |
res = dict(zip(('type', 'source', 'extid'), self.req.describe(self.eid))) |
|
346 |
res['source'] = self.req.source_defs()[res['source']] |
|
347 |
return res |
|
348 |
||
475
b32a5772ff06
should clear local perm cache if first attempt failed
sylvain.thenault@logilab.fr
parents:
413
diff
changeset
|
349 |
def clear_local_perm_cache(self, action): |
b32a5772ff06
should clear local perm cache if first attempt failed
sylvain.thenault@logilab.fr
parents:
413
diff
changeset
|
350 |
for rqlexpr in self.e_schema.get_rqlexprs(action): |
b32a5772ff06
should clear local perm cache if first attempt failed
sylvain.thenault@logilab.fr
parents:
413
diff
changeset
|
351 |
self.req.local_perm_cache.pop((rqlexpr.eid, (('x', self.eid),)), None) |
b32a5772ff06
should clear local perm cache if first attempt failed
sylvain.thenault@logilab.fr
parents:
413
diff
changeset
|
352 |
|
0 | 353 |
def check_perm(self, action): |
354 |
self.e_schema.check_perm(self.req, action, self.eid) |
|
355 |
||
356 |
def has_perm(self, action): |
|
357 |
return self.e_schema.has_perm(self.req, action, self.eid) |
|
1474 | 358 |
|
2650
18aec79ec3a3
R [vreg] important refactoring of the vregistry, moving behaviour to end dictionnary (and so leaving room for more flexibility ; keep bw compat ; update api usage in cw
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2647
diff
changeset
|
359 |
def view(self, vid, __registry='views', **kwargs): |
0 | 360 |
"""shortcut to apply a view on this entity""" |
2650
18aec79ec3a3
R [vreg] important refactoring of the vregistry, moving behaviour to end dictionnary (and so leaving room for more flexibility ; keep bw compat ; update api usage in cw
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2647
diff
changeset
|
361 |
return self.vreg[__registry].render(vid, self.req, rset=self.rset, |
18aec79ec3a3
R [vreg] important refactoring of the vregistry, moving behaviour to end dictionnary (and so leaving room for more flexibility ; keep bw compat ; update api usage in cw
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2647
diff
changeset
|
362 |
row=self.row, col=self.col, **kwargs) |
0 | 363 |
|
2059
af33833d7571
absolute_url / build_url refactoring to avoid potential name clash
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2058
diff
changeset
|
364 |
def absolute_url(self, *args, **kwargs): |
0 | 365 |
"""return an absolute url to view this entity""" |
2059
af33833d7571
absolute_url / build_url refactoring to avoid potential name clash
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2058
diff
changeset
|
366 |
# use *args since we don't want first argument to be "anonymous" to |
af33833d7571
absolute_url / build_url refactoring to avoid potential name clash
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2058
diff
changeset
|
367 |
# avoid potential clash with kwargs |
af33833d7571
absolute_url / build_url refactoring to avoid potential name clash
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2058
diff
changeset
|
368 |
if args: |
af33833d7571
absolute_url / build_url refactoring to avoid potential name clash
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2058
diff
changeset
|
369 |
assert len(args) == 1, 'only 0 or 1 non-named-argument expected' |
af33833d7571
absolute_url / build_url refactoring to avoid potential name clash
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2058
diff
changeset
|
370 |
method = args[0] |
af33833d7571
absolute_url / build_url refactoring to avoid potential name clash
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2058
diff
changeset
|
371 |
else: |
af33833d7571
absolute_url / build_url refactoring to avoid potential name clash
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2058
diff
changeset
|
372 |
method = None |
0 | 373 |
# in linksearch mode, we don't want external urls else selecting |
374 |
# the object for use in the relation is tricky |
|
375 |
# XXX search_state is web specific |
|
376 |
if getattr(self.req, 'search_state', ('normal',))[0] == 'normal': |
|
377 |
kwargs['base_url'] = self.metainformation()['source'].get('base-url') |
|
1904
e23536d29231
minor refactoring of absolute_url()
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
1842
diff
changeset
|
378 |
if method in (None, 'view'): |
1842
c7a22540d6f7
add some bw compat code for old rest_path prototype
sylvain.thenault@logilab.fr
parents:
1840
diff
changeset
|
379 |
try: |
c7a22540d6f7
add some bw compat code for old rest_path prototype
sylvain.thenault@logilab.fr
parents:
1840
diff
changeset
|
380 |
kwargs['_restpath'] = self.rest_path(kwargs.get('base_url')) |
c7a22540d6f7
add some bw compat code for old rest_path prototype
sylvain.thenault@logilab.fr
parents:
1840
diff
changeset
|
381 |
except TypeError: |
c7a22540d6f7
add some bw compat code for old rest_path prototype
sylvain.thenault@logilab.fr
parents:
1840
diff
changeset
|
382 |
warn('%s: rest_path() now take use_ext_eid argument, ' |
c7a22540d6f7
add some bw compat code for old rest_path prototype
sylvain.thenault@logilab.fr
parents:
1840
diff
changeset
|
383 |
'please update' % self.id, DeprecationWarning) |
c7a22540d6f7
add some bw compat code for old rest_path prototype
sylvain.thenault@logilab.fr
parents:
1840
diff
changeset
|
384 |
kwargs['_restpath'] = self.rest_path() |
0 | 385 |
else: |
386 |
kwargs['rql'] = 'Any X WHERE X eid %s' % self.eid |
|
387 |
return self.build_url(method, **kwargs) |
|
388 |
||
1840
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
389 |
def rest_path(self, use_ext_eid=False): |
0 | 390 |
"""returns a REST-like (relative) path for this entity""" |
391 |
mainattr, needcheck = self._rest_attr_info() |
|
392 |
etype = str(self.e_schema) |
|
1840
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
393 |
path = etype.lower() |
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
394 |
if mainattr != 'eid': |
0 | 395 |
value = getattr(self, mainattr) |
2125
19861294506f
https://www.logilab.net/cwo/ticket/343724
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2005
diff
changeset
|
396 |
if value is None or unicode(value) == u'': |
1840
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
397 |
mainattr = 'eid' |
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
398 |
path += '/eid' |
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
399 |
elif needcheck: |
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
400 |
# make sure url is not ambiguous |
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
401 |
rql = 'Any COUNT(X) WHERE X is %s, X %s %%(value)s' % ( |
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
402 |
etype, mainattr) |
1904
e23536d29231
minor refactoring of absolute_url()
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
1842
diff
changeset
|
403 |
nbresults = self.req.execute(rql, {'value' : value})[0][0] |
e23536d29231
minor refactoring of absolute_url()
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
1842
diff
changeset
|
404 |
if nbresults != 1: # ambiguity? |
e23536d29231
minor refactoring of absolute_url()
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
1842
diff
changeset
|
405 |
mainattr = 'eid' |
e23536d29231
minor refactoring of absolute_url()
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
1842
diff
changeset
|
406 |
path += '/eid' |
0 | 407 |
if mainattr == 'eid': |
1840
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
408 |
if use_ext_eid: |
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
409 |
value = self.metainformation()['extid'] |
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
410 |
else: |
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
411 |
value = self.eid |
f4b5c15d1147
test and fix #342997: local eid used for absolute_url of external entities
sylvain.thenault@logilab.fr
parents:
1804
diff
changeset
|
412 |
return '%s/%s' % (path, self.req.url_quote(value)) |
0 | 413 |
|
1360
13ae1121835e
rename attribute_metadata method to attr_metadata to save a few chars
sylvain.thenault@logilab.fr
parents:
1313
diff
changeset
|
414 |
def attr_metadata(self, attr, metadata): |
1101
0c067de38e46
unification of meta-attributes handling:
sylvain.thenault@logilab.fr
parents:
1098
diff
changeset
|
415 |
"""return a metadata for an attribute (None if unspecified)""" |
0c067de38e46
unification of meta-attributes handling:
sylvain.thenault@logilab.fr
parents:
1098
diff
changeset
|
416 |
value = getattr(self, '%s_%s' % (attr, metadata), None) |
0c067de38e46
unification of meta-attributes handling:
sylvain.thenault@logilab.fr
parents:
1098
diff
changeset
|
417 |
if value is None and metadata == 'encoding': |
0c067de38e46
unification of meta-attributes handling:
sylvain.thenault@logilab.fr
parents:
1098
diff
changeset
|
418 |
value = self.vreg.property_value('ui.encoding') |
0c067de38e46
unification of meta-attributes handling:
sylvain.thenault@logilab.fr
parents:
1098
diff
changeset
|
419 |
return value |
0 | 420 |
|
421 |
def printable_value(self, attr, value=_marker, attrtype=None, |
|
422 |
format='text/html', displaytime=True): |
|
423 |
"""return a displayable value (i.e. unicode string) which may contains |
|
424 |
html tags |
|
425 |
""" |
|
426 |
attr = str(attr) |
|
427 |
if value is _marker: |
|
428 |
value = getattr(self, attr) |
|
429 |
if isinstance(value, basestring): |
|
430 |
value = value.strip() |
|
431 |
if value is None or value == '': # don't use "not", 0 is an acceptable value |
|
432 |
return u'' |
|
433 |
if attrtype is None: |
|
434 |
attrtype = self.e_schema.destination(attr) |
|
435 |
props = self.e_schema.rproperties(attr) |
|
436 |
if attrtype == 'String': |
|
437 |
# internalinalized *and* formatted string such as schema |
|
438 |
# description... |
|
439 |
if props.get('internationalizable'): |
|
440 |
value = self.req._(value) |
|
1360
13ae1121835e
rename attribute_metadata method to attr_metadata to save a few chars
sylvain.thenault@logilab.fr
parents:
1313
diff
changeset
|
441 |
attrformat = self.attr_metadata(attr, 'format') |
0 | 442 |
if attrformat: |
443 |
return self.mtc_transform(value, attrformat, format, |
|
444 |
self.req.encoding) |
|
445 |
elif attrtype == 'Bytes': |
|
1360
13ae1121835e
rename attribute_metadata method to attr_metadata to save a few chars
sylvain.thenault@logilab.fr
parents:
1313
diff
changeset
|
446 |
attrformat = self.attr_metadata(attr, 'format') |
0 | 447 |
if attrformat: |
1360
13ae1121835e
rename attribute_metadata method to attr_metadata to save a few chars
sylvain.thenault@logilab.fr
parents:
1313
diff
changeset
|
448 |
encoding = self.attr_metadata(attr, 'encoding') |
0 | 449 |
return self.mtc_transform(value.getvalue(), attrformat, format, |
450 |
encoding) |
|
451 |
return u'' |
|
452 |
value = printable_value(self.req, attrtype, value, props, displaytime) |
|
453 |
if format == 'text/html': |
|
2312
af4d8f75c5db
use xml_escape
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2125
diff
changeset
|
454 |
value = xml_escape(value) |
0 | 455 |
return value |
456 |
||
457 |
def mtc_transform(self, data, format, target_format, encoding, |
|
458 |
_engine=ENGINE): |
|
459 |
trdata = TransformData(data, format, encoding, appobject=self) |
|
460 |
data = _engine.convert(trdata, target_format).decode() |
|
461 |
if format == 'text/html': |
|
1474 | 462 |
data = soup2xhtml(data, self.req.encoding) |
0 | 463 |
return data |
1474 | 464 |
|
0 | 465 |
# entity cloning ########################################################## |
466 |
||
467 |
def copy_relations(self, ceid): |
|
468 |
"""copy relations of the object with the given eid on this object |
|
469 |
||
470 |
By default meta and composite relations are skipped. |
|
471 |
Overrides this if you want another behaviour |
|
472 |
""" |
|
473 |
assert self.has_eid() |
|
474 |
execute = self.req.execute |
|
475 |
for rschema in self.e_schema.subject_relations(): |
|
2126
a25859917ccc
stop using meta attribute from yams schema. Use instead sets defining meta relations and another defining schema types. Refactor various schema view based on this
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2059
diff
changeset
|
476 |
if rschema.is_final() or rschema.meta: |
0 | 477 |
continue |
478 |
# skip already defined relations |
|
479 |
if getattr(self, rschema.type): |
|
480 |
continue |
|
481 |
if rschema.type in self.skip_copy_for: |
|
482 |
continue |
|
483 |
if rschema.type == 'in_state': |
|
484 |
# if the workflow is defining an initial state (XXX AND we are |
|
485 |
# not in the managers group? not done to be more consistent) |
|
486 |
# don't try to copy in_state |
|
487 |
if execute('Any S WHERE S state_of ET, ET initial_state S,' |
|
488 |
'ET name %(etype)s', {'etype': str(self.e_schema)}): |
|
489 |
continue |
|
490 |
# skip composite relation |
|
491 |
if self.e_schema.subjrproperty(rschema, 'composite'): |
|
492 |
continue |
|
493 |
# skip relation with card in ?1 else we either change the copied |
|
494 |
# object (inlined relation) or inserting some inconsistency |
|
495 |
if self.e_schema.subjrproperty(rschema, 'cardinality')[1] in '?1': |
|
496 |
continue |
|
497 |
rql = 'SET X %s V WHERE X eid %%(x)s, Y eid %%(y)s, Y %s V' % ( |
|
498 |
rschema.type, rschema.type) |
|
499 |
execute(rql, {'x': self.eid, 'y': ceid}, ('x', 'y')) |
|
500 |
self.clear_related_cache(rschema.type, 'subject') |
|
501 |
for rschema in self.e_schema.object_relations(): |
|
502 |
if rschema.meta: |
|
503 |
continue |
|
504 |
# skip already defined relations |
|
505 |
if getattr(self, 'reverse_%s' % rschema.type): |
|
506 |
continue |
|
507 |
# skip composite relation |
|
508 |
if self.e_schema.objrproperty(rschema, 'composite'): |
|
509 |
continue |
|
510 |
# skip relation with card in ?1 else we either change the copied |
|
511 |
# object (inlined relation) or inserting some inconsistency |
|
512 |
if self.e_schema.objrproperty(rschema, 'cardinality')[0] in '?1': |
|
513 |
continue |
|
514 |
rql = 'SET V %s X WHERE X eid %%(x)s, Y eid %%(y)s, V %s Y' % ( |
|
515 |
rschema.type, rschema.type) |
|
516 |
execute(rql, {'x': self.eid, 'y': ceid}, ('x', 'y')) |
|
517 |
self.clear_related_cache(rschema.type, 'object') |
|
518 |
||
519 |
# data fetching methods ################################################### |
|
520 |
||
521 |
@cached |
|
522 |
def as_rset(self): |
|
523 |
"""returns a resultset containing `self` information""" |
|
524 |
rset = ResultSet([(self.eid,)], 'Any X WHERE X eid %(x)s', |
|
525 |
{'x': self.eid}, [(self.id,)]) |
|
526 |
return self.req.decorate_rset(rset) |
|
1474 | 527 |
|
0 | 528 |
def to_complete_relations(self): |
529 |
"""by default complete final relations to when calling .complete()""" |
|
530 |
for rschema in self.e_schema.subject_relations(): |
|
531 |
if rschema.is_final(): |
|
532 |
continue |
|
533 |
if len(rschema.objects(self.e_schema)) > 1: |
|
534 |
# ambigous relations, the querier doesn't handle |
|
535 |
# outer join correctly in this case |
|
536 |
continue |
|
537 |
if rschema.inlined: |
|
538 |
matching_groups = self.req.user.matching_groups |
|
539 |
if matching_groups(rschema.get_groups('read')) and \ |
|
540 |
all(matching_groups(es.get_groups('read')) |
|
541 |
for es in rschema.objects(self.e_schema)): |
|
542 |
yield rschema, 'subject' |
|
1474 | 543 |
|
0 | 544 |
def to_complete_attributes(self, skip_bytes=True): |
545 |
for rschema, attrschema in self.e_schema.attribute_definitions(): |
|
546 |
# skip binary data by default |
|
547 |
if skip_bytes and attrschema.type == 'Bytes': |
|
548 |
continue |
|
549 |
attr = rschema.type |
|
550 |
if attr == 'eid': |
|
551 |
continue |
|
552 |
# password retreival is blocked at the repository server level |
|
553 |
if not self.req.user.matching_groups(rschema.get_groups('read')) \ |
|
554 |
or attrschema.type == 'Password': |
|
555 |
self[attr] = None |
|
556 |
continue |
|
557 |
yield attr |
|
1474 | 558 |
|
0 | 559 |
def complete(self, attributes=None, skip_bytes=True): |
560 |
"""complete this entity by adding missing attributes (i.e. query the |
|
561 |
repository to fill the entity) |
|
562 |
||
563 |
:type skip_bytes: bool |
|
564 |
:param skip_bytes: |
|
565 |
if true, attribute of type Bytes won't be considered |
|
566 |
""" |
|
567 |
assert self.has_eid() |
|
568 |
varmaker = rqlvar_maker() |
|
569 |
V = varmaker.next() |
|
570 |
rql = ['WHERE %s eid %%(x)s' % V] |
|
571 |
selected = [] |
|
572 |
for attr in (attributes or self.to_complete_attributes(skip_bytes)): |
|
573 |
# if attribute already in entity, nothing to do |
|
574 |
if self.has_key(attr): |
|
575 |
continue |
|
576 |
# case where attribute must be completed, but is not yet in entity |
|
577 |
var = varmaker.next() |
|
578 |
rql.append('%s %s %s' % (V, attr, var)) |
|
579 |
selected.append((attr, var)) |
|
580 |
# +1 since this doen't include the main variable |
|
581 |
lastattr = len(selected) + 1 |
|
582 |
if attributes is None: |
|
583 |
# fetch additional relations (restricted to 0..1 relations) |
|
584 |
for rschema, role in self.to_complete_relations(): |
|
585 |
rtype = rschema.type |
|
586 |
if self.relation_cached(rtype, role): |
|
587 |
continue |
|
588 |
var = varmaker.next() |
|
589 |
if role == 'subject': |
|
590 |
targettype = rschema.objects(self.e_schema)[0] |
|
591 |
card = rschema.rproperty(self.e_schema, targettype, |
|
592 |
'cardinality')[0] |
|
593 |
if card == '1': |
|
594 |
rql.append('%s %s %s' % (V, rtype, var)) |
|
595 |
else: # '?" |
|
596 |
rql.append('%s %s %s?' % (V, rtype, var)) |
|
597 |
else: |
|
598 |
targettype = rschema.subjects(self.e_schema)[1] |
|
599 |
card = rschema.rproperty(self.e_schema, targettype, |
|
600 |
'cardinality')[1] |
|
601 |
if card == '1': |
|
602 |
rql.append('%s %s %s' % (var, rtype, V)) |
|
603 |
else: # '?" |
|
604 |
rql.append('%s? %s %s' % (var, rtype, V)) |
|
605 |
assert card in '1?', '%s %s %s %s' % (self.e_schema, rtype, |
|
606 |
role, card) |
|
607 |
selected.append(((rtype, role), var)) |
|
608 |
if selected: |
|
609 |
# select V, we need it as the left most selected variable |
|
610 |
# if some outer join are included to fetch inlined relations |
|
611 |
rql = 'Any %s,%s %s' % (V, ','.join(var for attr, var in selected), |
|
612 |
','.join(rql)) |
|
613 |
execute = getattr(self.req, 'unsafe_execute', self.req.execute) |
|
614 |
rset = execute(rql, {'x': self.eid}, 'x', build_descr=False)[0] |
|
615 |
# handle attributes |
|
616 |
for i in xrange(1, lastattr): |
|
617 |
self[str(selected[i-1][0])] = rset[i] |
|
618 |
# handle relations |
|
619 |
for i in xrange(lastattr, len(rset)): |
|
620 |
rtype, x = selected[i-1][0] |
|
621 |
value = rset[i] |
|
622 |
if value is None: |
|
623 |
rrset = ResultSet([], rql, {'x': self.eid}) |
|
624 |
self.req.decorate_rset(rrset) |
|
625 |
else: |
|
626 |
rrset = self.req.eid_rset(value) |
|
627 |
self.set_related_cache(rtype, x, rrset) |
|
1474 | 628 |
|
0 | 629 |
def get_value(self, name): |
630 |
"""get value for the attribute relation <name>, query the repository |
|
631 |
to get the value if necessary. |
|
632 |
||
633 |
:type name: str |
|
634 |
:param name: name of the attribute to get |
|
635 |
""" |
|
636 |
try: |
|
637 |
value = self[name] |
|
638 |
except KeyError: |
|
639 |
if not self.is_saved(): |
|
640 |
return None |
|
641 |
rql = "Any A WHERE X eid %%(x)s, X %s A" % name |
|
2647
b0a2e779845c
enable server side entity caching, 25% speedup on codenaf insertion. ALL CW TESTS OK
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2613
diff
changeset
|
642 |
# XXX should we really use unsafe_execute here? I think so (syt), |
b0a2e779845c
enable server side entity caching, 25% speedup on codenaf insertion. ALL CW TESTS OK
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2613
diff
changeset
|
643 |
# see #344874 |
0 | 644 |
execute = getattr(self.req, 'unsafe_execute', self.req.execute) |
645 |
try: |
|
646 |
rset = execute(rql, {'x': self.eid}, 'x') |
|
647 |
except Unauthorized: |
|
648 |
self[name] = value = None |
|
649 |
else: |
|
650 |
assert rset.rowcount <= 1, (self, rql, rset.rowcount) |
|
651 |
try: |
|
652 |
self[name] = value = rset.rows[0][0] |
|
653 |
except IndexError: |
|
654 |
# probably a multisource error |
|
655 |
self.critical("can't get value for attribute %s of entity with eid %s", |
|
656 |
name, self.eid) |
|
657 |
if self.e_schema.destination(name) == 'String': |
|
2320 | 658 |
# XXX (syt) imo emtpy string is better |
0 | 659 |
self[name] = value = self.req._('unaccessible') |
660 |
else: |
|
661 |
self[name] = value = None |
|
662 |
return value |
|
663 |
||
664 |
def related(self, rtype, role='subject', limit=None, entities=False): |
|
665 |
"""returns a resultset of related entities |
|
1474 | 666 |
|
0 | 667 |
:param role: is the role played by 'self' in the relation ('subject' or 'object') |
668 |
:param limit: resultset's maximum size |
|
669 |
:param entities: if True, the entites are returned; if False, a result set is returned |
|
670 |
""" |
|
671 |
try: |
|
672 |
return self.related_cache(rtype, role, entities, limit) |
|
673 |
except KeyError: |
|
674 |
pass |
|
675 |
assert self.has_eid() |
|
676 |
rql = self.related_rql(rtype, role) |
|
2647
b0a2e779845c
enable server side entity caching, 25% speedup on codenaf insertion. ALL CW TESTS OK
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2613
diff
changeset
|
677 |
# XXX should we really use unsafe_execute here? I think so (syt), |
b0a2e779845c
enable server side entity caching, 25% speedup on codenaf insertion. ALL CW TESTS OK
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2613
diff
changeset
|
678 |
# see #344874 |
b0a2e779845c
enable server side entity caching, 25% speedup on codenaf insertion. ALL CW TESTS OK
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2613
diff
changeset
|
679 |
execute = getattr(self.req, 'unsafe_execute', self.req.execute) |
b0a2e779845c
enable server side entity caching, 25% speedup on codenaf insertion. ALL CW TESTS OK
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2613
diff
changeset
|
680 |
rset = execute(rql, {'x': self.eid}, 'x') |
0 | 681 |
self.set_related_cache(rtype, role, rset) |
682 |
return self.related(rtype, role, limit, entities) |
|
683 |
||
684 |
def related_rql(self, rtype, role='subject'): |
|
685 |
rschema = self.schema[rtype] |
|
686 |
if role == 'subject': |
|
687 |
targettypes = rschema.objects(self.e_schema) |
|
688 |
restriction = 'E eid %%(x)s, E %s X' % rtype |
|
689 |
card = greater_card(rschema, (self.e_schema,), targettypes, 0) |
|
690 |
else: |
|
691 |
targettypes = rschema.subjects(self.e_schema) |
|
692 |
restriction = 'E eid %%(x)s, X %s E' % rtype |
|
693 |
card = greater_card(rschema, targettypes, (self.e_schema,), 1) |
|
694 |
if len(targettypes) > 1: |
|
413
a7366dd3c33c
fix bug in entity.related_rql(): fetch_attr list / fetchorder weren't computed correctly
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
397
diff
changeset
|
695 |
fetchattrs_list = [] |
0 | 696 |
for ttype in targettypes: |
2650
18aec79ec3a3
R [vreg] important refactoring of the vregistry, moving behaviour to end dictionnary (and so leaving room for more flexibility ; keep bw compat ; update api usage in cw
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2647
diff
changeset
|
697 |
etypecls = self.vreg['etypes'].etype_class(ttype) |
413
a7366dd3c33c
fix bug in entity.related_rql(): fetch_attr list / fetchorder weren't computed correctly
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
397
diff
changeset
|
698 |
fetchattrs_list.append(set(etypecls.fetch_attrs)) |
a7366dd3c33c
fix bug in entity.related_rql(): fetch_attr list / fetchorder weren't computed correctly
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
397
diff
changeset
|
699 |
fetchattrs = reduce(set.intersection, fetchattrs_list) |
0 | 700 |
rql = etypecls.fetch_rql(self.req.user, [restriction], fetchattrs, |
701 |
settype=False) |
|
702 |
else: |
|
2650
18aec79ec3a3
R [vreg] important refactoring of the vregistry, moving behaviour to end dictionnary (and so leaving room for more flexibility ; keep bw compat ; update api usage in cw
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2647
diff
changeset
|
703 |
etypecls = self.vreg['etypes'].etype_class(targettypes[0]) |
0 | 704 |
rql = etypecls.fetch_rql(self.req.user, [restriction], settype=False) |
705 |
# optimisation: remove ORDERBY if cardinality is 1 or ? (though |
|
706 |
# greater_card return 1 for those both cases) |
|
707 |
if card == '1': |
|
708 |
if ' ORDERBY ' in rql: |
|
709 |
rql = '%s WHERE %s' % (rql.split(' ORDERBY ', 1)[0], |
|
710 |
rql.split(' WHERE ', 1)[1]) |
|
711 |
elif not ' ORDERBY ' in rql: |
|
712 |
args = tuple(rql.split(' WHERE ', 1)) |
|
713 |
rql = '%s ORDERBY Z DESC WHERE X modification_date Z, %s' % args |
|
714 |
return rql |
|
1474 | 715 |
|
0 | 716 |
# generic vocabulary methods ############################################## |
717 |
||
2613
5e19c2bb370e
R [all] logilab.common 0.44 provides only deprecated
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
2421
diff
changeset
|
718 |
@deprecated('see new form api') |
0 | 719 |
def vocabulary(self, rtype, role='subject', limit=None): |
720 |
"""vocabulary functions must return a list of couples |
|
721 |
(label, eid) that will typically be used to fill the |
|
722 |
edition view's combobox. |
|
1474 | 723 |
|
0 | 724 |
If `eid` is None in one of these couples, it should be |
725 |
interpreted as a separator in case vocabulary results are grouped |
|
726 |
""" |
|
1008
f54b4309a3f5
bw compat for vocabulary using new form
sylvain.thenault@logilab.fr
parents:
985
diff
changeset
|
727 |
from logilab.common.testlib import mock_object |
2058
7ef12c03447c
nicer vreg api, try to make rset an optional named argument in select and derivated (including selectors)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2005
diff
changeset
|
728 |
form = self.vreg.select('forms', 'edition', self.req, entity=self) |
1008
f54b4309a3f5
bw compat for vocabulary using new form
sylvain.thenault@logilab.fr
parents:
985
diff
changeset
|
729 |
field = mock_object(name=rtype, role=role) |
1031
1a89683cb687
restore limit on form_field_vocabulary, actually used
sylvain.thenault@logilab.fr
parents:
1008
diff
changeset
|
730 |
return form.form_field_vocabulary(field, limit) |
1474 | 731 |
|
0 | 732 |
def unrelated_rql(self, rtype, targettype, role, ordermethod=None, |
733 |
vocabconstraints=True): |
|
734 |
"""build a rql to fetch `targettype` entities unrelated to this entity |
|
735 |
using (rtype, role) relation |
|
736 |
""" |
|
737 |
ordermethod = ordermethod or 'fetch_unrelated_order' |
|
738 |
if isinstance(rtype, basestring): |
|
739 |
rtype = self.schema.rschema(rtype) |
|
740 |
if role == 'subject': |
|
741 |
evar, searchedvar = 'S', 'O' |
|
742 |
subjtype, objtype = self.e_schema, targettype |
|
743 |
else: |
|
744 |
searchedvar, evar = 'S', 'O' |
|
745 |
objtype, subjtype = self.e_schema, targettype |
|
746 |
if self.has_eid(): |
|
747 |
restriction = ['NOT S %s O' % rtype, '%s eid %%(x)s' % evar] |
|
748 |
else: |
|
749 |
restriction = [] |
|
750 |
constraints = rtype.rproperty(subjtype, objtype, 'constraints') |
|
751 |
if vocabconstraints: |
|
752 |
# RQLConstraint is a subclass for RQLVocabularyConstraint, so they |
|
753 |
# will be included as well |
|
754 |
restriction += [cstr.restriction for cstr in constraints |
|
755 |
if isinstance(cstr, RQLVocabularyConstraint)] |
|
756 |
else: |
|
757 |
restriction += [cstr.restriction for cstr in constraints |
|
758 |
if isinstance(cstr, RQLConstraint)] |
|
2650
18aec79ec3a3
R [vreg] important refactoring of the vregistry, moving behaviour to end dictionnary (and so leaving room for more flexibility ; keep bw compat ; update api usage in cw
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2647
diff
changeset
|
759 |
etypecls = self.vreg['etypes'].etype_class(targettype) |
0 | 760 |
rql = etypecls.fetch_rql(self.req.user, restriction, |
761 |
mainvar=searchedvar, ordermethod=ordermethod) |
|
762 |
# ensure we have an order defined |
|
763 |
if not ' ORDERBY ' in rql: |
|
764 |
before, after = rql.split(' WHERE ', 1) |
|
765 |
rql = '%s ORDERBY %s WHERE %s' % (before, searchedvar, after) |
|
766 |
return rql |
|
1474 | 767 |
|
0 | 768 |
def unrelated(self, rtype, targettype, role='subject', limit=None, |
769 |
ordermethod=None): |
|
770 |
"""return a result set of target type objects that may be related |
|
771 |
by a given relation, with self as subject or object |
|
772 |
""" |
|
773 |
rql = self.unrelated_rql(rtype, targettype, role, ordermethod) |
|
774 |
if limit is not None: |
|
775 |
before, after = rql.split(' WHERE ', 1) |
|
776 |
rql = '%s LIMIT %s WHERE %s' % (before, limit, after) |
|
777 |
if self.has_eid(): |
|
778 |
return self.req.execute(rql, {'x': self.eid}) |
|
779 |
return self.req.execute(rql) |
|
1474 | 780 |
|
0 | 781 |
# relations cache handling ################################################ |
1474 | 782 |
|
0 | 783 |
def relation_cached(self, rtype, role): |
784 |
"""return true if the given relation is already cached on the instance |
|
785 |
""" |
|
2647
b0a2e779845c
enable server side entity caching, 25% speedup on codenaf insertion. ALL CW TESTS OK
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2613
diff
changeset
|
786 |
return self._related_cache.get('%s_%s' % (rtype, role)) |
1474 | 787 |
|
0 | 788 |
def related_cache(self, rtype, role, entities=True, limit=None): |
789 |
"""return values for the given relation if it's cached on the instance, |
|
790 |
else raise `KeyError` |
|
791 |
""" |
|
792 |
res = self._related_cache['%s_%s' % (rtype, role)][entities] |
|
793 |
if limit: |
|
794 |
if entities: |
|
795 |
res = res[:limit] |
|
796 |
else: |
|
797 |
res = res.limit(limit) |
|
798 |
return res |
|
1474 | 799 |
|
0 | 800 |
def set_related_cache(self, rtype, role, rset, col=0): |
801 |
"""set cached values for the given relation""" |
|
802 |
if rset: |
|
803 |
related = list(rset.entities(col)) |
|
804 |
rschema = self.schema.rschema(rtype) |
|
805 |
if role == 'subject': |
|
806 |
rcard = rschema.rproperty(self.e_schema, related[0].e_schema, |
|
807 |
'cardinality')[1] |
|
808 |
target = 'object' |
|
809 |
else: |
|
810 |
rcard = rschema.rproperty(related[0].e_schema, self.e_schema, |
|
811 |
'cardinality')[0] |
|
812 |
target = 'subject' |
|
813 |
if rcard in '?1': |
|
814 |
for rentity in related: |
|
815 |
rentity._related_cache['%s_%s' % (rtype, target)] = (self.as_rset(), [self]) |
|
816 |
else: |
|
817 |
related = [] |
|
818 |
self._related_cache['%s_%s' % (rtype, role)] = (rset, related) |
|
1474 | 819 |
|
0 | 820 |
def clear_related_cache(self, rtype=None, role=None): |
821 |
"""clear cached values for the given relation or the entire cache if |
|
822 |
no relation is given |
|
823 |
""" |
|
824 |
if rtype is None: |
|
825 |
self._related_cache = {} |
|
826 |
else: |
|
827 |
assert role |
|
828 |
self._related_cache.pop('%s_%s' % (rtype, role), None) |
|
1474 | 829 |
|
0 | 830 |
# raw edition utilities ################################################### |
1474 | 831 |
|
0 | 832 |
def set_attributes(self, **kwargs): |
833 |
assert kwargs |
|
834 |
relations = [] |
|
835 |
for key in kwargs: |
|
836 |
relations.append('X %s %%(%s)s' % (key, key)) |
|
397
cf577e26f924
don't introduce a spurious 'x' key in the entity-as dict
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents:
237
diff
changeset
|
837 |
# update current local object |
cf577e26f924
don't introduce a spurious 'x' key in the entity-as dict
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents:
237
diff
changeset
|
838 |
self.update(kwargs) |
cf577e26f924
don't introduce a spurious 'x' key in the entity-as dict
Aurelien Campeas <aurelien.campeas@logilab.fr>
parents:
237
diff
changeset
|
839 |
# and now update the database |
0 | 840 |
kwargs['x'] = self.eid |
841 |
self.req.execute('SET %s WHERE X eid %%(x)s' % ','.join(relations), |
|
842 |
kwargs, 'x') |
|
1474 | 843 |
|
0 | 844 |
def delete(self): |
845 |
assert self.has_eid(), self.eid |
|
846 |
self.req.execute('DELETE %s X WHERE X eid %%(x)s' % self.e_schema, |
|
847 |
{'x': self.eid}) |
|
1474 | 848 |
|
0 | 849 |
# server side utilities ################################################### |
1474 | 850 |
|
0 | 851 |
def set_defaults(self): |
852 |
"""set default values according to the schema""" |
|
853 |
self._default_set = set() |
|
854 |
for attr, value in self.e_schema.defaults(): |
|
855 |
if not self.has_key(attr): |
|
856 |
self[str(attr)] = value |
|
857 |
self._default_set.add(attr) |
|
858 |
||
859 |
def check(self, creation=False): |
|
860 |
"""check this entity against its schema. Only final relation |
|
861 |
are checked here, constraint on actual relations are checked in hooks |
|
862 |
""" |
|
863 |
# necessary since eid is handled specifically and yams require it to be |
|
864 |
# in the dictionary |
|
865 |
if self.req is None: |
|
866 |
_ = unicode |
|
867 |
else: |
|
868 |
_ = self.req._ |
|
869 |
self.e_schema.check(self, creation=creation, _=_) |
|
870 |
||
871 |
def fti_containers(self, _done=None): |
|
872 |
if _done is None: |
|
873 |
_done = set() |
|
874 |
_done.add(self.eid) |
|
875 |
containers = tuple(self.e_schema.fulltext_containers()) |
|
876 |
if containers: |
|
476
62968fa8845c
yield self if no ft container found
sylvain.thenault@logilab.fr
parents:
475
diff
changeset
|
877 |
yielded = False |
0 | 878 |
for rschema, target in containers: |
879 |
if target == 'object': |
|
880 |
targets = getattr(self, rschema.type) |
|
881 |
else: |
|
882 |
targets = getattr(self, 'reverse_%s' % rschema) |
|
883 |
for entity in targets: |
|
884 |
if entity.eid in _done: |
|
885 |
continue |
|
886 |
for container in entity.fti_containers(_done): |
|
887 |
yield container |
|
476
62968fa8845c
yield self if no ft container found
sylvain.thenault@logilab.fr
parents:
475
diff
changeset
|
888 |
yielded = True |
62968fa8845c
yield self if no ft container found
sylvain.thenault@logilab.fr
parents:
475
diff
changeset
|
889 |
if not yielded: |
62968fa8845c
yield self if no ft container found
sylvain.thenault@logilab.fr
parents:
475
diff
changeset
|
890 |
yield self |
0 | 891 |
else: |
892 |
yield self |
|
1474 | 893 |
|
0 | 894 |
def get_words(self): |
895 |
"""used by the full text indexer to get words to index |
|
896 |
||
897 |
this method should only be used on the repository side since it depends |
|
898 |
on the indexer package |
|
1474 | 899 |
|
0 | 900 |
:rtype: list |
901 |
:return: the list of indexable word of this entity |
|
902 |
""" |
|
903 |
from indexer.query_objects import tokenize |
|
904 |
words = [] |
|
905 |
for rschema in self.e_schema.indexable_attributes(): |
|
906 |
try: |
|
907 |
value = self.printable_value(rschema, format='text/plain') |
|
1132 | 908 |
except TransformError: |
0 | 909 |
continue |
910 |
except: |
|
911 |
self.exception("can't add value of %s to text index for entity %s", |
|
912 |
rschema, self.eid) |
|
913 |
continue |
|
914 |
if value: |
|
915 |
words += tokenize(value) |
|
1474 | 916 |
|
0 | 917 |
for rschema, role in self.e_schema.fulltext_relations(): |
918 |
if role == 'subject': |
|
919 |
for entity in getattr(self, rschema.type): |
|
920 |
words += entity.get_words() |
|
921 |
else: # if role == 'object': |
|
922 |
for entity in getattr(self, 'reverse_%s' % rschema.type): |
|
923 |
words += entity.get_words() |
|
924 |
return words |
|
925 |
||
926 |
||
927 |
# attribute and relation descriptors ########################################## |
|
928 |
||
929 |
class Attribute(object): |
|
930 |
"""descriptor that controls schema attribute access""" |
|
931 |
||
932 |
def __init__(self, attrname): |
|
933 |
assert attrname != 'eid' |
|
934 |
self._attrname = attrname |
|
935 |
||
936 |
def __get__(self, eobj, eclass): |
|
937 |
if eobj is None: |
|
938 |
return self |
|
939 |
return eobj.get_value(self._attrname) |
|
940 |
||
941 |
def __set__(self, eobj, value): |
|
942 |
# XXX bw compat |
|
943 |
# would be better to generate UPDATE queries than the current behaviour |
|
944 |
eobj.warning("deprecated usage, don't use 'entity.attr = val' notation)") |
|
945 |
eobj[self._attrname] = value |
|
946 |
||
947 |
||
948 |
class Relation(object): |
|
949 |
"""descriptor that controls schema relation access""" |
|
950 |
_role = None # for pylint |
|
951 |
||
952 |
def __init__(self, rschema): |
|
953 |
self._rschema = rschema |
|
954 |
self._rtype = rschema.type |
|
955 |
||
956 |
def __get__(self, eobj, eclass): |
|
957 |
if eobj is None: |
|
958 |
raise AttributeError('%s cannot be only be accessed from instances' |
|
959 |
% self._rtype) |
|
960 |
return eobj.related(self._rtype, self._role, entities=True) |
|
1474 | 961 |
|
0 | 962 |
def __set__(self, eobj, value): |
963 |
raise NotImplementedError |
|
964 |
||
965 |
||
966 |
class SubjectRelation(Relation): |
|
967 |
"""descriptor that controls schema relation access""" |
|
968 |
_role = 'subject' |
|
1474 | 969 |
|
0 | 970 |
class ObjectRelation(Relation): |
971 |
"""descriptor that controls schema relation access""" |
|
972 |
_role = 'object' |
|
973 |
||
974 |
from logging import getLogger |
|
975 |
from cubicweb import set_log_methods |
|
976 |
set_log_methods(Entity, getLogger('cubicweb.entity')) |