# -*- coding: utf-8 -*-

# vim:set expandtab tabstop=4 shiftwidth=4:

################################################################################

#

# Copyright (C) 2007-2012 CS-SI

#

# This program is free software; you can redistribute it and/or modify

# it under the terms of the GNU General Public License version 2 as

# published by the Free Software Foundation.

#

# This program 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 General Public License for more details.

#

# You should have received a copy of the GNU General Public License

# along with this program; if not, write to the Free Software

# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

################################################################################

"""

Module complémentaire générique.

"""

# État lorsque les plugins sont appelés avec les sous-requêtes.

INNER = 0

# État lorsque les plugins sont appelés lorsque "items" est défini.

ITEMS = 1

class VigiboardRequestPlugin(object):

    """

    Classe que les plugins de VigiBoard doivent étendre.

    """

    def __init__ (self, table = None, join = None, outerjoin = None,

            filters = None, groupby = None, orderby = None, name = '',

            style = None, object_name = ""):

        self.table = table

        self.join = join

        self.outerjoin = outerjoin

        self.filter = filters

        self.orderby = orderby

        self.name = name

        self.groupby = groupby

        self.style = style

        self.object_name = object_name

    def get_bulk_data(self, events_ids):

        """

        Cette méthode est appelée par le L{RootController} : elle

        retourne toutes les données affichées par le plugin dans le

        tableau des évènements de la page principale de VigiBoard.

        Cette méthode DEVRAIT être surchargée dans les classes dérivées.

        @param events_ids: Liste des identifiants des C{CorrEvent} affichés

            sur la page.

        @type  events_ids:  C{List} of C{int}

        @return: Dictionnaire associant à chaque identifiant

            d'évènement les données à afficher par le plugin.

        @rtype:  C{dict}

        """

        pass

    def get_json_data(self, idcorrevent, *args, **kwargs):

        """

        Cette méthode est appelée par le template du plugin via

        la méthode get_plugin_json_data du L{RootController} de VigiBoard.

        Cette méthode DEVRAIT être surchargée dans les classes dérivées

        si le plugin en question doit avoir recours à une requête JSON.

        @param idcorrevent: Identifiant du C{CorrEvent} à interroger.

        @type idcorrevent:  C{int}

        @return: Dictionnaire contenant la ou les valeur(s) correspondantes.

        @rtype:  C{dict}

        """

        pass

    def get_generated_columns_count(self):

        """

        Cette méthode renvoie le nombre de colonnes ajoutées dans le tableau

        des événements par ce plugin. Par défaut, on suppose que chaque plugin

        n'ajoute qu'une seule colonne au tableau.

        Cette méthode PEUT être surchargée dans les classes dérivées.

        @return: Nombre de colonnes ajoutées par ce plugin.

        @rtype: C{int}

        """

        return 1

    def get_search_fields(self):

        return []

    def handle_search_fields(self, query, search, state, subqueries):

        pass