# copyright 2003-2010 LOGILAB S.A. (Paris, FRANCE), all rights reserved.

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

#

# This file is part of CubicWeb.

#

# CubicWeb is free software: you can redistribute it and/or modify it under the

# terms of the GNU Lesser General Public License as published by the Free

# Software Foundation, either version 2.1 of the License, or (at your option)

# any later version.

#

# CubicWeb is distributed in the hope that it will be useful, but WITHOUT

# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS

# FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License for more

# details.

#

# You should have received a copy of the GNU Lesser General Public License along

# with CubicWeb.  If not, see <http://www.gnu.org/licenses/>.

"""

.. autodocstring:: cubicweb.web.views.autoform::AutomaticEntityForm

Configuration through uicfg

```````````````````````````

It is possible to manage which and how an entity's attributes and relations

will be edited in the various contexts where the automatic entity form is used

by using proper uicfg tags.

The details of the uicfg syntax can be found in the :ref:`uicfg` chapter.

Possible relation tags that apply to entity forms are detailled below.

They are all in the :mod:`cubicweb.web.uicfg` module.

Attributes/relations display location

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

``autoform_section`` specifies where to display a relation in form for a given

form type.  :meth:`tag_attribute`, :meth:`tag_subject_of` and

:meth:`tag_object_of` methods for this relation tag expect two arguments

additionally to the relation key: a `formtype` and a `section`.

`formtype` may be one of:

* 'main', the main entity form (e.g. the one you get when creating or editing an

  entity)

* 'inlined', the form for an entity inlined into another form

* 'muledit', the table form when editing multiple entities of the same type

section may be one of:

* 'hidden', don't display (not even in a hidden input)

* 'attributes', display in the attributes section

* 'relations', display in the relations section, using the generic relation

  selector combobox (available in main form only, and not usable for attributes)

* 'inlined', display target entity of the relation into an inlined form

  (available in main form only, and not for attributes)

By default, mandatory relations are displayed in the 'attributes' section,

others in 'relations' section.

Change default fields

^^^^^^^^^^^^^^^^^^^^^

Use ``autoform_field`` to replace the default field class to use for a relation

or attribute. You can put either a field class or instance as value (put a class

whenether it's possible).

.. Warning::

   `autoform_field_kwargs` should usually be used instead of

   `autoform_field`. If you put a field instance into `autoform_field`,

   `autoform_field_kwargs` values for this relation will be ignored.

Customize field options

^^^^^^^^^^^^^^^^^^^^^^^

In order to customize field options (see :class:`~cubicweb.web.formfields.Field`

for a detailed list of options), use `autoform_field_kwargs`. This rtag takes

a dictionary as arguments, that will be given to the field's contructor.

You can then put in that dictionary any arguments supported by the field

class. For instance:

.. sourcecode:: python

   # Change the content of the combobox. Here `ticket_done_in_choices` is a

   # function which returns a list of elements to populate the combobox

   autoform_field_kwargs.tag_subject_of(('Ticket', 'done_in', '*'),

                                        {'sort': False,

                                         'choices': ticket_done_in_choices})

   # Force usage of a TextInput widget for the expression attribute of

   # RQLExpression entities

   autoform_field_kwargs.tag_attribute(('RQLExpression', 'expression'),

                                       {'widget': fw.TextInput})

.. note::

   the widget argument can be either a class or an instance (the later

   case being convenient to pass the Widget specific initialisation

   options)

Overriding permissions

^^^^^^^^^^^^^^^^^^^^^^

The `autoform_permissions_overrides` rtag provides a way to by-pass security

checking for dark-corner case where it can't be verified properly.

.. More about inlined forms

.. Controlling the generic relation fields

"""

__docformat__ = "restructuredtext en"

_ = unicode

from warnings import warn

from logilab.mtconverter import xml_escape

from logilab.common.decorators import iclassmethod, cached

from logilab.common.deprecation import deprecated

from cubicweb import typed_eid, neg_role, uilib

from cubicweb.schema import display_name

from cubicweb.view import EntityView

from cubicweb.selectors import (

    match_kwargs, match_form_params, non_final_entity,

    specified_etype_implements)

from cubicweb.web import stdmsgs, uicfg, eid_param, dumps, \

     form as f, formwidgets as fw, formfields as ff

from cubicweb.web.views import forms

_AFS = uicfg.autoform_section

_AFFK = uicfg.autoform_field_kwargs

# inlined form handling ########################################################

class InlinedFormField(ff.Field):

    def __init__(self, view=None, **kwargs):

        kwargs.setdefault('label', None)

        super(InlinedFormField, self).__init__(name=view.rtype, role=view.role,

                                               eidparam=True, **kwargs)

        self.view = view

    def render(self, form, renderer):

        """render this field, which is part of form, using the given form

        renderer

        """

        view = self.view

        i18nctx = 'inlined:%s.%s.%s' % (form.edited_entity.e_schema,

                                        view.rtype, view.role)

        return u'<div class="inline-%s-%s-slot">%s</div>' % (

            view.rtype, view.role,

            view.render(i18nctx=i18nctx, row=view.cw_row, col=view.cw_col))

    def form_init(self, form):

        """method called before by build_context to trigger potential field

        initialization requiring the form instance

        """

        if self.view.form:

            self.view.form.build_context(form.formvalues)

    @property

    def needs_multipart(self):

        if self.view.form:

            # take a look at inlined forms to check (recursively) if they need

            # multipart handling.

            return self.view.form.needs_multipart

        return False

    def has_been_modified(self, form):

        return False

    def process_posted(self, form):

        pass # handled by the subform

class InlineEntityEditionFormView(f.FormViewMixIn, EntityView):

    """

    :attr peid: the parent entity's eid hosting the inline form

    :attr rtype: the relation bridging `etype` and `peid`

    :attr role: the role played by the `peid` in the relation

    :attr pform: the parent form where this inlined form is being displayed

    """

    __regid__ = 'inline-edition'

    __select__ = non_final_entity() & match_kwargs('peid', 'rtype')

    _select_attrs = ('peid', 'rtype', 'role', 'pform', 'etype')

    removejs = "removeInlinedEntity('%s', '%s', '%s')"

    def __init__(self, *args, **kwargs):

        for attr in self._select_attrs:

            # don't pop attributes from kwargs, so the end-up in

            # self.cw_extra_kwargs which is then passed to the edition form (see

            # the .form method)

            setattr(self, attr, kwargs.get(attr))

        super(InlineEntityEditionFormView, self).__init__(*args, **kwargs)

    def _entity(self):

        assert self.cw_row is not None, self

        return self.cw_rset.get_entity(self.cw_row, self.cw_col)

    @property

    @cached

    def form(self):

        entity = self._entity()

        form = self._cw.vreg['forms'].select('edition', self._cw,

                                             entity=entity,

                                             formtype='inlined',

                                             form_renderer_id='inline',

                                             copy_nav_params=False,

                                             mainform=False,

                                             parent_form=self.pform,

                                             **self.cw_extra_kwargs)

        if self.pform is None:

            form.restore_previous_post(form.session_key())

        #assert form.parent_form

        self.add_hiddens(form, entity)

        return form

    def cell_call(self, row, col, i18nctx, **kwargs):

        """

        :param peid: the parent entity's eid hosting the inline form

        :param rtype: the relation bridging `etype` and `peid`

        :param role: the role played by the `peid` in the relation

        """

        entity = self._entity()

        divonclick = "restoreInlinedEntity('%s', '%s', '%s')" % (

            self.peid, self.rtype, entity.eid)

        self.render_form(i18nctx, divonclick=divonclick, **kwargs)

    def render_form(self, i18nctx, **kwargs):

        """fetch and render the form"""

        entity = self._entity()

        divid = '%s-%s-%s' % (self.peid, self.rtype, entity.eid)

        title = self.form_title(entity, i18nctx)

        removejs = self.removejs and self.removejs % (

            self.peid, self.rtype, entity.eid)

        countkey = '%s_count' % self.rtype

        try:

            self._cw.data[countkey] += 1

        except KeyError:

            self._cw.data[countkey] = 1

        self.w(self.form.render(

            divid=divid, title=title, removejs=removejs, i18nctx=i18nctx,

            counter=self._cw.data[countkey] , **kwargs))

    def form_title(self, entity, i18nctx):

        return self._cw.pgettext(i18nctx, entity.__regid__)

    def add_hiddens(self, form, entity):

        """to ease overriding (see cubes.vcsfile.views.forms for instance)"""

        iid = 'rel-%s-%s-%s' % (self.peid, self.rtype, entity.eid)

        #  * str(self.rtype) in case it's a schema object

        #  * neged_role() since role is the for parent entity, we want the role

        #    of the inlined entity

        form.add_hidden(name=str(self.rtype), value=self.peid,

                        role=neg_role(self.role), eidparam=True, id=iid)

    def keep_entity(self, form, entity):

        if not entity.has_eid():

            return True

        # are we regenerating form because of a validation error ?

        if form.form_previous_values:

            cdvalues = self._cw.list_form_param(eid_param(self.rtype, self.peid),

                                                form.form_previous_values)

            if unicode(entity.eid) not in cdvalues:

                return False

        return True

class InlineEntityCreationFormView(InlineEntityEditionFormView):

    """

    :attr etype: the entity type being created in the inline form

    """

    __regid__ = 'inline-creation'

    __select__ = (match_kwargs('peid', 'petype', 'rtype')

                  & specified_etype_implements('Any'))

    _select_attrs = InlineEntityEditionFormView._select_attrs + ('petype',)

    @property

    def removejs(self):

        entity = self._entity()

        rdef = entity.e_schema.rdef(self.rtype, neg_role(self.role), self.petype)

        card= rdef.role_cardinality(self.role)

        # when one is adding an inline entity for a relation of a single card,

        # the 'add a new xxx' link disappears. If the user then cancel the addition,

        # we have to make this link appears back. This is done by giving add new link

        # id to removeInlineForm.

        if card not in '?1':

            return "removeInlineForm('%%s', '%%s', '%s', '%%s')" % self.role

        divid = "addNew%s%s%s:%s" % (

            self.etype, self.rtype, self.role, self.peid)

        return "removeInlineForm('%%s', '%%s', '%s', '%%s', '%s')" % (

            self.role, divid)

    @cached

    def _entity(self):

        try:

            cls = self._cw.vreg['etypes'].etype_class(self.etype)

        except:

            self.w(self._cw._('no such entity type %s') % etype)

            return

        entity = cls(self._cw)

        entity.eid = self._cw.varmaker.next()

        return entity

    def call(self, i18nctx, **kwargs):

        self.render_form(i18nctx, **kwargs)

class InlineAddNewLinkView(InlineEntityCreationFormView):

    """

    :attr card: the cardinality of the relation according to role of `peid`

    """

    __regid__ = 'inline-addnew-link'

    __select__ = (match_kwargs('peid', 'petype', 'rtype')

                  & specified_etype_implements('Any'))

    _select_attrs = InlineEntityCreationFormView._select_attrs + ('card',)

    form = None # no actual form wrapped

    def call(self, i18nctx, **kwargs):

        self._cw.set_varmaker()

        divid = "addNew%s%s%s:%s" % (self.etype, self.rtype, self.role, self.peid)

        self.w(u'<div class="inlinedform" id="%s" cubicweb:limit="true">'

          % divid)

        js = "addInlineCreationForm('%s', '%s', '%s', '%s', '%s', '%s')" % (

            self.peid, self.petype, self.etype, self.rtype, self.role, i18nctx)

        if self.pform.should_hide_add_new_relation_link(self.rtype, self.card):

            js = "toggleVisibility('%s'); %s" % (divid, js)

        __ = self._cw.pgettext

        self.w(u'<a class="addEntity" id="add%s:%slink" href="javascript: %s" >+ %s.</a>'

          % (self.rtype, self.peid, js, __(i18nctx, 'add a %s' % self.etype)))

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

# generic relations handling ##################################################

def relation_id(eid, rtype, role, reid):

    """return an identifier for a relation between two entities"""

    if role == 'subject':

        return u'%s:%s:%s' % (eid, rtype, reid)

    return u'%s:%s:%s' % (reid, rtype, eid)

def toggleable_relation_link(eid, nodeid, label='x'):

    """return javascript snippet to delete/undelete a relation between two

    entities

    """

    js = u"javascript: togglePendingDelete('%s', %s);" % (

        nodeid, xml_escape(dumps(eid)))

    return u'[<a class="handle" href="%s" id="handle%s">%s</a>]' % (

        js, nodeid, label)

def get_pending_inserts(req, eid=None):

    """shortcut to access req's pending_insert entry

    This is where are stored relations being added while editing

    an entity. This used to be stored in a temporary cookie.

    """

    pending = req.session.data.get('pending_insert', ())

    return ['%s:%s:%s' % (subj, rel, obj) for subj, rel, obj in pending

            if eid is None or eid in (subj, obj)]

def get_pending_deletes(req, eid=None):

    """shortcut to access req's pending_delete entry

    This is where are stored relations being removed while editing

    an entity. This used to be stored in a temporary cookie.

    """

    pending = req.session.data.get('pending_delete', ())

    return ['%s:%s:%s' % (subj, rel, obj) for subj, rel, obj in pending

            if eid is None or eid in (subj, obj)]

def parse_relations_descr(rdescr):

    """parse a string describing some relations, in the form

    subjeids:rtype:objeids

    where subjeids and objeids are eids separeted by a underscore

    return an iterator on (subject eid, relation type, object eid) found