movement_collection_diff.py 2.66 KB
Newer Older
Jean-Paul Smets's avatar
Jean-Paul Smets committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48
# -*- coding: utf-8 -*-
##############################################################################
#
# Copyright (c) 2009 Nexedi SA and Contributors. All Rights Reserved.
#                    Jean-Paul Smets-Solanes <jp@nexedi.com>
#
# WARNING: This program as such is intended to be used by professional
# programmers who take the whole responsibility of assessing all potential
# consequences resulting from its eventual inadequacies and bugs
# End users who are looking for a ready-to-use solution with commercial
# guarantees and support are strongly advised to contract a Free Software
# Service Company
#
# 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.
#
##############################################################################
"""
"""

from zope.interface import Interface

class IMovementCollectionDiff(Interface):
  """Movement Collection Diff interface specification
  
  Documents which implement IMovementCollectionDiff 
  are used to represent the movements which should be
  added, updated or deleted in an IMovementCollection.
  They are usually generated and used by 
  IMovementCollectionUpdater.
  """
  def getDeletableMovementList():
    """
    Returns the list of movements which need 
    to be deleted.
    """

49 50 51 52 53
  def addDeletableMovement(movement):
    """
    Add a deletable movement to the diff definition
    """

Jean-Paul Smets's avatar
Jean-Paul Smets committed
54 55 56 57 58 59
  def getNewMovementList():
    """
    Returns a list temp movements which represent new
    movements to add to an existing IMovementCollection.
    """

60 61 62 63 64
  def addNewMovement(movement):
    """
    Add a new movement to the diff definition
    """

Jean-Paul Smets's avatar
Jean-Paul Smets committed
65 66 67 68 69 70 71 72 73
  def getUpdatableMovementList():
    """
    Returns the list of movements which need 
    to be updated.
    """

  def getMovementPropertyDict(movement):
    """
    Returns a dict of all properties and values
Jean-Paul Smets's avatar
Jean-Paul Smets committed
74 75
    to update an existing movement or to 
    create a new movement.
Jean-Paul Smets's avatar
Jean-Paul Smets committed
76
    """
77 78 79 80 81 82 83

  def addUpdatableMovement(movement, property_dict):
    """
    Add an updatable movement to the diff definition

    property_dict -- properties to update     
    """