# 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/>.

"""Some parsers to detect action to do from text

Currently only a parser to look for state change instruction is provided.

Take care to security when you're using it, think about the user that

will provide the text to analyze...

"""

__docformat__ = "restructuredtext en"

import re

from cubicweb import UnknownEid, typed_eid

from cubicweb.view import Component

class TextAnalyzer(Component):

    """analyze and extract information from plain text by calling registered

    text parsers

    """

    __regid__ = 'textanalyzer'

    def parse(self, caller, text):

        for parsercls in self._cw.vreg['components'].get('textparser', ()):

            parsercls(self._cw).parse(caller, text)

class TextParser(Component):

    """base class for text parser, responsible to extract some information

    from plain text. When something is done, it usually call the

      .fire_event(something, {event args})

    method on the caller.

    """

    __regid__ = 'textparser'

    __abstract__ = True

    def parse(self, caller, text):

        raise NotImplementedError

class ChangeStateTextParser(TextParser):

    """search some text for change state instruction in the form

         :<transition name>: #?<eid>

    """

    instr_rgx = re.compile(':(\w+):\s*#?(\d+)', re.U)

    def parse(self, caller, text):

        for trname, eid in self.instr_rgx.findall(text):

            try:

                entity = self._cw.entity_from_eid(typed_eid(eid))

            except UnknownEid:

                self.error("can't get entity with eid %s", eid)

                continue

            if not hasattr(entity, 'in_state'):

                self.error('bad change state instruction for eid %s', eid)

                continue

            iworkflowable = entity.cw_adapt_to('IWorkflowable')

            if iworkflowable.current_workflow:

                tr = iworkflowable.current_workflow.transition_by_name(trname)

            else:

                tr = None

            if tr and tr.may_be_fired(entity.eid):

                try:

                    trinfo = iworkflowable.fire_transition(tr)

                    caller.fire_event('state-changed', {'trinfo': trinfo,

                                                        'entity': entity})

                except:

                    self.exception('while changing state of %s', entity)

            else:

                self.error("can't pass transition %s on entity %s",

                           trname, entity)