cybertools/organize/service.py

#
#  Copyright (c) 2007 Helmut Merz helmutm@cy55.de
#
#  This program is free software; you can redistribute it and/or modify
#  it under the terms of the GNU General Public License as published by
#  the Free Software Foundation; either version 2 of the License, or
#  (at your option) any later version.
#
#  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., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
#

"""
Service management classes.

$Id$
"""

from time import time
from persistent import Persistent
from BTrees.OOBTree import OOBTree
from zope.cachedescriptors.property import Lazy
from zope.component import adapts
from zope import component
from zope.interface import implements, Interface

from cybertools.composer.interfaces import IInstance
from cybertools.composer.message.base import MessageManager
from cybertools.composer.rule.base import RuleManager, EventType
from cybertools.composer.rule.base import Rule, Action
from cybertools.composer.schema.interfaces import IClientManager, IClient
from cybertools.stateful.base import StatefulAdapter
from cybertools.stateful.definition import registerStatesDefinition
from cybertools.stateful.definition import StatesDefinition
from cybertools.stateful.definition import State, Transition
from cybertools.stateful.interfaces import IStateful
from cybertools.util.jeep import Jeep
from cybertools.util.randomname import generateName
from cybertools.organize.interfaces import IServiceManager
from cybertools.organize.interfaces import IService, IScheduledService
from cybertools.organize.interfaces import IRegistration, IRegistrationTemplate
from cybertools.organize.interfaces import IClientRegistrations


class ServiceManager(object):

    implements(IServiceManager, IClientManager)

    servicesFactory = Jeep
    clientSchemasFactory = Jeep
    clientsFactory = OOBTree

    services = None
    clients = None

    messages = None

    allowRegWithNumber = False
    allowDirectRegistration = True
    senderEmail = 'unknown@sender.com'

    def __init__(self):
        if self.servicesFactory is not None:
            self.services = self.servicesFactory()
        if self.clientSchemasFactory is not None:
            self.clientSchemas = self.clientSchemasFactory()

    def getServices(self, categories=[]):
        return self.services

    def getClientSchemas(self):
        return self.clientSchemas

    @Lazy
    def clients(self):
        return self.clientsFactory()

    def getClients(self):
        return self.clients

    def addClient(self, client):
        name = self.generateClientName(client)
        self.clients[name] = client
        client.__name__ = name
        return name

    def generateClientName(self, client):
        return generateName(self.checkClientName)

    def checkClientName(self, name):
        return name not in self.getClients()


class Registration(object):

    implements(IRegistration)

    number = 1

    def __init__(self, client, service, number=1):
        self.client = client
        self.service = service
        self.timeStamp = int(time())
        self.number = number


class PersistentRegistration(Registration, Persistent):

    pass


class Service(object):

    implements(IService)

    registrationsFactory = OOBTree
    registrationFactory = PersistentRegistration

    manager = None
    category = None
    location = u''
    allowRegWithNumber = False
    allowDirectRegistration = True

    def __init__(self, name=None, title=u'', capacity=-1, **kw):
        self.name = self.__name__ = name
        self.title = title
        self.capacity = capacity
        if self.registrationsFactory is not None:
            self.registrations = self.registrationsFactory()
        self.classification = []
        for k, v in kw.items():
            setattr(self, k, v)

    def getName(self):
        return self.name

    def getManager(self):
        return self.manager

    def getClassification(self):
        return self.classification

    def getCategory(self):
        return self.category

    @property
    def token(self):
        return self.getToken()

    def getToken(self):
        return self.name

    @property
    def availableCapacity(self):
        number = self.getNumberRegistered()
        if self.capacity >= 0 and number >= self.capacity:
            return 0
        return self.capacity - number

    def register(self, client, number=1):
        clientName = client.__name__
        if clientName in self.registrations:
            reg = self.registrations[clientName]
            if number != reg.number:
                reg.number = number
            return reg
        reg = self.registrationFactory(client, self, number)
        self.registrations[clientName] = reg
        return reg

    def unregister(self, client):
        clientName = client.__name__
        if clientName in self.registrations:
            del self.registrations[clientName]

    def getNumberRegistered(self, ignoreTemporary=True):
        result = 0
        for r in self.registrations.values():
            if ignoreTemporary and IStateful(r).state == 'temporary':
                continue
            result += r.number
        return result

    # default methods
    def getAllowRegWithNumberFromManager(self):
        return getattr(self.getManager(), 'allowRegWithNumber', None)
    def getAllowDirectRegistrationFromManager(self):
        return getattr(self.getManager(), 'allowDirectRegistration', None)


class ScheduledService(Service):

    implements(IScheduledService)

    start = end = None

    # default methods
    def getStartFromManager(self):
        return getattr(self.getManager(), 'start', None)
    def getEndFromManager(self):
        return getattr(self.getManager(), 'end', None)


# registration stuff

class RegistrationTemplate(object):

    implements(IRegistrationTemplate)

    def __init__(self, name=None, manager=None):
        self.name = self.__name__ = name
        self.manager = self.__parent__ = manager
        self.categories = []

    @property
    def services(self):
        return self.getServices()

    def getServices(self):
        svcs = self.getManager().getServices()
        categories = [c.strip() for c in self.categories if c.strip()]
        if categories:
            svcs = Jeep((key, s) for key, s in svcs.items()
                                 if s.category in categories)
        return svcs

    def getManager(self):
        return self.manager


class ClientRegistrations(object):

    implements(IClientRegistrations)
    adapts(IClient)

    template = None

    registrationsAttributeName = '__service_registrations__'

    errors = None
    severity = 0

    def __init__(self, context):
        self.context = context

    def register(self, services, numbers=None):
        if numbers is None:
            numbers = len(services) * [1]
        regs = [service.register(self.context, numbers[idx])
                for idx, service in enumerate(services)]
        old = getattr(self.context, self.registrationsAttributeName, [])
        regs.extend(r for r in old if r.service not in services)
        setattr(self.context, self.registrationsAttributeName, regs)

    def unregister(self, services):
        old = getattr(self.context, self.registrationsAttributeName, [])
        regs = [r for r in old if r.service not in services]
        setattr(self.context, self.registrationsAttributeName, regs)
        for service in services:
            service.unregister(self.context)

    def getRegistrations(self):
        regs = getattr(self.context, self.registrationsAttributeName, [])
        if self.template is not None:
            svcs = self.template.getServices().values()
            regs = (r for r in regs if r.service in svcs)
        return regs

    def validate(self, clientName, services, numbers=None):
        self.errors = {}
        if numbers is None:
            numbers = len(services) * [1]
        for svc, n in zip(services, numbers):
            if clientName:
                oldReg = svc.registrations.get(clientName, None)
                if oldReg is None or IStateful(oldReg).state == 'temporary':
                    # availableCapacity does not consider temporary registrations
                    oldN = 0
                else:
                    oldN = oldReg.number or 0
            else:
                oldN = 0
            if svc.capacity and svc.capacity > 0 and svc.availableCapacity < n - oldN:
                error = registrationErrors['capacity_exceeded']
                entry = self.errors.setdefault(svc.token, [])
                entry.append(error)
                self.severity = max(self.severity, error.severity)


class RegistrationError(object):

    def __init__(self, title, description=None, severity=5, **kw):
        self.title = title
        self.description = description or title
        self.severity = severity
        for k, v in kw.items():
            setattr(self, k, v)

    def __str__(self):
        return self.title

    def __repr__(self):
        return "RegistrationError('%s')" % self.title


registrationErrors = dict(
    capacity_exceeded=RegistrationError(
            u'The capacity for this service has been exceeded.'),
    time_conflict=RegistrationError(
            u'You have registered already for another service at the same time.'),
    number_exceeded=RegistrationError(
            u'The total number of participants you are registering is less than the '
                'number of persons you want to register for this service.'),
)


# registration states

registrationStates = 'organize.service.registration'

registerStatesDefinition(
    StatesDefinition(registrationStates,
        State('temporary', 'temporary', ('submit', 'cancel',)),
        State('submitted', 'submitted',
                    ('change', 'retract', 'setwaiting', 'confirm', 'reject',)),
        State('cancelled', 'cancelled', ('submit',)),
        State('retracted', 'retracted', ('submit',)),
        State('waiting', 'waiting',
                    ('change', 'retract', 'confirm', 'reject',)),
        State('confirmed', 'confirmed',
                    ('change', 'retract', 'reject',)),
        State('rejected', 'rejected',
                    ('change', 'retract', 'setwaiting', 'confirm',)),
        Transition('cancel', 'Cancel registration', 'cancelled'),
        Transition('submit', 'Submit registration', 'submitted'),
        Transition('change', 'Change registration', 'submitted'),
        Transition('retract', 'Retract registration', 'retracted'),
        Transition('setwaiting', 'Set on waiting list', 'waiting'),
        Transition('confirm', 'Confirm registration', 'confirmed'),
        Transition('reject', 'Reject registration', 'rejected'),
        initialState='temporary',
))


class StatefulRegistration(StatefulAdapter):

    component.adapts(IRegistration)

    statesDefinition = registrationStates


# events, rules, actions

eventTypes = Jeep((
    EventType('service.checkout'),
))


class RuleManagerAdapter(RuleManager):

    adapts(IServiceManager)

    def __init__(self, context):
        self.context = context


class MessageManagerAdapter(MessageManager):

    adapts(IServiceManager)

    def __init__(self, context):
        self.context = context

    def addMessage(self, messageName, text, **kw):
        super(MessageManagerAdapter, self).addMessage(messageName, text, **kw)
        self.context.messages = self.messages

    @Lazy
    def messages(self):
        return self.context.messages


def getCheckoutRule(sender):
    """ A rule for sending a confirmation message, provided by default.
    """
    checkoutRule = Rule('checkout')
    checkoutRule.events.append(eventTypes['service.checkout'])
    #checkoutRule.actions.append(Action('message',
    #                  parameters=dict(messageName='feedback_text')))
    checkoutRule.actions.append(Action('sendmail',
                      parameters=dict(sender=sender,
                                      messageName='feedback_text')))
    checkoutRule.actions.append(Action('redirect',
                      parameters=dict(viewName='message_view.html',
                                      messageName='feedback_html')))
    return checkoutRule


# Zope event handlers

def clientRemoved(obj, event):
    """ Handle removal of a client object.
    """
    regs = IClientRegistrations(obj)
    for r in regs.getRegistrations():
        r.service.unregister(obj)

def serviceRemoved(obj, event):
    """ Handle removal of a service.
    """
    for r in obj.registrations.values():
        regs = IClientRegistrations(r.client)
        regs.unregister([obj])