[source storage] refactor source sql generation and results handling to allow repository side callbacks for instance with the BytesFileSystemStorage, before this change: * fspath, _fsopen function were stored procedures executed on the database -> files had to be available both on the repository *and* the database host * we needed implementation for each handled database Now, those function are python callbacks executed when necessary on the repository side, on data comming from the database. The litle cons are: * you can't do anymore restriction on mapped attributes * you can't write queries which will return in the same rset column some mapped attributes (or not mapped the same way) / some not This seems much acceptable since: * it's much more easy to handle when you start having the db on another host than the repo * BFSS works seemlessly on any backend now * you don't bother that much about the cons (at least in the bfss case): you usually don't do any restriction on Bytes... Bonus points: BFSS is more efficient (no queries under the cover as it was done in the registered procedure) and we have a much nicer/efficient fspath implementation. IMO, that rocks :D

     1

"""helper functions for application hooks

     2

     3

:organization: Logilab

     4

:copyright: 2001-2010 LOGILAB S.A. (Paris, FRANCE), license is LGPL v2.

     5

:contact: http://www.logilab.fr/ -- mailto:contact@logilab.fr

     6

:license: GNU Lesser General Public License, v2.1 - http://www.gnu.org/licenses

     7

"""

     8

__docformat__ = "restructuredtext en"

     9

    10

from logilab.common.deprecation import deprecated, class_moved

    11

    12

from cubicweb.server import hook

    13

    14

@deprecated('[3.6] entity_oldnewvalue should be imported from cw.server.hook')

    15

def entity_oldnewvalue(entity, attr):

    16

    return hook.entity_oldnewvalue(entity, attr)

    17

    18

@deprecated('[3.6] entity_name is deprecated, use entity.name')

    19

def entity_name(session, eid):

    20

    """return the "name" attribute of the entity with the given eid"""

    21

    return session.entity_from_eid(eid).name

    22

    23

@deprecated('[3.6] rproperty is deprecated, use session.schema_rproperty')

    24

def rproperty(session, rtype, eidfrom, eidto, rprop):

    25

    return session.rproperty(rtype, eidfrom, eidto, rprop)

    26

    27

SendMailOp = class_moved(hook.SendMailOp)