def __init__(self, sharing, callback, errback, scenario,
account, network, state, old_membership, new_membership):
"""Updates contact memberships.
@type scenario: L{Scenario<pymsn.service.AddressBook.scenario.base.Scenario>}
@type network: L{NetworkID<pymsn.profile.NetworkID>}
@type old_memberships: bitmask of L{Membership<pymsn.profile.Membership>}
@type new_memberships: bitmask of L{Membership<pymsn.profile.Membership>}
"""
BaseScenario.__init__(self, scenario, callback, errback)
self.__sharing = sharing
self.account = account
self.contact_type = UpdateMembershipsScenario.__contact_type[network]
self.old = old_membership
self.new = new_membership
self.state = state
# We keep a trace of what changes are actually done to pass it through
# the callback or the errback so that the executor of the scenario can
# update the memberships property of the contact.
self.__done = old_membership
# Subscription to the REVERSE or ALLOW lists can only occur when the
# contact is member of the PENDING list, so when a subscription to the
# REVERSE or ALLOW membership is detected, we delay the eventual deletion
# from the PENDING membership list.
self.__late_pending_delete = False
def __init__(self, sharing, callback, errback):
"""Checks the pending invitations.
@param sharing: the membership service
@param callback: tuple(callable, *args)
@param errback: tuple(callable, *args)
"""
BaseScenario.__init__(self, Scenario.MESSENGER_PENDING_LIST, callback, errback)
self.__sharing = sharing
def __init__(self, ab, callback, errback, group_guid=''):
"""Deletes a group from the address book.
@param ab: the address book service
@param callback: tuple(callable, *args)
@param errback: tuple(callable, *args)
@param group_guid: the guid of the group to delete"""
BaseScenario.__init__(self, 'GroupSave', callback, errback)
self.__ab = ab
self.group_guid = group_guid
def __init__(self, ab, callback, errback, contact_guid=''):
"""Deletes a contact from the address book.
@param ab: the address book service
@param callback: tuple(callable, *args)
@param errback: tuple(callable, *args)
@param contact_guid: the guid of the contact to delete"""
BaseScenario.__init__(self, Scenario.TIMER, callback, errback)
self.__ab = ab
self.contact_guid = contact_guid
def __init__(self, ab, callback, errback, email_address="", contact_info={}):
"""Adds a mail contact and updates the address book.
@param ab: the adress book service
@param callback: tuple(callable, *args)
@param errback: tuple(callable, *args)"""
BaseScenario.__init__(self, Scenario.CONTACT_SAVE, callback, errback)
self.__ab = ab
self.__email_address = email_address
self.__contact_info = contact_info
def __init__(self, ab, callback, errback, group_name=''):
"""Adds a group to the address book.
@param ab: the address book service
@param callback: tuple(callable, *args)
@param errback: tuple(callable, *args)
@param group_name: the name of the new group"""
BaseScenario.__init__(self, 'GroupSave', callback, errback)
self.__ab = ab
self.group_name = group_name
def __init__(self, ab, callback, errback,
phone_number="", contact_info={}):
"""Adds a mobile contact and updates the address book.
@param ab: the adress book service
@param callback: tuple(callable, *args)
@param errback: tuple(callable, *args)"""
BaseScenario.__init__(self, Scenario.MOBILE_CONTACT_MSGR_API, callback, errback)
self.__ab = ab
self.__phone_number = phone_number
self.__contact_info = contact_info
def __init__(self, ab, callback, errback, group_guid='', group_name=''):
"""Renames a group to the address book.
@param ab: the address book service
@param callback: tuple(callable, *args)
@param errback: tuple(callable, *args)
@param group_guid: the guid of the group to rename
@param group_name: the new name for the group"""
BaseScenario.__init__(self, 'GroupSave', callback, errback)
self.__ab = ab
self.group_guid = group_guid
self.group_name = group_name
def __init__(self, ab, callback, errback, group_guid='', contact_guid=''):
"""Adds a contact to a group.
@param ab: the address book service
@param callback: tuple(callable, *args)
@param errback: tuple(callable, *args)
@param group_guid: the guid of the group
@param contact_guid: the guid of the contact to add to the group"""
BaseScenario.__init__(self, 'GroupSave', callback, errback)
self.__ab = ab
self.group_guid = group_guid
self.contact_guid = contact_guid
def __init__(self, ab, callback, errback, contact_guid='',
contact_properties={}):
"""Updates a contact properties
@param ab: the address book service
@param callback: tuple(callable, *args)
@param errback: tuple(callable, *args)
@param contact_guid: the guid of the contact to update"""
BaseScenario.__init__(self, Scenario.CONTACT_SAVE, callback, errback)
self.__ab = ab
self.contact_guid = contact_guid
self.contact_properties = contact_properties
self.enable_allow_list_management = False
def __init__(self, sharing, callback, errback, account='',
network=NetworkID.MSN, membership=Membership.NONE,
state='Accepted'):
"""Unblocks a contact.
@param sharing: the membership service
@param callback: tuple(callable, *args)
@param errback: tuple(callable, *args)
"""
BaseScenario.__init__(self, Scenario.BLOCK_UNBLOCK, callback, errback)
self.__sharing = sharing
self.account = account
self.network = network
self.membership = membership
self.state = state
def __init__(self, address_book, membership, callback, errback, account=''):
"""Synchronizes the membership content when logging in.
@param membership: the address book service
@param callback: tuple(callable, *args)
@param errback: tuple(callable, *args)
"""
BaseScenario.__init__(self, 'Initial', callback, errback)
self.__membership = membership
self.__address_book = address_book
self.__membership_response = None
self.__ab_response = None
# FIXME : get the real account for 'Me'
self.__account = account
def __init__(self, sharing, callback, errback, account='',
network=NetworkID.MSN, memberships=Membership.NONE,
state='Accepted', block=True):
"""Declines an invitation.
@param sharing: the membership service
@param callback: tuple(callable, *args)
@param errback: tuple(callable, *args)
"""
BaseScenario.__init__(self, Scenario.TIMER, callback, errback)
self.__sharing = sharing
self.account = account
self.network = network
self.memberships = memberships
self.state = state
self.block = block
def __init__(self, ab, callback, errback, account='',
network_id=NetworkID.EXTERNAL, contact_info={},
invite_display_name='', invite_message=''):
"""Adds an external messenger contact and updates the address book.
@param ab: the address book service
@param callback: tuple(callable, *args)
@param errback: tuple(callable, *args)"""
BaseScenario.__init__(self, Scenario.CONTACT_MSGR_API, callback, errback)
self._ab = ab
self.account = account
self.network_id = network_id
self.contact_info = contact_info
self.invite_display_name = invite_display_name
self.invite_message = invite_message
def __init__(self, ab, sharing, callback, errback,
account='',
memberships=Membership.NONE,
network=NetworkID.MSN,
state='Accepted'):
"""Accepts an invitation.
@param ab: the address book service
@param sharing: the membership service
@param callback: tuple(callable, *args)
@param errback: tuple(callable, *args)
"""
BaseScenario.__init__(self, Scenario.CONTACT_MSGR_API, callback, errback)
self.__ab = ab
self.__sharing = sharing
self.add_to_contact_list = True
self.account = account
self.memberships = memberships
self.network = network
self.state = state
def __init__(self, ab, callback, errback,
account='',
contact_type=ContactType.REGULAR,
contact_info={},
invite_display_name='',
invite_message=''):
"""Adds a messenger contact and updates the address book.
@param ab: the address book service
@param callback: tuple(callable, *args)
@param errback: tuple(callable, *args)"""
BaseScenario.__init__(self, Scenario.CONTACT_SAVE, callback, errback)
self._ab = ab
self.account = account
self.contact_type = contact_type
self.contact_info = contact_info
self.invite_display_name = invite_display_name
self.invite_message = invite_message
self.auto_manage_allow_list = True