# copyright 2003-2011 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/>.

"""base application's entities class implementation: `AnyEntity`"""

__docformat__ = "restructuredtext en"

from warnings import warn

from logilab.common.deprecation import deprecated

from logilab.common.decorators import cached

from cubicweb import Unauthorized, typed_eid

from cubicweb.entity import Entity

class AnyEntity(Entity):

    """an entity instance has e_schema automagically set on the class and

    instances have access to their issuing cursor

    """

    __regid__ = 'Any'

    __implements__ = ()

    @classmethod

    def cw_create_url(cls, req, **kwargs):

        """ return the url of the entity creation form for this entity type"""

        return req.build_url('add/%s' % cls.__regid__, **kwargs)

    # meta data api ###########################################################

    def dc_title(self):

        """return a suitable *unicode* title for this entity"""

        for rschema, attrschema in self.e_schema.attribute_definitions():

            if rschema.meta:

                continue

            value = self.cw_attr_value(rschema.type)

            if value:

                # make the value printable (dates, floats, bytes, etc.)

                return self.printable_value(rschema.type, value, attrschema.type,

                                            format='text/plain')

        return u'%s #%s' % (self.dc_type(), self.eid)

    def dc_long_title(self):

        """return a more detailled title for this entity"""

        return self.dc_title()

    def dc_description(self, format='text/plain'):

        """return a suitable description for this entity"""

        if 'description' in self.e_schema.subjrels:

            return self.printable_value('description', format=format)

        return u''

    def dc_authors(self):

        """return a suitable description for the author(s) of the entity"""

        try:

            return ', '.join(u.name() for u in self.owned_by)

        except Unauthorized:

            return u''

    def dc_creator(self):

        """return a suitable description for the creator of the entity"""

        if self.creator:

            return self.creator.name()

        return u''

    def dc_date(self, date_format=None):# XXX default to ISO 8601 ?

        """return latest modification date of this entity"""

        return self._cw.format_date(self.modification_date, date_format=date_format)

    def dc_type(self, form=''):

        """return the display name for the type of this entity (translated)"""

        return self.e_schema.display_name(self._cw, form)

    def dc_language(self):

        """return language used by this entity (translated)"""

        # check if entities has internationalizable attributes

        # XXX one is enough or check if all String attributes are internationalizable?

        for rschema, attrschema in self.e_schema.attribute_definitions():

            if rschema.rdef(self.e_schema, attrschema).internationalizable:

                return self._cw._(self._cw.user.property_value('ui.language'))

        return self._cw._(self._cw.vreg.property_value('ui.language'))

    @property

    def creator(self):

        """return the CWUser entity which has created this entity, or None if

        unknown or if the curent user doesn't has access to this euser

        """

        try:

            return self.created_by[0]

        except (Unauthorized, IndexError):

            return None

    # abstractions making the whole things (well, some at least) working ######

    def sortvalue(self, rtype=None):

        """return a value which can be used to sort this entity or given

        entity's attribute

        """

        if rtype is None:

            return self.dc_title().lower()

        value = self.cw_attr_value(rtype)

        # do not restrict to `unicode` because Bytes will return a `str` value

        if isinstance(value, basestring):

            return self.printable_value(rtype, format='text/plain').lower()

        return value

    # edition helper functions ################################################

    def linked_to(self, rtype, role, remove=True):

        """if entity should be linked to another using '__linkto' form param for

        the given relation/role, return eids of related entities

        This method is consuming matching link-to information from form params

        if `remove` is True (by default). Computed values are stored into a

        `cw_linkto` attribute, a dictionary with (relation, role) as key and

        linked eids as value.

        """

        try:

            return self.cw_linkto[(rtype, role)]

        except AttributeError:

            self.cw_linkto = {}

        except KeyError:

            pass

        linktos = list(self._cw.list_form_param('__linkto'))

        linkedto = []

        for linkto in linktos[:]:

            ltrtype, eid, ltrole = linkto.split(':')

            if rtype == ltrtype and role == ltrole:

                # delete __linkto from form param to avoid it being added as

                # hidden input

                if remove:

                    linktos.remove(linkto)

                    self._cw.form['__linkto'] = linktos

                linkedto.append(typed_eid(eid))

        self.cw_linkto[(rtype, role)] = linkedto

        return linkedto

    # server side helpers #####################################################

    if pclass is not None:

        fetchattrs += pclass.fetch_attrs

    if mainattr is None:

        mainattr = fetchattrs[0]

    @classmethod

        if attr == mainattr:

    return fetchattrs, fetch_order