"""Set of HTML automatic forms to create, delete, copy or edit a single entity

or a list of entities of the same type

:organization: Logilab

:copyright: 2001-2009 LOGILAB S.A. (Paris, FRANCE), all rights reserved.

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

"""

__docformat__ = "restructuredtext en"

from copy import copy

from simplejson import dumps

from logilab.common.decorators import iclassmethod

from logilab.mtconverter import html_escape

from cubicweb import typed_eid

from cubicweb.selectors import (match_kwargs, one_line_rset, non_final_entity,

                                specified_etype_implements, yes)

from cubicweb.rtags import RelationTags

from cubicweb.utils import make_uid

from cubicweb.view import EntityView

from cubicweb.common import tags

from cubicweb.web import INTERNAL_FIELD_VALUE, stdmsgs, formwidgets

from cubicweb.web.form import (FieldNotFound, CompositeForm, EntityFieldsForm,

                               FormMixIn)

from cubicweb.web.formfields import guess_field

from cubicweb.web.formrenderers import (FormRenderer, EntityFormRenderer,

                                        EntityCompositeFormRenderer,

                                        EntityInlinedFormRenderer)

_ = unicode

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 toggable_relation_link(eid, nodeid, label='x'):

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

    entities

    """

    js = u"javascript: togglePendingDelete('%s', %s);" % (nodeid, html_escape(dumps(eid)))

    return u'[<a class="handle" href="%s" id="handle%s">%s</a>]' % (js, nodeid, label)

class DeleteConfForm(EntityView):

    """form used to confirm deletion of some entities"""

    id = 'deleteconf'

    title = _('delete')

    domid = 'deleteconf'

    onsubmit = None

    # don't use navigation, all entities asked to be deleted should be displayed

    # else we will only delete the displayed page

    need_navigation = False

    def call(self):

        """ask for confirmation before real deletion"""

        req, w = self.req, self.w

        _ = req._

        w(u'<script type="text/javascript">updateMessage(\'%s\');</script>\n'

          % _('this action is not reversible!'))

        # XXX above message should have style of a warning

        w(u'<h4>%s</h4>\n' % _('Do you want to delete the following element(s) ?'))

        form = CompositeForm(req, domid='deleteconf', action=self.build_url('edit'),

                                  onsubmit=self.onsubmit, copy_nav_params=True)

        # XXX tabindex

        form.buttons.append(form.button_delete(label=stdmsgs.YES))

        form.buttons.append(form.button_cancel(label=stdmsgs.NO))

        done = set()

        w(u'<ul>\n')

        for entity in self.rset.entities():

            if entity.eid in done:

                continue

            done.add(entity.eid)

            subform = EntityFieldsForm(req, entity=entity, set_error_url=False)

            form.form_add_subform(subform)

            # don't use outofcontext view or any other that may contain inline edition form

            w(u'<li>%s</li>' % tags.a(entity.view('textoutofcontext'),

                                      href=entity.absolute_url()))

        w(u'</ul>\n')

        w(form.form_render())

class ClickAndEditForm(FormMixIn, EntityView):

    """form used to permit ajax edition of an attribute of an entity in a view

    (double-click on the field to see an appropriate edition widget)

    """

    id = 'reledit'

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

    # FIXME editableField class could be toggleable from userprefs

    onsubmit = ("return inlineValidateForm('%(divid)s-form', '%(rtype)s', "

                "'%(eid)s', '%(divid)s', %(reload)s);")

    ondblclick = "showInlineEditionForm(%(eid)s, '%(rtype)s', '%(divid)s')"

    def cell_call(self, row, col, rtype=None, role='subject', reload=False):

        """display field to edit entity's `rtype` relation on double-click"""

        entity = self.entity(row, col)

        if getattr(entity, rtype) is None:

            value = self.req._('not specified')

        else:

            value = entity.printable_value(rtype)

        if not entity.has_perm('update'):

            self.w(value)

            return

        self.req.add_js( ('cubicweb.ajax.js',) )

        eid = entity.eid

        edit_key = make_uid('%s-%s' % (rtype, eid))

        divid = 'd%s' % edit_key

        reload = dumps(reload)

        # XXX tab index

        buttons = [tags.input(klass="validateButton", type="submit",

                              name="__action_apply",

                              value=self.req._(stdmsgs.BUTTON_OK),

                              tabindex=self.req.next_tabindex()),

                   tags.input(klass="validateButton", type="button",

                              value=self.req._(stdmsgs.BUTTON_CANCEL),

                              onclick="cancelInlineEdit(%s,\'%s\',\'%s\')" % (eid, rtype, divid),

                              tabindex=self.req.next_tabindex())]

        form = self.vreg.select_object('forms', 'edition', self.req, self.rset,

                                       row=row, col=col, buttons=buttons,

                                       domid='%s-form' % divid, action='#',

                                       cssstyle='display: none',

                                       onsubmit=self.onsubmit % locals())

        renderer = FormRenderer(display_label=False, display_help=False,

                                display_fields=(rtype,), button_bar_class='buttonbar')

        self.w(tags.div(value, klass='editableField', id=divid,

                        ondblclick=self.ondblclick % locals()))

        self.w(form.form_render(renderer=renderer))

class AutomaticEntityForm(EntityFieldsForm):

    """base automatic form to edit any entity

    Designed to be flly generated from schema but highly configurable through:

    * rtags (rcategories, rwidgets, inlined, rpermissions)

    * various standard form parameters

    You can also easily customise it by adding/removing fields in

    AutomaticEntityForm instances.

    """

    id = 'edition'

    needs_js = EntityFieldsForm.needs_js + ('cubicweb.ajax.js',)

    cwtarget = 'eformframe'

    cssclass = 'entityForm'

    copy_nav_params = True

    attrcategories = ('primary', 'secondary')

    # relations'category (eg primary/secondary/generic/metadata/generated)

    rcategories = RelationTags()

    # use primary and not generated for eid since it has to be an hidden

    rcategories.set_rtag('primary', 'eid', 'subject')

    rcategories.set_rtag('metadata', 'creation_date', 'subject')

    rcategories.set_rtag('metadata', 'modification_date', 'subject')

    rcategories.set_rtag('generated', 'has_text', 'subject')

    rcategories.set_rtag('metadata', 'owned_by', 'subject')

    rcategories.set_rtag('metadata', 'created_by', 'subject')

    rcategories.set_rtag('generated', 'is', 'subject')

    rcategories.set_rtag('generated', 'is', 'object')

    rcategories.set_rtag('generated', 'is_instance_of', 'subject')

    rcategories.set_rtag('generated', 'is_instance_of', 'object')

    rcategories.set_rtag('generated', 'identity', 'subject')

    rcategories.set_rtag('generated', 'identity', 'object')

    rcategories.set_rtag('generated', 'require_permission', 'subject')

    rcategories.set_rtag('primary', 'in_state', 'subject')

    rcategories.set_rtag('generated', 'wf_info_for', 'subject')

    rcategories.set_rtag('generated', 'wf_info_for', 'subject')

    rcategories.set_rtag('secondary', 'description', 'subject')

    # relations'widget (eg one of available class name in cubicweb.web.formwidgets)

    rwidgets = RelationTags()

    # inlined view flag for non final relations: when True for an entry, the

    # entity(ies) at the other end of the relation will be editable from the

    # form of the edited entity

    rinlined = RelationTags()

    # set of tags of the form <action>_on_new on relations. <action> is a

    # schema action (add/update/delete/read), and when such a tag is found

    # permissions checking is by-passed and supposed to be ok

    rpermissions_overrides = RelationTags(use_set=True)

    @classmethod

    def registered(cls, registry):

        """build class using descriptor at registration time"""

        super(AutomaticEntityForm, cls).registered(registry)

        return cls

    @classmethod

        """set default category tags for relations where it's not yet defined in

        the category relation tags

        """

        for eschema in cls.schema.entities():

            for rschema, tschemas, role in eschema.relation_definitions(True):

                for tschema in tschemas:

                    if role == 'subject':

                        X, Y = eschema, tschema

                        card = rschema.rproperty(X, Y, 'cardinality')[0]

                        composed = rschema.rproperty(X, Y, 'composite') == 'object'

                    else:

                        X, Y = tschema, eschema

                        card = rschema.rproperty(X, Y, 'cardinality')[1]

                        composed = rschema.rproperty(X, Y, 'composite') == 'subject'

                    if not cls.rcategories.rtag(rschema, role, X, Y):

                        if card in '1+':

                            if not rschema.is_final() and composed:

                                category = 'generated'

                            else:

                                category = 'primary'

                        elif rschema.is_final():

                            category = 'secondary'

                        else: 

                            category = 'generic'

                        cls.rcategories.set_rtag(category, rschema, role, X, Y)

    @classmethod

    def erelations_by_category(cls, entity, categories=None, permission=None):

        """return a list of (relation schema, target schemas, role) matching

        categories and permission

        """

        if categories is not None:

            if not isinstance(categories, (list, tuple, set, frozenset)):

                categories = (categories,)

            if not isinstance(categories, (set, frozenset)):

                categories = frozenset(categories)

        eschema  = entity.e_schema

        rtags = cls.rcategories

        permsoverrides = cls.rpermissions_overrides

        if entity.has_eid():

            eid = entity.eid

        else:

            eid = None

        for rschema, targetschemas, role in eschema.relation_definitions(True):

            if rschema in ('identity', 'has_text'):

                continue

            # check category first, potentially lower cost than checking

            # permission which may imply rql queries

            if categories is not None:

                targetschemas = [tschema for tschema in targetschemas

                                 if rtags.etype_rtag(eschema, rschema, role, tschema) in categories]

                if not targetschemas:

                    continue

            if permission is not None:

                # tag allowing to hijack the permission machinery when

                # permission is not verifiable until the entity is actually

                # created...

                if eid is None and '%s_on_new' % permission in permsoverrides.etype_rtags(eschema, rschema, role):

                    yield (rschema, targetschemas, role)

                    continue

                if rschema.is_final():

                    if not rschema.has_perm(entity.req, permission, eid):

                        continue

                elif role == 'subject':

                    if not ((eid is None and rschema.has_local_role(permission)) or

                            rschema.has_perm(entity.req, permission, fromeid=eid)):

                        continue

                    # on relation with cardinality 1 or ?, we need delete perm as well

                    # if the relation is already set

                    if (permission == 'add'

                        and rschema.cardinality(eschema, targetschemas[0], role) in '1?'

                        and eid and entity.related(rschema.type, role)

                        and not rschema.has_perm(entity.req, 'delete', fromeid=eid,

                                                 toeid=entity.related(rschema.type, role)[0][0])):

                        continue

                elif role == 'object':

                    if not ((eid is None and rschema.has_local_role(permission)) or

                            rschema.has_perm(entity.req, permission, toeid=eid)):

                        continue

                    # on relation with cardinality 1 or ?, we need delete perm as well

                    # if the relation is already set

                    if (permission == 'add'

                        and rschema.cardinality(targetschemas[0], eschema, role) in '1?'

                        and eid and entity.related(rschema.type, role)

                        and not rschema.has_perm(entity.req, 'delete', toeid=eid,

                                                 fromeid=entity.related(rschema.type, role)[0][0])):

                        continue

            yield (rschema, targetschemas, role)

    @classmethod

    def esrelations_by_category(cls, entity, categories=None, permission=None):

        """filter out result of relations_by_category(categories, permission) by

        removing final relations

        return a sorted list of (relation's label, relation'schema, role) 

        """

        result = []

        for rschema, ttypes, role in cls.erelations_by_category(

            entity, categories, permission):

            if rschema.is_final():

                continue

            result.append((rschema.display_name(entity.req, role), rschema, role))

        return sorted(result)

    @iclassmethod

    def field_by_name(cls_or_self, name, role='subject', eclass=None):

        """return field with the given name and role. If field is not explicitly

        defined for the form but `eclass` is specified, guess_field will be

        called.

        """

        try:

            return super(AutomaticEntityForm, cls_or_self).field_by_name(name, role)

        except FieldNotFound: # XXX should raise more explicit exception

            if eclass is None:

                raise

            field = guess_field(eclass, cls_or_self.schema.rschema(name), role,

                                eidparam=True)

            if field is None:

                raise

            return field

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

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

        if self.edited_entity.has_eid():

            self.edited_entity.complete()

        for rschema, role in self.editable_attributes():

            wdgname = self.rwidgets.etype_rtag(self.edited_entity.id, rschema,

                                               role)

            if wdgname:

                widget = getattr(formwidgets, wdgname)

                field = guess_field(self.edited_entity.__class__, rschema, role,

                                    eidparam=True, widget=widget)

            else:

                field = guess_field(self.edited_entity.__class__, rschema, role,

                                    eidparam=True)

            if field is not None:

                self.fields.append(field)

    def relations_by_category(self, categories=None, permission=None):

        """return a list of (relation schema, target schemas, role) matching

        given category(ies) and permission

        """

        return self.erelations_by_category(self.edited_entity, categories,

                                           permission)

    def srelations_by_category(self, categories=None, permission=None):

        """filter out result of relations_by_category(categories, permission) by

        removing final relations

        return a sorted list of (relation's label, relation'schema, role) 

        """

        return self.esrelations_by_category(self.edited_entity, categories,

                                           permission)

    def action(self):

        """return the form's action attribute. Default to validateform if not

        explicitly overriden.

        """

        try:

            return self._action

        except AttributeError:

            return self.build_url('validateform')

    def set_action(self, value):

        """override default action"""

        self._action = value