from logilab.common.deprecation import class_deprecated, class_renamed

from cubicweb import Unauthorized, role, tags

from cubicweb.uilib import js, domid

from cubicweb.view import ReloadableMixIn, Component

from cubicweb.selectors import (no_cnx, paginated_rset, one_line_rset,

                                non_final_entity, partial_relation_possible,

                                partial_has_related_entities)

from cubicweb.appobject import AppObject

from cubicweb.web import htmlwidgets, stdmsgs

# abstract base class for navigation components ################################

            url = 'javascript: %s' % (js.replacePageChunk(

                params.get('divid', 'pageContent'), rql,

                params.pop('vid', None), params))

# new contextual components system #############################################

def override_ctx(cls, **kwargs):

    cwpdefs = cls.cw_property_defs.copy()

    cwpdefs['context']  = cwpdefs['context'].copy()

    cwpdefs['context'].update(kwargs)

    return cwpdefs

class EmptyComponent(Exception):

    """some selectable component has actually no content and should not be

    rendered

    """

class Layout(Component):

    __regid__ = 'layout'

    __abstract__ = True

    def init_rendering(self):

        """init view for rendering. Return true if we should go on, false

        if we should stop now.

        """

        view = self.cw_extra_kwargs['view']

        try:

            view.init_rendering()

        except Unauthorized, ex:

            self.warning("can't render %s: %s", view, ex)

            return False

        except EmptyComponent:

            return False

        return True

class CtxComponent(AppObject):

    """base class for contextual compontents. The following contexts are

    predefined:

    * boxes: 'left', 'incontext', 'right'

    * section: 'navcontenttop', 'navcontentbottom', 'navtop', 'navbottom'

    * other: 'ctxtoolbar'

    The 'incontext', 'navcontenttop', 'navcontentbottom' and 'ctxtoolbar'

    context are handled by the default primary view, others by the default main

    template.

    All subclasses may not support all those contexts (for instance if it can't

    be displayed as box, or as a toolbar icon). You may restrict allowed context

    as followed:

    .. sourcecode:: python

      class MyComponent(CtxComponent):

          cw_property_defs = override_ctx(CtxComponent,

                                          vocabulary=[list of contexts])

          context = 'my default context'

    You can configure default component's context by simply giving appropriate

    value to the `context` class attribute, as seen above.

    """

    __registry__ = 'ctxcomponents'

    __select__ = ~no_cnx()

    categories_in_order = ()

    cw_property_defs = {

        _('visible'): dict(type='Boolean', default=True,

                           help=_('display the box or not')),

        _('order'):   dict(type='Int', default=99,

                           help=_('display order of the box')),

        _('context'): dict(type='String', default='left',

                           vocabulary=(_('left'), _('incontext'), _('right'),

                                       _('navtop'), _('navbottom'),

                                       _('navcontenttop'), _('navcontentbottom'),

                                       _('ctxtoolbar')),

                           help=_('context where this component should be displayed')),

        }

    context = 'left'

    contextual = False

    title = None

    # XXX support kwargs for compat with old boxes which gets the view as

    # argument

    def render(self, w, **kwargs):

        getlayout = self._cw.vreg['components'].select

        try:

            # XXX ensure context is given when the component is reloaded through

            # ajax

            context = self.cw_extra_kwargs['context']

        except KeyError:

            context = self.cw_propval('context')

        layout = getlayout('layout', self._cw, rset=self.cw_rset,

                           row=self.cw_row, col=self.cw_col,

                           view=self, context=context)

        layout.render(w)

    def init_rendering(self):

        """init rendering callback: that's the good time to check your component

        has some content to display. If not, you can still raise

        :exc:`EmptyComponent` to inform it should be skipped.

        Also, :exc:`Unauthorized` will be catched, logged, then the component

        will be skipped.

        """

        self.items = []

    @property

    def domid(self):

        """return the HTML DOM identifier for this component"""

        return domid(self.__regid__)

    @property

    def cssclass(self):

        """return the CSS class name for this component"""

        return domid(self.__regid__)

    def render_title(self, w):

        """return the title for this component"""

        if self.title:

            w(self._cw._(self.title))

    def render_body(self, w):

        """return the body (content) for this component"""

        raise NotImplementedError()

    def render_items(self, w, items=None, klass=u'boxListing'):

        if items is None:

            items = self.items

        assert items

        w(u'<ul class="%s">' % klass)

        for item in items:

            if hasattr(item, 'render'):

                item.render(w) # XXX display <li> by itself

            else:

                w(u'<li>')

                w(item)

                w(u'</li>')

        w(u'</ul>')

    def append(self, item):

        self.items.append(item)

    def box_action(self, action): # XXX action_link

        return self.build_link(self._cw._(action.title), action.url())

    def build_link(self, title, url, **kwargs):

        if self._cw.selected(url):

            try:

                kwargs['klass'] += ' selected'

            except KeyError:

                kwargs['klass'] = 'selected'

        return tags.a(title, href=url, **kwargs)

class EntityCtxComponent(CtxComponent):

    """base class for boxes related to a single entity"""

    __select__ = CtxComponent.__select__ & non_final_entity() & one_line_rset()

    context = 'incontext'

    contextual = True

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

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

        try:

            entity = kwargs['entity']

        except KeyError:

            entity = self.cw_rset.get_entity(self.cw_row or 0, self.cw_col or 0)

        self.entity = entity

    @property

    def domid(self):

        return domid(self.__regid__) + unicode(self.entity.eid)

# high level abstract classes ##################################################

class RQLCtxComponent(CtxComponent):

    """abstract box for boxes displaying the content of a rql query not

    related to the current result set.

    """

    rql  = None

    def to_display_rql(self):

        assert self.rql is not None, self.__regid__

        return (self.rql,)

    def init_rendering(self):

        rset = self._cw.execute(*self.to_display_rql())

        if not rset:

            raise EmptyComponent()

        if len(rset[0]) == 2:

            self.items = []

            for i, (eid, label) in enumerate(rset):

                entity = rset.get_entity(i, 0)

                self.items.append(self.build_link(label, entity.absolute_url()))

        else:

            self.items = [self.build_link(e.dc_title(), e.absolute_url())

                          for e in rset.entities()]

    def render_body(self, w):

        self.render_items(w)

class EditRelationMixIn(ReloadableMixIn):

    def box_item(self, entity, etarget, rql, label):

        """builds HTML link to edit relation between `entity` and `etarget`"""

        role, target = get_role(self), get_target(self)

        args = {role[0] : entity.eid, target[0] : etarget.eid}

        url = self._cw.user_rql_callback((rql, args))

        # for each target, provide a link to edit the relation

        return u'[<a href="%s">%s</a>] %s' % (xml_escape(url), label,

                                              etarget.view('incontext'))

    def related_boxitems(self, entity):

        rql = 'DELETE S %s O WHERE S eid %%(s)s, O eid %%(o)s' % self.rtype

        return [self.box_item(entity, etarget, rql, u'-')

                for etarget in self.related_entities(entity)]

    def related_entities(self, entity):

        return entity.related(self.rtype, get_role(self), entities=True)

    def unrelated_boxitems(self, entity):

        rql = 'SET S %s O WHERE S eid %%(s)s, O eid %%(o)s' % self.rtype

        return [self.box_item(entity, etarget, rql, u'+')

                for etarget in self.unrelated_entities(entity)]

    def unrelated_entities(self, entity):

        """returns the list of unrelated entities, using the entity's

        appropriate vocabulary function

        """

        skip = set(unicode(e.eid) for e in entity.related(self.rtype, get_role(self),

                                                          entities=True))

        skip.add(None)

        skip.add(INTERNAL_FIELD_VALUE)

        filteretype = getattr(self, 'etype', None)

        entities = []

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