EDataServer.SourceCollection

g EDataServer.SourceBackend EDataServer.SourceBackend EDataServer.SourceCollection EDataServer.SourceCollection EDataServer.SourceBackend->EDataServer.SourceCollection EDataServer.SourceExtension EDataServer.SourceExtension EDataServer.SourceExtension->EDataServer.SourceBackend GObject.Object GObject.Object GObject.Object->EDataServer.SourceExtension

Subclasses:

None

Methods

Inherited:

EDataServer.SourceBackend (3), EDataServer.SourceExtension (4), GObject.Object (37)

Structs:

GObject.ObjectClass (5)

dup_calendar_url ()

dup_contacts_url ()

dup_identity ()

get_allow_sources_rename ()

get_calendar_enabled ()

get_calendar_url ()

get_contacts_enabled ()

get_contacts_url ()

get_identity ()

get_mail_enabled ()

set_allow_sources_rename (allow_sources_rename)

set_calendar_enabled (calendar_enabled)

set_calendar_url (calendar_url)

set_contacts_enabled (contacts_enabled)

set_contacts_url (contacts_url)

set_identity (identity)

set_mail_enabled (mail_enabled)

Virtual Methods

Inherited:

GObject.Object (7)

Properties

Inherited:

EDataServer.SourceBackend (1), EDataServer.SourceExtension (1)

Name

Type

Flags

Short Description

allow-sources-rename

bool

r/w/c/en

Set to True when the collection source allows user rename the child sources

calendar-enabled

bool

r/w/c/en

Whether calendar resources are enabled

calendar-url

str

r/w/c/en

Calendar top URL

contacts-enabled

bool

r/w/c/en

Whether contact resources are enabled

contacts-url

str

r/w/c/en

Contacts top URL

identity

str

r/w/c/en

Uniquely identifies the account at the service provider

mail-enabled

bool

r/w/c/en

Whether mail resources are enabled

Signals

Inherited:

GObject.Object (1)

Fields

Inherited:

GObject.Object (1)

Name

Type

Access

Description

parent

EDataServer.SourceBackend

r

Class Details

class EDataServer.SourceCollection(**kwargs)
Bases:

EDataServer.SourceBackend

Abstract:

No

Structure:

EDataServer.SourceCollectionClass

Contains only private data that should be read and manipulated using the functions below.

New in version 3.6.

dup_calendar_url()
Returns:

a newly-allocated copy of EDataServer.SourceCollection :calendar-url

Return type:

str or None

Thread-safe variation of EDataServer.SourceCollection.get_calendar_url(). Use this function when accessing self from multiple threads.

The returned string should be freed with GLib.free() when no longer needed.

New in version 3.26.

dup_contacts_url()
Returns:

a newly-allocated copy of EDataServer.SourceCollection :contacts-url

Return type:

str or None

Thread-safe variation of EDataServer.SourceCollection.get_contacts_url(). Use this function when accessing self from multiple threads.

The returned string should be freed with GLib.free() when no longer needed.

New in version 3.26.

dup_identity()
Returns:

a newly-allocated copy of EDataServer.SourceCollection :identity

Return type:

str or None

Thread-safe variation of EDataServer.SourceCollection.get_identity(). Use this function when accessing self from multiple threads.

The returned string should be freed with GLib.free() when no longer needed.

New in version 3.6.

get_allow_sources_rename()
Returns:

whether the collection backend allows a user to rename child sources

Return type:

bool

Returns whether the collection backend allows a user to rename child sources. It is meant mainly for GUI. The default is False.

New in version 3.36.

get_calendar_enabled()
Returns:

whether calendar sources should be enabled

Return type:

bool

Returns whether calendar sources within the collection should be enabled.

An #ECollectionBackend running within the registry D-Bus service will automatically synchronize any calendar sources it maintains with the EDataServer.SourceCollection :calendar-enabled property.

New in version 3.6.

get_calendar_url()
Returns:

the calendar top URL, or None

Return type:

str or None

Returns the calendar top URL string, that is, where to search for calendar sources.

New in version 3.26.

get_contacts_enabled()
Returns:

whether address book sources should be enabled

Return type:

bool

Returns whether address book sources within the collection should be enabled.

An #ECollectionBackend running within the registry D-Bus service will automatically synchronize any address book sources it maintains with the EDataServer.SourceCollection :contacts-enabled property.

New in version 3.6.

get_contacts_url()
Returns:

the contacts top URL, or None

Return type:

str or None

Returns the contacts top URL string, that is, where to search for contact sources.

New in version 3.26.

get_identity()
Returns:

the collection identity

Return type:

str or None

Returns the string used to uniquely identify the user account at the service provider. Often this is an email address or user name.

New in version 3.6.

get_mail_enabled()
Returns:

whether mail sources should be enabled

Return type:

bool

Returns whether mail sources within the collection should be enabled.

An #ECollectionBackend running within the registry D-Bus service will automatically synchronize any mail sources it maintains with the EDataServer.SourceCollection :mail-enabled property.

New in version 3.6.

set_allow_sources_rename(allow_sources_rename)
Parameters:

allow_sources_rename (bool) – whether mail sources should be enabled

Sets whether the collection backend allows a user to rename child sources. It is meant mainly for GUI. The default is False.

New in version 3.36.

set_calendar_enabled(calendar_enabled)
Parameters:

calendar_enabled (bool) – whether calendar sources should be enabled

Sets whether calendar sources within the collection should be enabled.

An #ECollectionBackend running within the registry D-Bus service will automatically synchronize any calendar sources it maintains with the EDataServer.SourceCollection :calendar-enabled property.

Calling this function from a registry service client has no effect until the change is submitted to the registry service through EDataServer.Source.write(), but there should rarely be any need for clients to call this.

New in version 3.6.

set_calendar_url(calendar_url)
Parameters:

calendar_url (str or None) – calendar top URL, or None

Sets the calendar top URL, that is, where to search for calendar sources.

The internal copy of calendar_url is automatically stripped of leading and trailing whitespace. If the resulting string is empty, None is set instead.

New in version 3.26.

set_contacts_enabled(contacts_enabled)
Parameters:

contacts_enabled (bool) – whether address book sources should be enabled

Sets whether address book sources within the collection should be enabled.

An #ECollectionBackend running within the registry D-Bus service will automatically synchronize any address book sources it maintains with the EDataServer.SourceCollection :contacts-enabled property.

Calling this function from a registry service client has no effect until the change is submitted to the registry service through EDataServer.Source.write(), but there should rarely be any need for clients to call this.

New in version 3.6.

set_contacts_url(contacts_url)
Parameters:

contacts_url (str or None) – contacts top URL, or None

Sets the contacts top URL, that is, where to search for contact sources.

The internal copy of contacts_url is automatically stripped of leading and trailing whitespace. If the resulting string is empty, None is set instead.

New in version 3.26.

set_identity(identity)
Parameters:

identity (str or None) – the collection identity, or None

Sets the string used to uniquely identify the user account at the service provider. Often this is an email address or user name.

The internal copy of identity is automatically stripped of leading and trailing whitespace. If the resulting string is empty, None is set instead.

New in version 3.6.

set_mail_enabled(mail_enabled)
Parameters:

mail_enabled (bool) – whether mail sources should be enabled

Sets whether mail sources within the collection should be enabled.

An #ECollectionBackend running within the registry D-Bus service will automatically synchronize any mail sources it maintains with the EDataServer.SourceCollection :mail-enabled property.

Calling this function from a registry service client has no effect until the changes is submitted to the registry service through EDataServer.Source.write(), but there should rarely be any need for clients to call this.

New in version 3.6.

Property Details

EDataServer.SourceCollection.props.allow_sources_rename
Name:

allow-sources-rename

Type:

bool

Default Value:

False

Flags:

READABLE, WRITABLE, CONSTRUCT, EXPLICIT_NOTIFY

Set to True when the collection source allows user rename the child sources

EDataServer.SourceCollection.props.calendar_enabled
Name:

calendar-enabled

Type:

bool

Default Value:

True

Flags:

READABLE, WRITABLE, CONSTRUCT, EXPLICIT_NOTIFY

Whether calendar resources are enabled

EDataServer.SourceCollection.props.calendar_url
Name:

calendar-url

Type:

str

Default Value:

None

Flags:

READABLE, WRITABLE, CONSTRUCT, EXPLICIT_NOTIFY

Calendar top URL

EDataServer.SourceCollection.props.contacts_enabled
Name:

contacts-enabled

Type:

bool

Default Value:

True

Flags:

READABLE, WRITABLE, CONSTRUCT, EXPLICIT_NOTIFY

Whether contact resources are enabled

EDataServer.SourceCollection.props.contacts_url
Name:

contacts-url

Type:

str

Default Value:

None

Flags:

READABLE, WRITABLE, CONSTRUCT, EXPLICIT_NOTIFY

Contacts top URL

EDataServer.SourceCollection.props.identity
Name:

identity

Type:

str

Default Value:

None

Flags:

READABLE, WRITABLE, CONSTRUCT, EXPLICIT_NOTIFY

Uniquely identifies the account at the service provider

EDataServer.SourceCollection.props.mail_enabled
Name:

mail-enabled

Type:

bool

Default Value:

True

Flags:

READABLE, WRITABLE, CONSTRUCT, EXPLICIT_NOTIFY

Whether mail resources are enabled