"""

generic boxes for CubicWeb web client:

* actions box

* possible views box

additional (disabled by default) boxes

* schema box

* startup views box

: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 logilab.mtconverter import html_escape

from cubicweb.rtags import RelationTags

from cubicweb.selectors import match_user_groups, non_final_entity

from cubicweb.web.htmlwidgets import BoxWidget, BoxMenu, BoxHtml, RawBoxItem

from cubicweb.view import EntityView

from cubicweb.web.box import BoxTemplate

_ = unicode

class EditBox(BoxTemplate):

    """

    box with all actions impacting the entity displayed: edit, copy, delete

    change state, add related entities

    """

    id = 'edit_box'

    __select__ = BoxTemplate.__select__ & non_final_entity()

    title = _('actions')

    order = 2

    # 'link' / 'create' relation tags, used to control the "add entity" submenu

    rmode = RelationTags() 

    rmode.set_rtag('link', 'is', 'subject')

    rmode.set_rtag('link', 'is', 'object')

    rmode.set_rtag('link', 'is_instance_of', 'subject')

    rmode.set_rtag('link', 'is_instance_of', 'object')

    rmode.set_rtag('link', 'identity', 'subject')

    rmode.set_rtag('link', 'identity', 'object')

    rmode.set_rtag('link', 'owned_by', 'subject')

    rmode.set_rtag('link', 'created_by', 'subject')

    rmode.set_rtag('link', 'require_permission', 'subject')

    rmode.set_rtag('link', 'wf_info_for', 'subject')

    rmode.set_rtag('link', 'wf_info_for', 'subject')

    @classmethod

    def registered(cls, registry):

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

        cls.init_rtags_mode()

        return cls

    @classmethod

    def init_rtags_mode(cls):

        """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]

                    else:

                        X, Y = tschema, eschema

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

                        if card in '?1':

                            # by default, suppose link mode if cardinality doesn't allow

                            # more than one relation

                            mode = 'link'

                        elif rschema.rproperty(X, Y, 'composite') == role:

                            # if self is composed of the target type, create mode

                            mode = 'create'

                        else:

                            # link mode by default

                            mode = 'link'

    @classmethod

    def relation_mode(cls, rtype, etype, targettype, role='subject'):

        """return a string telling if the given relation is usually created

        to a new entity ('create' mode) or to an existant entity ('link' mode)

        """

    def call(self, **kwargs):

        _ = self.req._

        title = _(self.title)

        if self.rset:

            etypes = self.rset.column_types(0)

            if len(etypes) == 1:

                plural = self.rset.rowcount > 1 and 'plural' or ''

                etypelabel = display_name(self.req, iter(etypes).next(), plural)

                title = u'%s - %s' % (title, etypelabel.lower())

        box = BoxWidget(title, self.id, _class="greyBoxFrame")

        # build list of actions

        actions = self.vreg.possible_actions(self.req, self.rset)

        add_menu = BoxMenu(_('add')) # 'addrelated' category

        other_menu = BoxMenu(_('more actions')) # 'moreactions' category

        searchstate = self.req.search_state[0]

        for category, menu in (('mainactions', box),

                               ('addrelated', add_menu),

                               ('moreactions', other_menu)):

            for action in actions.get(category, ()):

                menu.append(self.box_action(action))

        if self.rset and self.rset.rowcount == 1 and \

               not self.schema[self.rset.description[0][0]].is_final() and \

               searchstate == 'normal':

            entity = self.rset.get_entity(0, 0)

            #entity.complete()

            if add_menu.items:

                self.info('explicit actions defined, ignoring potential rtags for %s',

                          entity.e_schema)

            else:

                # some addrelated actions may be specified but no one is selectable

                # in which case we should not fallback to schema_actions. The proper

                # way to avoid this is to override add_related_schemas() on the

                # entity class to return an empty list

                for action in self.schema_actions(entity):

                    add_menu.append(action)

            self.workflow_actions(entity, box)

        if box.is_empty() and not other_menu.is_empty():

            box.items = other_menu.items

            other_menu.items = []

        self.add_submenu(box, add_menu, _('add'))

        self.add_submenu(box, other_menu)

        if not box.is_empty():

            box.render(self.w)

    def add_submenu(self, box, submenu, label_prefix=None):

        if len(submenu.items) == 1:

            boxlink = submenu.items[0]

            if label_prefix:

                boxlink.label = u'%s %s' % (label_prefix, boxlink.label)

            box.append(boxlink)

        elif submenu.items:

            box.append(submenu)

    def schema_actions(self, entity):

        user = self.req.user

        actions = []

        _ = self.req._

        eschema = entity.e_schema

        for rschema, teschema, x in self.add_related_schemas(entity):

            if x == 'subject':

                label = 'add %s %s %s %s' % (eschema, rschema, teschema, x)

                url = self.linkto_url(entity, rschema, teschema, 'object')

            else:

                label = 'add %s %s %s %s' % (teschema, rschema, eschema, x)

                url = self.linkto_url(entity, rschema, teschema, 'subject')

            actions.append(self.mk_action(_(label), url))

        return actions

    def add_related_schemas(self, entity):

        """this is actually used ui method to generate 'addrelated' actions from

        the schema.

        If you're using explicit 'addrelated' actions for an entity types, you

        should probably overrides this method to return an empty list else you

        may get some unexpected actions.

        """

        req = self.req

        eschema = entity.e_schema

        for role, rschemas in (('subject', eschema.subject_relations()),

                               ('object', eschema.object_relations())):

            for rschema in rschemas:

                if rschema.is_final():

                    continue

                # check the relation can be added as well

                if role == 'subject'and not rschema.has_perm(req, 'add', fromeid=entity.eid):

                    continue

                if role == 'object'and not rschema.has_perm(req, 'add', toeid=entity.eid):

                    continue

                # check the target types can be added as well

                for teschema in rschema.targets(eschema, role):

                    if not self.relation_mode(rschema, eschema, teschema, role) == 'create':

                        continue

                    if teschema.has_local_role('add') or teschema.has_perm(req, 'add'):

                        yield rschema, teschema, role

    def workflow_actions(self, entity, box):

        if 'in_state' in entity.e_schema.subject_relations() and entity.in_state:

            _ = self.req._

            state = entity.in_state[0]

            transitions = list(state.transitions(entity))

            if transitions:

                menu_title = u'%s: %s' % (_('state'), state.view('text'))

                menu_items = []

                for tr in state.transitions(entity):

                    url = entity.absolute_url(vid='statuschange', treid=tr.eid)

                    menu_items.append(self.mk_action(_(tr.name), url))

                box.append(BoxMenu(menu_title, menu_items))

            # when there are no possible transition, put state if the menu if

            # there are some other actions

            elif not box.is_empty():

                menu_title = u'<a title="%s">%s: <i>%s</i></a>' % (

                    _('no possible transition'), _('state'), state.view('text'))

                box.append(RawBoxItem(menu_title, 'boxMainactions'))

        return None

    def linkto_url(self, entity, rtype, etype, target):

        return self.build_url(vid='creation', etype=etype,

                              __linkto='%s:%s:%s' % (rtype, entity.eid, target),

                              __redirectpath=entity.rest_path(), # should not be url quoted!

                              __redirectvid=self.req.form.get('vid', ''))

class SearchBox(BoxTemplate):

    """display a box with a simple search form"""

    id = 'search_box'

    visible = True # enabled by default

    title = _('search')

    order = 0

    formdef = u"""<form action="%s">

<table id="tsearch"><tr><td>

<input id="norql" type="text" accesskey="q" tabindex="%s" title="search text" value="%s" name="rql" />

<input type="hidden" name="__fromsearchbox" value="1" />

<input type="hidden" name="subvid" value="tsearch" />

</td><td>

<input tabindex="%s" type="submit" id="rqlboxsubmit" class="rqlsubmit" value="" />

</td></tr></table>

</form>"""

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

        req = self.req

        if req.form.pop('__fromsearchbox', None):

            rql = req.form.get('rql', '')

        else:

            rql = ''

        form = self.formdef % (req.build_url('view'), req.next_tabindex(),

                               html_escape(rql), req.next_tabindex())

        title = u"""<span onclick="javascript: toggleVisibility('rqlinput')">%s</span>""" % req._(self.title)

        box = BoxWidget(title, self.id, _class="searchBoxFrame", islist=False, escape=False)

        box.append(BoxHtml(form))

        box.render(self.w)            

# boxes disabled by default ###################################################

class PossibleViewsBox(BoxTemplate):

    """display a box containing links to all possible views"""

    id = 'possible_views_box'

    __select__ = BoxTemplate.__select__ & match_user_groups('users', 'managers')

    visible = False

    title = _('possible views')

    order = 10

    def call(self, **kwargs):

        box = BoxWidget(self.req._(self.title), self.id)

        views = [v for v in self.vreg.possible_views(self.req, self.rset)

                 if v.category != 'startupview']

        for category, views in self.sort_actions(views):

            menu = BoxMenu(category)

            for view in views:

                menu.append(self.box_action(view))

            box.append(menu)

        if not box.is_empty():

            box.render(self.w)

class StartupViewsBox(BoxTemplate):

    """display a box containing links to all startup views"""

    id = 'startup_views_box'

    visible = False # disabled by default

    title = _('startup views')

    order = 70

    def call(self, **kwargs):

        box = BoxWidget(self.req._(self.title), self.id)

        for view in self.vreg.possible_views(self.req, None):

            if view.category == 'startupview':

                box.append(self.box_action(view))

        if not box.is_empty():

            box.render(self.w)

# helper classes ##############################################################

class SideBoxView(EntityView):

    """helper view class to display some entities in a sidebox"""

    id = 'sidebox'

    def call(self, boxclass='sideBox', title=u''):

        """display a list of entities by calling their <item_vid> view"""

        if title:

            self.w(u'<div class="sideBoxTitle"><span>%s</span></div>' % title)

        self.w(u'<div class="%s"><div class="sideBoxBody">' % boxclass)

        # if not too much entities, show them all in a list

        maxrelated = self.req.property_value('navigation.related-limit')

        if self.rset.rowcount <= maxrelated:

            if len(self.rset) == 1:

                self.wview('incontext', self.rset, row=0)

            elif 1 < len(self.rset) < 5:

                self.wview('csv', self.rset)

            else:

                self.wview('simplelist', self.rset)

        # else show links to display related entities

        else:

            self.rset.limit(maxrelated)

            rql = self.rset.printable_rql(encoded=False)

            self.wview('simplelist', self.rset)

            self.w(u'[<a href="%s">%s</a>]' % (self.build_url(rql=rql),

                                               self.req._('see them all')))

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