"""Set of views allowing edition of entities/relations using ajax

:organization: Logilab

:copyright: 2009 LOGILAB S.A. (Paris, FRANCE), license is LGPL v2.

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

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

"""

__docformat__ = "restructuredtext en"

from cubicweb import role

from cubicweb.selectors import match_form_params, match_kwargs

from cubicweb.web.box import EditRelationBoxTemplate

class AddRelationView(EditRelationBoxTemplate):

    """base class for view which let add entities linked

    by a given relation

    subclasses should define at least id, rtype and target

    class attributes.

    """

    __registry__ = 'views'

    __regid__ = 'xaddrelation'

    __select__ = (match_form_params('rtype', 'target')

                  | match_kwargs('rtype', 'target'))

    cw_property_defs = {} # don't want to inherit this from Box

    expected_kwargs = form_params = ('rtype', 'target')

    build_js = EditRelationBoxTemplate.build_reload_js_call

    def cell_call(self, row, col, rtype=None, target=None, etype=None):

        self.rtype = rtype or self._cw.form['rtype']

        self.target = target or self._cw.form['target']

        self.etype = etype or self._cw.form.get('etype')

        entity = self.cw_rset.get_entity(row, col)

        rschema = self._cw.schema.rschema(self.rtype)

        if not self.etype:

            if self.target == 'object':

                etypes = rschema.objects(entity.e_schema)

            else:

                etypes = rschema.subjects(entity.e_schema)

            if len(etypes) == 1:

                self.etype = etypes[0]

        self.w(u'<div id="%s">' % self.__regid__)

        self.w(u'<h1>%s</h1>' % self._cw._('relation %(relname)s of %(ent)s')

               % {'relname': rschema.display_name(self._cw, role(self)),

                  'ent': entity.view('incontext')})

        self.w(u'<ul>')

        for boxitem in self.unrelated_boxitems(entity):

            boxitem.render(self.w)

        self.w(u'</ul></div>')

    def unrelated_entities(self, entity):

        """returns the list of unrelated entities

        if etype is not defined on the Box's class, the default

        behaviour is to use the entity's appropraite vocabulary function

        """

        # use entity.unrelated if we've been asked for a particular etype

        if getattr(self, 'etype', None):

            rset = entity.unrelated(self.rtype, self.etype, role(self),

                                    ordermethod='fetch_order')

            self.pagination(self._cw, rset, w=self.w)

            return rset.entities()

        # in other cases, use vocabulary functions

        entities = []

        # XXX to update for 3.2

        for _, eid in entity.vocabulary(self.rtype, role(self)):

            if eid is not None:

                rset = self._cw.eid_rset(eid)

                entities.append(rset.get_entity(0, 0))

        return entities