FolksDummyFullPersona

FolksDummyFullPersona — A persona subclass representing a single ‘full’ contact.

Description

This mocks up a ‘full’ persona which implements all the available property interfaces provided by libfolks. This is in contrast with FolksDummyPersona, which provides a base class implementing none of libfolks’ interfaces.

The full dummy persona can be used to simulate a persona from most libfolks backends, if writing a custom FolksDummyPersona subclass is not an option.

There are two sides to this class’ interface: the normal methods required by the libfolks ‘details’ interfaces, such as folks_gender_details_change_gender(), and the backend methods which should be called by test driver code to simulate changes in the backing store providing this persona, such as folks_dummy_full_persona_update_gender(). For example, test driver code should call folks_dummy_full_persona_update_nickname() to simulate the user editing a contact’s nickname in an online address book which is being exposed to libfolks. The update_, register_ and unregister_ prefixes are commonly used for backend methods.

The API in FolksDummy is unstable and may change wildly. It is designed mostly for use by libfolks unit tests.

Functions