Package conduit :: Package modules :: Module SynceModule :: Class SynceTwoWay
[hide private]

Class SynceTwoWay

source code


Instance Methods [hide private]
 
__init__(self, *args)
All sync functionality should be provided by derived classes
source code
 
refresh(self)
Performs any (conduit.logging in, etc) which must be undertaken on the dataprovider prior to calling get_all().
source code
 
get_all(self)
Returns an array of all the LUIDs this dataprovider holds.
source code
conduit.DataType.DataType
get(self, LUID)
Returns data with the specified LUID.
source code
 
put(self, obj, overwrite, LUID=None)
Stores data.
source code
 
_commit(self, uid, chgtype, blob) source code
 
add(self, obj)
Adds an item to the datasource according to LUID.
source code
 
update(self, LUID, obj) source code
 
delete(self, LUID)
Deletes data with LUID.
source code
 
finish(self, aborted, error, conflict)
Perform any post-sync cleanup.
source code
 
_blob_to_data(self, uid, blob) source code
 
_data_to_blob(self, data) source code
string
get_UID(self)
Returns a UID that represents this dataproviders (locally) unique state and configuration.
source code

Inherited from dataproviders.DataProvider.DataSource: get_changes, get_num_items

Inherited from dataproviders.DataProvider.DataProviderBase: configure, emit, emit_change_detected, get_configuration, get_configuration_xml, get_input_conversion_args, get_input_type, get_name, get_output_conversion_args, get_output_type, get_status, initialize, is_busy, is_configured, set_configuration, set_configuration_xml, set_status, uninitialize

Class Variables [hide private]

Inherited from dataproviders.DataProvider.DataProviderBase: __gsignals__, _category_, _configurable_, _description_, _icon_, _in_type_, _module_type_, _name_, _out_type_

Method Details [hide private]

__init__(self, *args)
(Constructor)

source code 
All sync functionality should be provided by derived classes
Overrides: dataproviders.DataProvider.TwoWay.__init__

refresh(self)

source code 

Performs any (conduit.logging in, etc) which must be undertaken on the dataprovider prior to calling get_all(). Should gather all information so a subsequent call to get_all() can return the uids of all the data this dataprovider holds

This function may be called multiple times so derived classes should be aware of this.

Derived classes should call this function to ensure the dataprovider status is updated.
Overrides: dataproviders.DataProvider.DataProviderBase.refresh
(inherited documentation)

get_all(self)

source code 
Returns an array of all the LUIDs this dataprovider holds.
Overrides: dataproviders.DataProvider.DataSource.get_all
(inherited documentation)

get(self, LUID)

source code 

Returns data with the specified LUID. This function must be overridden by the appropriate dataprovider.

Derived classes should call this function to ensure the dataprovider status is updated.
Returns: conduit.DataType.DataType
An item of data
Overrides: dataproviders.DataProvider.DataSource.get
(inherited documentation)

put(self, obj, overwrite, LUID=None)

source code 

Stores data. The derived class is responsible for checking if putData conflicts.

In the case of a two-way datasource, the derived type should consider the overwrite parameter, which if True, should allow the dp to replace a datatype instance if one is found at the existing location

Derived classes should call this function to ensure the dataprovider status is updated.
Overrides: dataproviders.DataProvider.DataSink.put
(inherited documentation)

add(self, obj)

source code 
Adds an item to the datasource according to LUID. This method is used by the DBus interface
Returns:
True if the data was successfully added
Overrides: dataproviders.DataProvider.DataSource.add
(inherited documentation)

delete(self, LUID)

source code 
Deletes data with LUID.
Overrides: dataproviders.DataProvider.DataSink.delete
(inherited documentation)

finish(self, aborted, error, conflict)

source code 
Perform any post-sync cleanup. For example, free any structures created in refresh that were used in the synchronization.
Overrides: dataproviders.DataProvider.DataProviderBase.finish
(inherited documentation)

get_UID(self)

source code 

Returns a UID that represents this dataproviders (locally) unique state and configuration. For example the LUID for a gmail dp may be your username and password.

Derived types MUST overwride this function
Returns: string
Overrides: dataproviders.DataProvider.DataProviderBase.get_UID
(inherited documentation)